WebService Behavior

• Download demo project - 46.4 Kb

Introduction

The WebService behavior enables methods that are implemented on Web Services to be called from client-side script in a web page. The main advantage of the WebService behavior is that it is now possible to update contents of the web page without reloading the whole page. For example, in this article I have used the behavior to display continuously quotes at regular intervals without reloading the page. You can use this feature to display continuously featured products, latest news etc.

XML Web services

XML Web services are program components that allow you to build scalable, loosely coupled, platform-independent applications. XML Web services enable disparate applications to exchange messages using standard protocols such as HTTP, XML, XSD, SOAP, and Web Services Description Language (WSDL).

To study the WebService behavior I have written a simple FactorialService WebService and QuoteService WebService. FactorialService WebService contains the following WebMethod

  <WebMethod()> Public Function Factorial(
      ByVal Number As Integer) As String
    Try
     If Number = 0 Then
      Return 1
     Else
      Return Number * Factorial(Number - 1)
     End If
    Catch ex As Exception
     Return ex.Message
    End Try
  End Function

QuoteService WebService contains the following WebMethod.

  <WebMethod()> Public Function GetQuote() As String
    Select Case getRand.Next(4)
     Case 0
      Return "Where there is a will there is a way"
     Case 1
      Return "Necessity is the mother of invention"
     Case 2
      Return "Be the head and not the tail"
     Case 3
      Return "Rome was not built in a day"
    End Select
  End Function

Attaching the WebService Behavior

The WebService behavior is implemented with an HTML Component (HTC) file as an attached behavior. So it can be used in Microsoft Internet Explorer 5 and later versions.

To attach a WebService behavior to a page we need to follow the following steps,

• First download the WebService HTC File file and put a copy in the same directory as the pages that use the behavior.
• The next step in using the WebService behavior is to attach it to an HTML element using the STYLE attribute and set the id attribute so that this element can be easily referenced in script.

<div id="Service" style="behavior:url(webservice.htc)"></div>

In our code we have used the following div tag:

<div id="Service" style="BEHAVIOR:url(webservice.htc)" 
  onresult="Service_Result()"></div>

The event handler for the Onresult event is the default for the behavior. We will be shortly dealing with it.

Identifying Web Services

The useService method is used to identify the WebService. This method has two parameters i.e.. "ServiceURL" and "FriendlyName". The method maps the Web Service URL to a FriendlyName. The friendly name for the Web Service is later used directly in script to reference the Web Service URL.

The syntax of the useService method is as follows:

id.useService("ServiceURL","FriendlyName");

The id is the id attribute of the HTML tag to which the behavior is attached.

In our code we have used the following Javascript code:

  //---------------------------------------------------

  // Init is used to indentify the webservices

  //---------------------------------------------------

    function Init()
    {
    //useService is used to identify the FactorialService webservice

     Service.useService("WebServices/FactorialService.asmx?WSDL",
        "FactorialService");
    //Function is used to call the QuoteService webservice at 

     //regular intervals

     GetNewQuote();
     setInterval( "GetNewQuote()", 5000 ) 
    }
  //-----------------------------------------------------

  // GetNewQuote is used to indentify the webservices and 

  // call webmethods at the same time

  //-----------------------------------------------------

    function GetNewQuote()
    {
     //useService is used to identify the QuoteService webservice

     Service.useService("WebServices/QuoteService.asmx?WSDL","QuoteService");
     
     // callService method is used to invoke methods and 

     // QuoteService_Result is the callback event handler

     
     intCallID = Service.QuoteService.callService( QuoteService_Result, 
        "GetQuote" );
    }

Init function is called in the body tag as shown:

<body bgColor="#ffffff" text="#000000" link="#0000cc" vLink="#0000cc" 
  aLink="#ff0000" leftmargin="0" topmargin="0" marginwidth="0"
  marginheight="0" onload="Init()">

Calling WebMethods

The callService method is used to call WebMethods of the WebService. The WebService behavior supports both synchronous and asynchronous remote procedure calls to WebServices. The asynchronous mode of remote method invocation is used as default.

The syntax of the callService method is as follows:

iCallID = id.FriendlyName.callService([CallbackHandler,] 
  "MethodName", Param1, Param2, ...);

The first parameter of the callService method is a callback handler function to process the results received from the method call which is optional. If callback handler is absent, then the event handler for the onresult event is used. The onresult event is fired by the WebService behavior as soon as the result of the remote call is completed. MethodName is the name of the WebMethod while Param1, Param2, ... are the parameters to be passed to the WebMethod.

