Click here to Skip to main content
Click here to Skip to main content

.NET 2.0 REST Service

, 6 Jan 2009 CPOL
Rate this:
Please Sign up or sign in to vote.
A working implementation of a REST service in .NET 2.0.

Introduction

For a couple of days, I've been trying to find an example of a REST web service written in .NET. Not being ASTORIA yet a mature framework, I'd rather get something based on an already released product, even if this would mean that I should sacrifice features or write a little more code.

Background

There are two very interesting articles published in this site: Everything about REST Web Services - What and how - Part 2 - Design and REST Web Services in ASP.NET 2.0 (C#), but none of them showed me a proper, full .NET implementation. So, I decided to write my own.

Everything about REST Web Services - What and how - Part 2 - Design explains in detail how to format a proper REST request, how to handle the different VERBs, and what kind of information should be passed to the service in each case. I encourage you to take a look at this article since I won't discuss those concepts again.

What I will provide you is a simple implementation of these requirements based on HTTP request handlers built into the .NET 2.0 framework. There are many other ways to do this. You could try with the HTTP modules, you can go for the WCF classes, and some others. I had to make a choice, and the aim was to come up with something that most people could use.

Using the code

The Visual Studio 2008 solution will be composed of a website that will provide the data service in accordance to the REST model and also a client.

The Web Service will have a web.config file that will map the service URL requests, and a (very simple) class for each verb handler. The POST and GET verbs may be sent from any web browser, so I'll be providing you a simple .html test page for this. For PUT and DELETE, I have built a custom client.

Finally, the Contacts.xml is our data source.

Create the Web Service

The first thing you'll need to set up the Web Service is to configure IIS to properly handle the requests. A basic configuration will be to remove all inherited handlers and set up your own. To do that, you'll need to edit your web.config like this...

<configuration>
 <system.web>
  <httpHandlers>
   <clear />
   <add verb="PUT" path="*" validate="false" 
      type="RESTHandlers.PutHandler, RESTHandlers"/>
   <add verb="POST" path="*" validate="false" 
      type="RESTHandlers.PostHandler, RESTHandlers"/>
   <add verb="GET" path="*" validate="false" 
      type="RESTHandlers.GetHandler, RESTHandlers"/>
   <add verb="DELETE" path="*" validate="false" 
      type="RESTHandlers.DeleteHandler, RESTHandlers"/>
  </httpHandlers>
 </system.web>
</configuration> 

The next step is to create the handlers. This will be a basic task. Your classes should implement IHttpHandler and process the request. The basic structure should be something like this:

public void ProcessRequest(HttpContext context)
{ 
  // a) Validate the request.
  // Remember, for example, that a PUT should not contain 
  // any query strings values.
  if(context.Request.QueryString != sting.Empty)
  { 
    SendClientTheError(); 
    return;
  }
  // b) Process the request.
  ... 
  // c) Send a response.
  HttpResponse response = context.Response;
  response.Write("OK");
}

That's all for the service...

The clients

There are two clients included as an example in this solution: a webpage and a console application.

A .htm file will show some samples of the GET and POST verbs sent both from <A> and <FORM> tags.

The console application will issue sample PUT and DELETE commands.

Points of interest

Please note that I did not write an exhaustive validation for the requests, and that the examples are not a complete scenario for the service. For example, I haven't wrote code to make a DELETE with a query string to test the error message. Also, when you implement a service like this, it would be wise to add some other validations, like:

  • Validate the request URI with more detail.
  • Validate the query string parameters.
  • Validate the XML received against a schema.
  • Any other validation on the request context like user, referrer, etc...

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

carlosmsr
Architect
Argentina Argentina
No Biography provided

Comments and Discussions

 
Question500 Error [modified] PinmemberMember 823914420-Jan-13 10:04 
GeneralMy vote of 5 PinmemberDan Randolph22-Dec-11 19:26 
GeneralMy vote of 4 PinmemberRamanjaneyulu Kondaru8-Nov-11 2:15 
GeneralMy vote of 5 Pinmemberchenwei912027-Jul-11 18:29 
GeneralASP.Net Handler REST Service Pinmembergerrits14-Dec-10 23:08 
GeneralExample code missing!!! Pinmemberreviloliver29-Nov-10 10:15 
GeneralThanks for example PinmemberDorothy211-Jul-10 12:01 
QuestionHow to deploy to IIS? PinmemberAyasha Chen26-May-10 21:30 
AnswerRe: How to deploy to IIS? PinmemberMember 33785491-Apr-11 9:40 
GeneralRe: How to deploy to IIS? PinmemberAyasha Chen1-Apr-11 14:47 
AnswerRe: How to deploy to IIS 7? PinmemberDan Randolph22-Dec-11 20:01 
GeneralRe: How to deploy to IIS 7? Pinmembercarlosmsr26-Dec-11 8:02 
QuestionHow to implement this service? Pinmemberkraftspl6-Jan-09 9:24 
AnswerRe: How to implement this service? PinmemberIgor_VK7-Jan-09 4:49 
GeneralRe: How to implement this service? Pinmemberkraftspl7-Jan-09 4:58 
AnswerRe: How to implement this service? PinmemberIgor_VK7-Jan-09 6:48 
AnswerRe: How to implement this service? Pinmembercarlosmsr7-Jan-09 8:05 
GeneralRe: How to implement this service? Pinmemberrudu21-Jan-09 7:16 
GeneralRe: How to implement this service? Pinmembercarlosmsr21-Jan-09 12:29 
GeneralRe: How to implement this service? PinmemberMember 418118216-Feb-10 15:51 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web03 | 2.8.150129.1 | Last Updated 6 Jan 2009
Article Copyright 2009 by carlosmsr
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid