The Web services connector is used by an IBM® WebSphere® Multichannel Bank
Transformation Toolkit processor
flow, a pass through operation flow for the presentation server layer,
or WebSphere Multichannel
Bank Transformation Toolkit application
code to access Web services.
There are two types of pass through operation flows: the extension
of the generic server operation and the Web services access operation.
If you are invoking Web services by using the generic server operation,
you must do the following tasks manually:
- Retrieve the service instance from the WebSphere Multichannel
Bank Transformation Toolkit context.
- Assemble the data for outgoing messages.
- Invoke Web services.
- Collect data for incoming messages.
If you choose to provide access to Web services for your application
by using the Web service access operation, Web services are invoked
automatically after you define the
.xml files.
Figure 1 shows the implementation
of the Web services connector:
Figure 1. Implementation
of the Web services connector.
Both the BTTJaxWsConnector class and the BTTJaxRpcConnector class
extend the com.ibm.btt.base.Service class to inherit
the behaviors that are required by a WebSphere Multichannel
Bank Transformation Toolkit service.
Both the BTTJaxWsConnector class and the BTTJaxRpcConnector also
implement the com.ibm.btt.ws.WSConnector interface,
which defines the API for a generic Web services connector.
The Web services handler, which is built from the JAX-WS technology,
is a message interceptor that can be used at JAX-WS runtime by the
Web services connector to enhance the processing and transmission
of messages between a
WebSphere Multichannel
Bank Transformation Toolkit application
and Web services. Because JAX-PRC does not have a mechanism for message
interception,
WebSphere Multichannel
Bank Transformation Toolkit provides
the JaxRpcServiceProcessor as well as the Web services handler. In
this document, the JaxRpcServiceProcessor and the Web services handler
are both referred to as handlers. The following block of code is an
example of how to use a handler for the Web services connector:
public class SampleJaxWsConnector extends BTTJaxWsConnector {
public Service createJaxWsService() throws WebServiceException{
if (getHandlerResolver() != null) {
getHandlerResolver().registerHandler(new SampleHeaderHandler());
}
return super.createJaxWsService();
}
}
For information on extending the Web services connector, refer
to the Web services extension topic.