In our code, when you click the Callback button, CallBackButton_Click event is fired which calls the Factorial method of the WebService. Factorial_Result serves as the callback handler.

 
  function CallBackButton_Click()
  {
   intCallID = Service.FactorialService.callService( 
      Factorial_Result, "Factorial", txtFactorial.value );
  }

  function Factorial_Result( result )
  {
    if ( result.error )
     {
      lblFactorial.innerText = result.errorDetail.string;
     } 
     else
     {
     lblFactorial.innerText = "The factorial of " + 
      txtFactorial.value + " is " + result.value;
     }
  
  }

When the Normal button, NormalButton_Click event is fired which calls the Factorial method of the WebService.

  function NormalButton_Click()
  {
     intCallID = Service.FactorialService.callService( 
      "Factorial", txtFactorial.value );
  }

In the absence of the callback handler, onresult event handler of the html tag is fired which in turn calls the Service_Result method.

  function Service_Result()
  {
   if ( event.result.error )
   {
    lblFactorial.innerText = event.result.errorDetail.string;
   } 
   else
   {
    lblFactorial.innerText = "The factorial of " + 
      txtFactorial.value + " is " + event.result.value; 
   }
  }

For the QuoteService, GetNewQuote is used to identify the WebService and call WebMethods simultaneously. QuoteService_Result is the callback event handler for the QuoteService.

  //--------------------------------------------------

  // GetNewQuote is used to indentify the webservices and 

   // call webmethods at the same time

  //---------------------------------------------------

      function GetNewQuote()
      {
       //useService is used to identify the QuoteService webservice

       Service.useService("WebServices/QuoteService.asmx?WSDL",
                "QuoteService");
       
       // callService method is used to invoke methods and 

         // QuoteService_Result is the callback event handler

       
       intCallID = Service.QuoteService.callService( 
              QuoteService_Result, "GetQuote" );
      }
  //------------------------------------------------------

  // QuoteService_Result is the callback event handler 

   // for the QuoteService

  //-------------------------------------------------------

      function QuoteService_Result(result)
      {
       if (result.error) 
       {
       divQuote.innerText = result.errorDetail.string;
       }
       else
       {
       divQuote.innerText = result.value;
       }
      }

The Result Object

Whenever callService is invoked, an object containing results data is generated. When the eventhandler is present, the result object is referenced as the name of the parameter being passed to the user-defined callback function. In the absence of the eventhandler, the result object is referenced as event.result when the event handler is absent or as the name of the parameter being passed to the user-defined callback function.

Here is the list of properties of event.result we have used in our code..

event.result.error	Returns a boolean value
event.result.errorDetail.string	Returns the detailed information of the error
event.result.value	Returns result of the webmethod

When the eventhandler is present, the result object is referenced as the name of the parameter being passed to the user-defined callback function. Here is the list of properties it exposes.

result.error	Returns a boolean value
result.errorDetail.string	Returns the detailed information of the error
result.value	Returns result of the webmethod

When an error or problem occurs for a method call, the error property is set to true and the errorDetail is generated at runtime. The errorDetail object exposes several properties, which can be quite helpful in diagnosing the error.

It is always good programming practice to verify a function call. Hence in our examples, the error property is checked to determine if the remote method invocation was processed successfully.

Limitations

The following are the limitations of the behavior

1. The behavior accesses Web Services in the same domain as the web page.
2. There is no direct support for complex types such as DataSets, DataTables, collections or custom objects, etc. It supports all the base .NET types and arrays of the the base .NET types

You must Sign In to use this message board.

FAQ    Noise Tolerance Very HighHighMediumLowVery Low   Layout Expand Posts & RepliesThread ViewNo JavascriptNo JS + Preview   Per page 102550

Msgs 1 to 12 of 12 (Total in Forum: 12) (Refresh) FirstPrevNext

