Skip to main content

RESTful Example

Here is an example on how you would create a RESTful webservice with the WCF Web programming model. I assume that you know how to write a WCF service and host it in IIS.
In this example I am going to create a service that will say "Hello" plus a string that is passed into the service, further more the service is going to be hosted in IIS.
the following is a WCF service class,
[ServiceContract]

public interface ITest
{
[OperationContract]
[WebGet(UriTemplate="/SayHello/{str}",ResponseFormat= ebMessageFormat.Xml)]
string SayHello(string str);
}
public class TestImpl : ITest

{
public string SayHello(string str) { return "Hello " + str; }
}

SayHello is our service operation. Note that this is a general WCF service with addittion of a [WebGet] attribute on top of our service operation. by using the [WebGet] attribute we mean that the operation is to be invoked with the HTTP GET verb.The next step is to define our .svc file for our service, the content of the .svc file would look like this.
< @ ServiceHost language=c# Debug="true" Service="RestService.TestImpl" Factory="System.ServiceModel.Activation.WebServiceHostFactory" % >

Again this a general .svc file with the exception of having a WebServiceHostFactory specifed as a factory class to create the appopriate webHttpbinding endpoint.
Now all we have to do is host the service in IIS. The binding used to create RESTfull services, the webHttpbinding does not support multiple authentication, therefor make sure to select only one type of authentication for the directory security in IIS.
We are done...you can access you service like this (assuming that your IIS is running local):
http://localhost/RestService/RstSvc.svc/SayHello/ Iron Man
your response would look something like this...

<string xmlns="http://schemas.microsoft.com/2003/10/Serialization/%22>Hello Iron Man</string >
If you notice carefully, you would see that the way we sent the request is mapped to our [WebGet] attribute's UriTemplate : [WebGet(UriTemplate="/SayHello/{str})]" where {str} is a place holder for the parameter of the operation. You would also see that the response format is set to xml. ResponseFormat= WebMessageFormat.Xml, so the response will be sent to us in xml.


Comments

Popular posts from this blog

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

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

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