WAS v8.5 > Reference > Developer detailed usage information

WSIFOperation interface

Use WSIFOperation interface to invoke a service, based on a particular binding.

The WSIFOperation interface is the runtime representation of an operation. This interface provides methods to create input, output, and fault messages, and to invoke the operation.

For more information about the WSIFOperation interface, see the generated API documentation supplied with WSIF (see the Apache WSIF website).

createInputMessage, createOutputMessage and createFaultMessage

These are factory methods to create the messages required by the invocation methods. All invocation methods require an input message.

executeRequestResponseOperation

This method invokes "In Out" operations.

executeInputOnlyOperation

This method invokes "In only" operations.

executeRequestResponseOperation

If this method is used for invocation, an output and a fault message are instantiated and passed on the call to the method. If the method returns true, the output message contains the response message. If the message returns false, a fault occurred and is returned in the fault message.

executeRequestResponseAsync

This method allows "In Out" operations to be invoked with the reply handled using an alternative thread. Use of this method is discussed further in WSIFOperation - Asynchronous interactions reference.

setContext and getContext

Use of these methods is discussed in WSIFOperation - Context.

All of the executeNnnn methods fail with an exception if there is an error in processing the request in the WSIF provider.

Setting the timeouts for synchronous and asynchronous operations is discussed in WSIFOperation - Synchronous and asynchronous timeouts reference.

Subtopics

• WSIFOperation - Context
  Although Web Services Description Language (WSDL) does not define context, a number of uses of the Web Services Invocation Framework (WSIF) require the ability to pass context to the port that is invoking the service.
• WSIFOperation - Asynchronous interactions reference
  The WSIF supports asynchronous operation. In this mode of operation, the client puts the request message as part of one transaction, and carries on with the thread of execution. The response message is then handled by a different thread, with a separate transaction.
• WSIFOperation - Synchronous and asynchronous timeouts reference
  When we use the WSIF with the JMS we can set timeouts for synchronous and asynchronous operations.

Reference:

WSIFPort interface
WSIFService interface
WSIFServiceFactory class

Related information:

Apache WSIF

+

Search Tips   |   Advanced Search