creating a windows based application using webservices srichandk 0:52 5 Feb '07   dear all, this is srichad, i am trring to create a windows based applicaiton (better to be called as web service)using vb.net (Not realted to WEB).. this application should interact with another web service develped in java... and exchange information ........ please answer these questions: 1. so can any one suggest me how to create an windows based webservice using vb.net 2. is creating a webservice possible which needs to connect to a jboss webservice..... ***Note:- this application is not related to web concept.. thnx in advance... srichand. Sign In·View Thread·PermaLink timer to trigger the refresh of webpage kd8341 10:31 10 Jun '05   In your description for the webservice behavior, you used a timer to trigger "GetNewQuote()". setInterval( "GetNewQuote()", 5000 ) I just don't know how this timer works. Is it running at server side or client side? I want to build a web page with asp.net 2003 and refresh part of its content in every 1 second. I tried a standard windows form timer, but it just doesn't work. Can you recommend me some samples or articles for me to do that? Thanks! Kevin Sign In·View Thread·PermaLink Looking for a web service for real-time forex info ilan_levy 22:53 22 Feb '05   Hi, I'm looking for a web-service to get some forex data, for example the EUR/USD trading rates (Ask, Bid) All I found, was some webservice that get some stocks data: both, from Yahoo Finance. But I can't find forex data in yahoo finance, any ideas? Sign In·View Thread·PermaLink custom parameters Anonymous 7:24 24 Jul '04   How to pass custom parameters (classes etc.). Microsoft documenttion says that behaviors suppports this objects as scriptable objects but how to use this in practice? Thanks. Sign In·View Thread·PermaLink [Message Removed] immetoz 16:10 4 Oct '08   Spam message removed Sign In·View Thread·PermaLink web service returning dataset Pradeep K V 22:21 21 Apr '04   In my case the web service returns a dataset.In such a case the intCallID = Service.myService.callService( "mymethod", param1,param2); will not working... what i have to do in such cases Sign In·View Thread·PermaLink Re: web service returning dataset Stevan Rodrigues 22:50 21 Apr '04   Hi, You will need to use array to return datatable. Regards, Stevan Sign In·View Thread·PermaLink Re: web service returning dataset Chris Norton 11:56 11 Mar '05   Hmmmm... I'm not convinced. I personally have a web service returning a C# struct that is marked as [Serializable] and the result.value I get back is a nice javascript object like: result.value.DaylightDate.Month Also, this author uses a web service that returns a dataset and the webservice behavior that consumes it as XML and displays it using XSLT: http://www.devx.com/dotnet/Article/20369/0/page/7 - Chris Sign In·View Thread·PermaLink Re: web service returning dataset Stevan Rodrigues 20:44 27 Mar '05   When i had written the article dataset was not supported. Also I was very clear in stating that 'There is no direct support for complex types' Also this is what the author meintioned in http://www.devx.com/dotnet/Article/20369/0/page/7 [^] 'The problem is that IE5 doesn't know what a DataSet is and so you can't use techniques such as data binding to display it. As far as IE5 is concerned, the Web service return value is just an XML document with an inline schema, loaded into an instance of the MSXML parser. Fortunately, that means you can use any technique that works with XML documents to process the content.' He is also quite clear that you cannot directly make use of dataset. Regards, Stevan Rodrigues M. Sc., B.Ed., MCSD.net(Early achiever), MCAD(Charter Member) Sign In·View Thread·PermaLink Need Urgent Help V. Anandan 15:19 24 Feb '04   Hi, I have created a web service which is performing Zipping Process. I am calling this webservice from client side script(using userService() with the help of webservice.htc). The process is working fine in certain clients. In certain clients,it is throwing an error message "Service Unavailable". I spent around 2 days to fix this bug.But I couldn't... Anybody encouter this kind of problem before... Is there any settings need to be changed in IE?... Is there any relationship with the framework?...I am using .net framework1.0 and I am using MSXML2.DOMDocument.3.0. pls help me to fix this problem... Anandan Sign In·View Thread·PermaLink 2.00/5 (2 votes) Re: Need Urgent Help Alastair Todd 3:03 21 Apr '04   Hi I've had exactly the same problem - i've used the original article from microsoft which looks pretty similar to the above. http://msdn.microsoft.com/library/default.asp?url=/workshop/author/webservice/overview.asp Its the ?WSDL querystring parameter. Reading the document, its seems to suggest you put that in IF you have a WSDL file describing your web service. I dont so i took it out. I got the error you describe. Put it back in and i get the result. Sign In·View Thread·PermaLink 2.00/5 (1 vote) Re: Need Urgent Help Anonymous 3:46 4 May '04   Hey thanks guys, just solved the problem for me too. Pete Sign In·View Thread·PermaLink

Last Visit: 23:44 8 Nov '09     Last Update: 23:44 8 Nov '09 1