.NET Tutorials, Forums, Interview Questions And Answers
Welcome :Guest
 
Sign In
Register
 
Win Surprise Gifts!!!
Congratulations!!!


Top 5 Contributors of the Month
satyapriyanayak
Subhransu Sekhar Jena
abhays
SP
DotnetUser

Home >> Articles >> WCF >> Post New Resource Bookmark and Share   

 Subscribe to Articles

Step by Step tutorial of REST Enabled Service in WCF

Posted By:Dhananjay Kumar       Posted Date: January 10, 2010    Points: 25    Category: WCF    URL: http://www.dhananjaykumar.net  

Step by Step tutorial of REST Enabled Service in WCF. This tutiorial will explain how to create and consume a basic REST Enabled service in WCF. This is very basic tutorial but it will be very helpful in debugging common error while creating REST Services.
 

Objective:

This article will explain step to step explanation of, how to create a REST based service and how to consume that in a client. Although, this is a very simple service taken as an example, but it will really help in creating complex REST Services.

This article will help in understanding scene behind ASTORIA also.

Step 1:

Create a new project as WCF Service application type.

WCFService1.gif

Step 2:

Rename IService.cs to IRestService.cs and Service1.cs to RestService.cs. And delete all the existing code from there.

Step 3:

Open Web.Config file and delete below highlighted code. In other words delete all default bindings and endpoints for existing service model. Delete existing <system.serviceModel>

  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  
  

Step 4:

Right click on RestService.cs and open View markup.

WCFService2.gif

In Markup of RestService.cs , add below code there

Factory="System.ServiceModel.Activation.WebServiceHostFactory"
So after adding code the markup would look like

Markup of RestService.cs

<%@ ServiceHost Language="C#" Debug="true" 
Service="RestServicePublishing.RestService" 
CodeBehind="RestService.svc.cs" 
Factory="System.ServiceModel.Activation.WebServiceHostFactory"%>


Step 5:

Writing Service.

Add following references to the service project.

Microsoft.Http.dll
Microsoft.Http.Extension.dll
System.ServiceModel.Web.dll 

Note : These dll can be download from Microsoft site else it could be downloaded from the attached Zip file.

Step 6:

Add a new project as of type class library and give it name UtilityClasses. Rename Class1.cs to Number.cs .

WCFService3.gif

Type the below code in Number.Cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

namespace Utilityclasses
{
  [Serializable]
  public class NumberService
  {
  public int Number1 { get; set; }
  public int Number2 { get; set; }
  }
}


Step 7:

Add Namespaces to IRestService.cs

using System.ServiceModel.Web;

Step 8:

Type the below code.

IRestService.cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Runtime.Serialization;
using System.ServiceModel;
using System.Text;
using System.ServiceModel.Web;
using Utilityclasses; 
namespace RestServicePublishing
{
  // NOTE: If you change the interface name "IService1" here, you must also update the reference to "IService1" in Web.config.
  [ServiceContract]
  public interface IRestService
  {
  [OperationContract(Name="AddParameter")]
  [WebInvoke(UriTemplate = "/",Method="POST")]
  int  Add(NumberService n1);
  [OperationContract(Name="Add")]
  [WebGet(UriTemplate = "/")]
  int Add() 
  }  
  }


Explanation of Code:

This code is used to construct URI for REST service.

[WebInvoke(UriTemplate = "/",Method="POST")]

Method parameter says what type of HTTP request; this URI is going to entertain. In this case it is Http POST.

UriTemplate parameter says, what would be URI for this particular method. In this case it is one back slash means; it is root URI of this service.

So, to invoke this method add (), the URI address would be

http://localhost:3602/RestService.svc/

Where 3602 is port number of web server, where this service is running.
Let, if the above code is modified as
[WebInvoke(UriTemplate = "/ADD/Mahesh",Method="POST")]

Then it would be invoked as

http://localhost:3602/RestService.svc/ADD/Mahesh
Step 9:

Implementing the Service

RestService.cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Runtime.Serialization;
using System.ServiceModel;
using System.Text;
using Utilityclasses;
namespace RestServicePublishing
{
  // NOTE: If you change the class name "Service1" here, you must also update the reference to "Service1" in Web.config and in the associated .svc file.
  public class RestService : IRestService
  {
  public int res = 100; 
  public int Add(NumberService n1)
  {
  res = Convert.ToInt32(n1.Number1) + Convert.ToInt32(n1.Number2);
  return res; 
  }
  public int Add()
  {
  return res; 
  }
  }
}


Step 10:

Testing the Service in browser.
  1. Build the Service
  2. Right click on RestService.cs and select view in browser.

    WCFService4.gif
