The Web Services Client Programming ModelAdded by IBM on October 4, 2010 | Version 1 (Original)
Similar to the programming model specified in the Web Services for J2ME specification (JSR-172), the Lotus® Expeditor Toolkit provides the following capabilities:
- A generated stub from the Web Services Description Language (WSDL) description of the service operation.
The Mobile Web Services Client wizard generates a static client stub class using the WSDL that is exported from the Web Services provider as its input. The stub is then used to invoke the Web Services provider.
In addition to the static stub, the Web Services Gateway proxy library (com.ibm.pvcws.osgi), a component of Lotus Expeditor can be used to generate a dynamic client stub on-the-fly. This dynamic client stub may be used in place of the static client stub, which hard-codes the SOAP message definitions and method calls, in order to build Web Services clients dynamically. Other functionality provided by this proxy library is the ability to provide custom marshallers (serializers) for types that are incompatible with JSR-172.
Note: Lotus Expeditor Client for Devices supports Web Services clients that are similar to a JSR-172 specification and does not provide com.ibm.pvcws.osgi.
- WSDL-defined API.
The WSDL document defines an application programming interface (API) that makes up the complete Web Services client application. This API must be present on both the server and client side to allow the endpoints to communicate properly.
- Instantiation of the stub
The client application uses an instance of the static or dynamic stub to indirectly access the Web service defined by a given WSDL.
It is imperative that the WSDL definition reflects the actual interface to the Web service at runtime. The JAX-RPC subset does not perform any version control. Any differences between the defined WSDL and the instance of the Web Service may produce unpredictable results.
- Invocation of stub methods that correspond to the implementation of service endpoint operations.
The Web Services client application can use an instance of the stub to set stub properties, including the service endpoint. The methods generated in the stub are used to call service endpoint operations.
- Packaging the stub with the client application.
The generated stub is provided in source form. It is used during application development.
Parent topic: Technologies: XPD621