November 26, 2001 - Asynchronously vs Synchronously

Yehuda Shiran November 26, 2001
Asynchronously vs Synchronously
Tips: November 2001

Yehuda Shiran, Ph.D.
Doc JavaScript

There are two ways to call a Web service, asynchronous and synchronous. The asynchronous way is the default. You just call the Web service and don't wait for a return, like in this example:

iCallID = webServiceCallerBody.echo.callService(
  handleResult, "echoString", "Asynchronous Call");
You don't wait for the Web service to return its answer. When it returns, the handleResult() function handles the value coming back:

function handleResult(res) {
  if (!res.error) {
    alert("Successful call. Result is " + res.value);
  }
  else {
    alert("Unsuccessful call. Error is " + res.errorDetail.string);
  }
}
The synchronous way kicks in when you set the async property of the Call Options object to false. This is how you create the co object and set its async property:

function callSynch() {
  var co = webServiceCallerBody.createCallOptions();
  co.funcName = "echoString";
  co.async = false;
  var oResult = webServiceCallerBody.echo.callService(co, "Synchronous Call");
  handleResult(oResult);
}