Package tryllian.webservices.client

Provides a task to access SOAP RPC web services.

See:
Description

Class Summary

SendRPCMessageTask

This task provides simple API which can be used to implement SOAP based remote procedure calls (RPC) without knowing technical details of the underlying implementation.

Package tryllian.webservices.client Description

Provides a task to access SOAP RPC web services. Creating a SOAP call dynamically requires some webservice knowledge, but offers great flexibility.

The SOAP Call creation uses Sun's JAX-RPC API, that shields the underlying Apache AXIS SOAP implementation. See Sun's JAX-RPC home page for details on how to use JAX-RPC.

Note that JAX-RPC API standard is not yet completely finilized yet as per June 1, 2002.

An alternative method to create agent client code for an exsiting web service is to generate Java stub code from a WSDL description,
without having to deal withJAX-RPC details. An example of an agent created this way can be found in the walkthrough package.

The tasks are build on a similar structure that is roughly used as follows:

1. Inside an agent or a task, a new RPC task instance is created.
2. The task is used to create a Call object.
3. All required arguments for the method call are supplied to the Call object according to the JAX-RPC API.
4. A TaskListener is added to deal with the results once the RPC call is finished.
5. The task is added, resulting in the RPC call to be made in a non-blocking way.
6. After the task has suceeded, the return value (if available) is retrieved from the task.

For an intro into JAX-RPC see http://developer.java.sun.com/developer/technicalArticles/WebServices/getstartjaxrpc/