Web Services, Part III: WebService's Methods: The useService() Method - Doc JavaScript | WebReference

Web Services, Part III: WebService's Methods: The useService() Method - Doc JavaScript


Web Services, Part III: WebService's Methods

The useService() Method

The useService method establishes a friendly name for a Web service. The friendly name is important for keeping your script short and compact. You can use the short friendly name instead of the Web service's long URL. Since you are going to reference the same Web service several times in your script, you are sure to appreciate this feature. Here is the syntax for calling the useService() method:


sElementID.useService(sWebServiceURL, sFriendlyName
  [, oUseOptions]);

where:

Here are some examples:

webServiceCallerBody.useService
  ("echoService.asmx","echo");

webServiceCallerBody.useService
  ("echoService.wsdl","echo");

webServiceCallerBody.useService(
  "D:\legacy\yehuda\uyehuda\column97\echoService.asmx?
    WSDL","echo");

webServiceCallerBody.useService(
  "http://www.webreference.com/js/column97/
    echoService.asmx?WSDL","echo");

webServiceCallerBody.useService(
  "../../echoService.asmx?WSDL","echo");

webServiceCallerBody.useService(
  "./subfolder/echoService.asmx?WSDL","echo");

To ensure that the useService() method works correctly, you should place it inside an event handling function for the onload event. In this way, you will ensure that the first attempt to call the method in the behavior occurs only after the page has been downloaded and parsed. The event handling function may define friendly names for one or more Web Services. Here is an example:

function loadService() {
  webServiceCallerBody.onserviceavailable =
    enableServiceCall;  //Used for the synchronous call.
  webServiceCallerBody.useService(
    "http://soap.bluestone.com:80/interop/
      EchoService/EchoService.wsdl",
    "echo");
}

Next: How to use the callService() method

http://www.internet.com


Produced by Yehuda Shiran and Tomer Shiran
All Rights Reserved. Legal Notices.
Created: December 3, 2001
Revised: December 3, 2001

URL: http://www.webreference.com/js/column98/6.html