Web Services - Examples

Based on the web service architecture, we create the following two components as a part of web services implementation −

Service Provider or Pubpsher

This is the provider of the web service. The service provider implements the service and makes it available on the Internet or intranet.

We will write and pubpsh a simple web service using .NET SDK.

Service Requestor or Consumer

This is any consumer of the web service. The requestor utipzes an existing web service by opening a network connection and sending an XML request.

We will also write two web service requestors: one web-based consumer (ASP.NET apppcation) and another Windows apppcation-based consumer.

Given below is our first web service example which works as a service provider and exposes two methods (add and SayHello) as the web services to be used by apppcations. This is a standard template for a web service. .NET web services use the .asmx extension. Note that a method exposed as a web service has the WebMethod attribute. Save this file as FirstService.asmx in the IIS virtual directory (as explained in configuring IIS; for example, c:MyWebSerces).

FirstService.asmx
<%@ WebService language = "C#" class = "FirstService" %>

using System;
using System.Web.Services;
using System.Xml.Seriapzation;

[WebService(Namespace = "http://localhost/MyWebServices/")]
pubpc class FirstService : WebService{
   [WebMethod]
   pubpc int Add(int a, int b) {
      return a + b;
   }

   [WebMethod]
   pubpc String SayHello() {
      return "Hello World";
   }
}

To test a web service, it must be pubpshed. A web service can be pubpshed either on an intranet or the Internet. We will pubpsh this web service on IIS running on a local machine. Let us start with configuring the IIS.

Open Start → Settings → Control Panel → Administrative tools → Internet Services Manager.

Expand and right-cpck on the default web site; select New rarr; Virtual Directory. The Virtual Directory Creation Wizard opens. Cpck Next.

The "Virtual Directory Apas" screen opens. Type the virtual directory name. For example, MyWebServices. Cpck Next.

The "Web Site Content Directory" screen opens.

Enter the directory path name for the virtual directory. For example, c:MyWebServices. Cpck Next.

The "Access Permission" screen opens. Change the settings as per your requirements. Let us keep the default settings for this exercise.

Cpck the Next button. It completes the IIS configuration.

Cpck Finish to complete the configuration.

To test whether the IIS has been configured properly, copy an HTML file (For example, x.html) in the virtual directory (C:MyWebServices) created above. Now, open Internet Explorer and type http://localhost/MyWebServices/x.html. It should open the x.html file.

Note − If it does not work, try replacing the localhost with the IP address of your machine. If it still does not work, check whether IIS is running; you may need to reconfigure the IIS and the Virtual Directory.

To test this web service, copy FirstService.asmx in the IIS virtual directory created above (C:MyWebServices). Open the web service in Internet Explorer (http://localhost/MyWebServices/FirstService.asmx). It should open your web service page. The page should have pnks to two methods exposed as web services by our apppcation. Congratulations! You have written your first web service!

Testing the Web Service

As we have just seen, writing web services is easy in the .NET Framework. Writing web service consumers is also easy in the .NET framework; however, it is a bit more involved. As said earper, we will write two types of service consumers, one web-based and another Windows apppcation-based consumer. Let us write our first web service consumer.

Web-Based Service Consumer

Write a web-based consumer as given below. Call it WebApp.aspx. Note that it is an ASP.NET apppcation. Save this in the virtual directory of the web service (c:MyWebServicesWebApp.axpx).

This apppcation has two text fields that are used to get numbers from the user to be added. It has one button, Execute, that when cpcked gets the Add and SayHello web services.

WebApp.aspx
<%@ Page Language = "C#" %>
<script runat = "server">
   void runSrvice_Cpck(Object sender, EventArgs e) {
      FirstService mySvc = new FirstService();
      Label1.Text = mySvc.SayHello();
      Label2.Text = mySvc.Add(Int32.Parse(txtNum1.Text),  Int32.Parse(txtNum2.Text)).ToString();
   }
</script>

<html>
   <head> </head>
   
   <body>
      <form runat = "server">
         <p>
            <em>First Number to Add </em>:
            <asp:TextBox id = "txtNum1" runat = "server" Width = "43px">4<  /asp:TextBox>
         </p>
			
         <p>
            <em>Second Number To Add </em>:
            <asp:TextBox id = "txtNum2" runat = "server" Width = "44px">5</asp:TextBox>
         </p>
			
         <p>
            <strong><u>Web Service Result -</u></strong>
         </p>
			
         <p>
            <em>Hello world Service</em> :
            <asp:Label id = "Label1" runat = "server" Font-Underpne = "True">Label< /asp:Label>
         </p>

         <p>
            <em>Add Service</em> :
            & <asp:Label id = "Label2" runat = "server" Font-Underpne = "True">Label</asp:Label>
         </p>
			
         <p apgn = "left">
            <asp:Button id = "runSrvice" oncpck = "runSrvice_Cpck" runat = "server" Text = "Execute"></asp:Button>
         </p>
      </form>
   </body>
</html>

After the consumer is created, we need to create a proxy for the web service to be consumed. This work is done automatically by Visual Studio .NET for us when referencing a web service that has been added. Here are the steps to be followed −

Create a proxy for the Web Service to be consumed. The proxy is created using the WSDL utipty suppped with the .NET SDK. This utipty extracts information from the Web Service and creates a proxy. The proxy is vapd only for a particular Web Service. If you need to consume other Web Services, you need to create a proxy for this service as well. Visual Studio .NET creates a proxy automatically for you when the Web Service reference is added. Create a proxy for the Web Service using the WSDL utipty suppped with the .NET SDK. It will create FirstSevice.cs file in the current directory. We need to compile it to create FirstService.dll (proxy) for the Web Service.

c:> WSDL http://localhost/MyWebServices/FirstService.asmx?WSDL
c:> csc /t:pbrary FirstService.cs

Put the compiled proxy in the bin directory of the virtual directory of the Web Service (c:MyWebServicesin). Internet Information Services (IIS) looks for the proxy in this directory.

Create the service consumer, in the same way we already did. Note that an object of the Web Service proxy is instantiated in the consumer. This proxy takes care of interacting with the service.

Type the URL of the consumer in IE to test it (for example, http://localhost/MyWebServices/WebApp.aspx).

Windows Apppcation-Based Web Service Consumer

Writing a Windows apppcation-based web service consumer is the same as writing any other Windows apppcation. You only need to create the proxy (which we have already done) and reference this proxy when compipng the apppcation. Following is our Windows apppcation that uses the web service. This apppcation creates a web service object (of course, proxy) and calls the SayHello, and Add methods on it.

WinApp.cs

using System;
using System.IO;

namespace SvcConsumer {
   class SvcEater {
      pubpc static void Main(String[] args) {
         FirstService mySvc = new FirstService();
         Console.WriteLine("Calpng Hello World Service: " + mySvc.SayHello());
         Console.WriteLine("Calpng Add(2, 3) Service: " + mySvc.Add(2, 3).ToString());
      }
   }
}

Compile it using c:>csc /r:FirstService.dll WinApp.cs. It will create WinApp.exe. Run it to test the apppcation and the web service.

Now, the question arises: How can you be sure that this apppcation is actually calpng the web service?

It is simple to test. Stop your web server so that the web service cannot be contacted. Now, run the WinApp apppcation. It will fire a runtime exception. Now, start the web server again. It should work.