Explanation of output:

Output 100 is returned in the browser by the service. It is because, below service method. URI of below GET method is mapped to root of the URI. And this method is returning 100. (See RestService.cs)

  [OperationContract(Name="Add")]
  [WebGet(UriTemplate = "/")]
  int Add()

on modifying URI in address bar of browser as below ,

http://localhost:3602/RestService.svc/abc

output would be , because given URI is not mapped to any method in the service.

WCFService5.gif

Step 11:

Consuming at client side.

Add new console project in solution and give it name as ConsoleTestProject.

WCFService6.gif

Add reference of project UtilityClasses Add following references to the console project.

Microsoft.Http.dll
Microsoft.Http.Extension.dll
System.ServiceModel.Web.dll


Step 12:

Paste or type below code in

Program.cs

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Configuration;
using Microsoft.Http; 
using Microsoft.ServiceModel.Web; 
using Microsoft.ServiceModel.Web.SpecializedServices; 
using System.Runtime.Serialization;
using Utilityclasses; 
namespace ConsoleTestProject
{
  class Program
  {
  static string uri;
  static void Main(string[] args)
  {
  
  uri = "http://localhost:3602/RestService.svc/";
  // Calling without parameter
  Console.WriteLine(AddWithoutParameter());
  Console.Read(); 
  //Calling with parameter
  NumberService obj = new NumberService() { Number1 = 7, Number2 = 2 };
  Console.WriteLine(AddWithParameter(obj));
  Console.Read();  
  } 
  public static string  AddWithoutParameter()
  {
  using (HttpResponseMessage response = new HttpClient().Get(uri))
  
  int res = response.Content.ReadAsDataContract();
  return res.ToString();
  }
  } 
  public static string  AddWithParameter(NumberService obj)
  {
  using (HttpResponseMessage  response = new HttpClient().Post(uri,HttpContentExtensions.CreateDataContract(obj)))
  {
  
  int res = response.Content.ReadAsDataContract();
  return res.ToString();
  } 
  }
  }
}


Explanation:

There are two static methods

AddWithoutParameter() -> To Invoke HTTP Get on Service URI. {In Green}
AddWithParameter() -> To Invoke HTTP POST on Service URI. {In Yellow}

AddWithoutParameter()

This is just creating instance of HttpResponse and calling HttpClient Get method to fetch value from the service.

AddWithParameter()

This is just creating instance of HttpResponse and calling HttpClient POST method to fetch value from the service.

Output

WCFService7.gif

Future Scope:

To consume this service in SilverLight and to use REST with Ado.NET Data Service. 

 Subscribe to Articles

     

Further Readings:

Responses
Author: Pinakin         Company URL: http://www.dotnetspark.com
Posted Date: April 15, 2010

I have Visual Web Developer Express Edition so I can not install WCF REST startup Kit. Even Three Dll i.e. Microsoft.Http.dll,Microsoft.Http.Extension.dll,System.ServiceModel.Web.dll
are not there @ my machine.
The Zip file attached here i.e. "dhananjay25_633987356671213719_RestServicePublishing.zip" is not available.

Please let me know from where to get three dll so I can start working!!!
Author: Velkumar         Company URL: http://www.dotnetspark.com
Posted Date: June 27, 2012

i have tried like :http://localhost:3602/RestService.svc/ADD/Mahesh" but i got an error like "Endpoint not found." any solution for this?
Author: Velkumar         Company URL: http://www.dotnetspark.com
Posted Date: June 27, 2012

also is there any way to pass value from URL itself?
Author: James         Company URL: http://www.savetigers.co.cc
Posted Date: July 07, 2012

Very nice Tutorial Dhananjay. I have also seen website which helpful me to do my first WCF Sevice in ASP.net http://sangmeshwar.byethost10.com/wcfbasicstutorial.php
Author: Imran Ghani         Company URL: http://www.webdevelopmenthelp.net
Posted Date: September 08, 2014

Nice one.
Dotnetspark.com also have "Free Practical Guide to WCF RESTful Service" here.
http://www.dotnetspark.com/kb/5993-practical-guide-to-wcf-restful-service.aspx

Or, you can find Step by Step implementation for all CRUD operations using WCF RESTful Service here.
http://www.topwcftutorials.net/2014/01/crud-wcf-restful-service.html

Post Comment

You must Sign In To post reply
Find More Articles on C#, ASP.Net, Vb.Net, SQL Server and more Here

Hall of Fame    Twitter   Terms of Service    Privacy Policy    Contact Us    Archives   Tell A Friend