Skip to main content

REST Services with ASP.NET Web API

Sometimes back, ASP.NET MVC 4 beta was release, this comes with quite a lot of capabilities to create mobile web applications with HTML5, to new features on Razor etc..
One of the milestones of this release is ASP.NET Web APIs, which allows developers to implement REST services. .NET 3.5/4.0 WCF provides us with the support of creating REST APIs using the webHttpBinding, however most of the features required to run the service needs the ASP.NET compatibility mode, this basically means the request to the REST service would first go through the ASP.NET pipeline, before being handed over to WCF. Then there was the WCF Web API, where Microsoft tried to re-define how REST services are created, but they opted in for moving REST support into ASP.NET and then to WCF, hence ASP.NET Web API, becomes the de facto technology for creating REST services. WCF WebHttpBinding would still exist, bu the recommendation is to to use Web APIs.

Implementing a Web API is simple, the steps involved are...
1) Create a MVC 4 project
2) Define a route for web APIs
2) Create a controller but that inherits from ApiController instead of Controller
4) Start writing those GET, POST, PUT and DELETE methods....

Once you have installed ASP.Net MVC 4, you can create a controller like this...

public class ProjectsController : ApiController

{

public IList GetProjects()

{

return GetProjectsFromDB();

}

public void PostProject(Project project)

{

SaveProjectIntoDB(project);

}

}


in your global file, you can create a route setting like this...

routes.MapHttpRoute(

name: "DefaultApi",

routeTemplate: "api/{controller}/{id}",

defaults: new { id = RouteParameter.Optional }

);

That's it you can open up a web browser or fiddler and make request, to call the method GetProjects(), you URL would be like this http://localhost:8080/api/Product. In fiddler you would see the JSON response similar to this....

{"EndDate":"\/Date(1333251468665+0530)\/","ProjectID":1,"ProjectName":"XYZ 12","ProjectType":"T&M","StartDate":"\/Date(1333251468665+0530)\/"},{"EndDate":"\/Date(1333251468665+0530)\/","ProjectID":2,"ProjectName":"JJ 777","ProjectType":"FB","StartDate":"\/Date(1333251468665+0530)\/"}

Now, if you know MVC, you would be asking me, you did not refer the action in the URL or in the route table, so how does asp.net know to invoke the GetProducts()?. The answer is the controller check to see the HTTP method the request arrived on, if it is a GET, the controller will try to match any controller method that starts with the word GET. This is the same convention for POST. For an example , the PostProject() method can be invoked by a call to the URL format http://localhost:8080/api/Product. As long as you make the request as a POST method, the PostProject() method will be called. This convention allows the concept of a resource being governed by one controller by the HTTP verbs GET, POST, DELETE and PUT.

With the default convention discussed above, if you want to have method that does not start with the word Get or multiple methods with the same signature starting with the word GET, you would have to specify a route for this and explicitly specify the action part in the URL. You would also need to attribute the methods with either HttpGet, HttpPost etc...

[HttpGet]

public IList<Project> ActiveProjects()

{

return GetProjectsFromDB(true);

}

Your route settings in the global file would be...

routes.MapHttpRoute(

name: "DefaultApiWithAction",

routeTemplate: "api/{controller}/{action}/{id}",

defaults: new { id = RouteParameter.Optional }


The URL format you would use to invoke this method would be

http://localhost:51499/api/projects/activeprojects

Unlike WCF REST service where you need to attribute your method to return the result in a specific format (WebMessageFormat), Web APIs allow the client to specify the format they accept, and Web API will format it accordingly. This is achieved by the client specifying the format in the Accept header in the HTTP request. For an example, if you want the data returned as XML, you would set the Accept header in Fiddler like this Accept : application/xml.

Another cool thing about Web APis, is that it allows OData like syntax to query the API it self for an example, if I want to get only the top 2 projects...my URL would be like this

http://localhost:51499/api/projects/activeprojects?$top=2

However, this to work, you need change your return type IQueryable like this...

public IQueryable<Project> ActiveProjects()

{

return GetProjectsFromDB(true).AsQueryable();

}

The URL format for your return the top 2 projects ordering it by ProjectType would be like this..

http://localhost:51499/api/projects/activeprojects?$top=2&$orderby=ProjectType

Web APIs can be self hosted in a console application and also be written in ASP.net web forms

Thats all i have time for today...

Comments

  1. Thank you for this post nairooz, i've been following your posts for years and they are very helpful.

    One question i've have is, what is the best way to pass a complex object as a parameter for a Get method?

    I know for a POST object i can have a JSON or XML serialized object in the request body. Is there a similar way i can do this for Get?

    The only 2 options i'm stuck with right now are:
    1. Use about 10 primitive type parameters in the method signature and build my complex object using these params.

    2. Go out of the 'REST' norm and use POST method for all methods, including the GetXXXX()s.

    ReplyDelete

Post a Comment

Popular posts from this blog

The maximum nametable character count quota (16384) has been exceeded

Some of our services were growing and the other day it hit the quote, I could not update the service references, nor was I able to run the WCFTest client. An error is diplayed saying " The maximum nametable character count quota (16384) has been exceeded " The problem was with the mex endpoint, where the XML that was sent was too much for the client to handle, this can be fixed by do the following. Just paste the lines below within the configuration section of the devenve.exe.config and the svcutil.exe.config files found at the locations C:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE , C:\Program Files\Microsoft SDKs\Windows\v6.0A\bin Restart IIS and you are done. The detailed error that you get is the following : Error: Cannot obtain Metadata from net.tcp://localhost:8731/ Services/SecurityManager/mex If this is a Windows (R) Communication Foundation service to which you have access, please check that you have enabled metadata publishing at the specified address. F

Hosting WCF services on IIS or Windows Services?

There came one of those questions from the client whether to use II7 hosting or windows service hosting for WCF services. I tried recollecting a few points and thought of writing it down. WCF applications can be hosted in 2 main ways - In a Windows service - On IIS 7 and above When WCF was first released, IIS 6 did not support hosting WCF applications that support Non-HTTP communication like Net.TCP or Net.MSMQ and developers had to rely on hosting these services on Windows Services. With the release of IIS 7, it was possible to deploy these Non-Http based applications also on IIS 7. Following are the benefits of using IIS 7 to host WCF applications Less development effort Hosting on Windows service, mandates the creating of a Windows service installer project on windows service and writing code to instantiate the service, whereas the service could just be hosted on IIS by creating an application on IIS, no further development is needed, just the service implementa

ASP.NEt 2.0 Viewstate and good practices

View state is one of the most important features of ASP.NET because it enables stateful programming over a stateless protocol such as HTTP. Used without strict criteria, though, the view state can easily become a burden for pages. Since view state is packed with the page, it increases size of HTTP response and request. Fortunately the overall size of the __VIEWSTATE hidden field (in ASP.NET 2.0) in most cases is as small as half the size of the corresponding field in ASP.NET 1.x. The content of the _VIEWSTATE field (in client side) represent the state of the page when it was last processed on the server. Although sent to the client, the view state doesn't contain any information that should be consumed by the client. In ASP.NET 1.x, if you disable view state of controls, some of them are unable to raise events hence control become unusable. When we bind data to a grid, server encodes and put whole grid in to view state, which will increase size of view state (proportional to the