Thursday, April 5, 2012

Hosting WCF Service on IIS7


Walkthrough on creating WCF 4.0 Service and Hosting in IIS 7.5

Objective
This article will give step by step walkthrough
1. How to create a basic WCF 4.0 Service?
2. How to host WCF Service in IIS 7.5?
3. Hot to test service in a client.
Create WCF Service
Create WCF service. Open visual studio select new project and then from WCF tab select WCF Service application to create a new WCF service.
clip_image002
Delete the default code created by WCF from IService1 and Service1.svc.cs
a. So delete the data contract
b. Modify the service contract as below. Just make one operation contract to return a string .
IService1.cs
using System;
using System.Collections.Generic;
using System.Linq;
using System.Runtime.Serialization;
using System.ServiceModel;
using System.ServiceModel.Web;
using System.Text;
namespace WcfService5
{
    [ServiceContract]
    public interface IService1
    {
        [OperationContract]
        string GetMessage();
 
    }   
}
 
Service1.svc.cs
using System;
using System.Collections.Generic;
using System.Linq;
using System.Runtime.Serialization;
using System.ServiceModel;
using System.ServiceModel.Web;
using System.Text;
 
namespace WcfService5
{
    public class Service1 : IService1
    {
        public string GetMessage()
        {
            return "Hello From WCF Service "; 
        }
    }
}
 
Leave the default configuration created by WCF.
Web.Config
<?xml version="1.0"?>
<configuration>
  <system.web>
    <compilation debug="true" targetFramework="4.0" />
  </system.web>
  <system.serviceModel>
    <behaviors>
      <serviceBehaviors>
        <behavior>         
          <serviceMetadata httpGetEnabled="true"/>         
          <serviceDebug includeExceptionDetailInFaults="false"/>
        </behavior>
      </serviceBehaviors>
    </behaviors>
    <serviceHostingEnvironment multipleSiteBindingsEnabled="true" />
  </system.serviceModel>
 <system.webServer>
    <modules runAllManagedModulesForAllRequests="true"/>
  </system.webServer
</configuration>
 
Host WCF Service in IIS 4.0
Open IIS
a. Open the command prompt in administrator mode. To do click on Start button then type RUN in search and then in Run window type inetmgr to open IIS .
clip_image003
Now you will have IIS open like below
clip_image005
b. Right click on Sites and then click Add Web Site
clip_image006
c. Now a window will open.
clip_image007
Give any name of your choice as the site name. I am giving name here HostedWcfService
clip_image008
Now click on select and choose ASP.Net v4.0 from the drop down.
clip_image009
Now in the physical path section, we need to give physical path of the service. So to get the physical path of the service, right click on the WCF Service project in visual studio and click open project in windows explorer. Open the project in windows explorer and from address bar copy the path and paste that below. Or you can browse also. Just click on browse button and navigate to project folder of the WCF Service.
clip_image010
Now at the Binding section select HTTP. Give any port number. I am selecting the port as 4567
clip_image011
Do not give any name as host name. Leave it blank
clip_image012
Check the check box Start Web Site Immediately.
clip_image013
And now click OK on the window.
d. Now open visual studio command prompt in administrator mode. Right click and select as administrator
clip_image014
clip_image015
Type the below command
aspnet_regiis.exe /iru
clip_image017
You will get the message Finished Installing ASP.Net 4.0
e. Now go to inetmgr, you would able to see the site you just created in previous step.
clip_image018
Publishing the WCF Service
Go back to WCF Service. Right click and select Publish
clip_image019
On clicking of publish a window will come.
clip_image020
Give a Service URL. You are free to give any Service URL here. Just make sure host name is geeting resolved. In stead of localhost you can give IP address or your machine name also.
clip_image021
Give the name of the site HostedWcfService. We created this site in previous step.
clip_image022
Leave the credential inactive.
clip_image023
Now click on Publish.
clip_image024
You will get the message in bottom publish succeeded
Browsing the service hosted in IIS
Open Inetmgr and right click on site HostedWcfService. Then from Manage Web Site select Browse option.
clip_image025
When you click on browse site will get open in browser
clip_image027
You will get the above error. Just in address bar append Service1.svc with the address to open the service in browser.
And in browser you will get the service up and running.
clip_image029
So now you successfully created and hosted the WCF 4.0 service in IIS 7.5
Testing the Service at client
a. Create console application project.
clip_image031
b. Right click and add the service reference.
clip_image032
c. Give in address the address of service hosted in IIS and click GO.
clip_image033
d. Call the service as below ,
Program.cs
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using ConsoleApplication1.ServiceReference1;
 
namespace ConsoleApplication1
{
    class Program
    {
        static void Main(string[] args)
        {
            Service1Client proxy = new Service1Client();
            Console.WriteLine(proxy.GetMessage());
            Console.Read();
        }
    }
}
 
Output
clip_image035
Conclusion
In this article we saw,
How to create a basic WCF 4.0 Service?
How to host WCF Service in IIS 7.5?
Hot to test service in a client.
I hope this article was useful. Thanks for reading. Happy coding.

No comments:

Post a Comment