xsul.wsif
Interface WSIFOperation

All Superinterfaces:
java.io.Serializable
All Known Implementing Classes:
XsulSoapOperation

public interface WSIFOperation
extends java.io.Serializable

A WSIFOperation is a handle on a particular operation of a portType that can be used to invoke web service methods. This interface is implemented by each provider. A WSIFOperation can be created using WSIFPort.createOperation(String).

Author:
Aleksander Slominski, Owen Burroughs , Ant Elder , Jeremy Hughes , Mark Whitlock

Method Summary
 WSIFMessage createFaultMessage()
          Create a fault message that may be received into via this port.
 WSIFMessage createInputMessage()
          Create an input message that will be sent via this port.
 WSIFMessage createOutputMessage()
          Create an output message that will be received into via this port.
 void executeInputOnlyOperation(WSIFMessage input)
          Execute an input-only operation.
 boolean executeRequestResponseOperation(WSIFMessage input, WSIFMessage output, WSIFMessage fault)
          Execute a request-response operation.
 WsdlBindingOperation getBindingOperation()
           
 

Method Detail

getBindingOperation

public WsdlBindingOperation getBindingOperation()
                                         throws WSIFException
Throws:
WSIFException

executeRequestResponseOperation

public boolean executeRequestResponseOperation(WSIFMessage input,
                                               WSIFMessage output,
                                               WSIFMessage fault)
                                        throws WSIFException
Execute a request-response operation. The signature allows for input, output and fault messages. WSDL in fact allows one to describe the set of possible faults an operation may result in, however, only one fault can occur at any one time.

Parameters:
input - input message to send to the operation
output - an empty message which will be filled in if the operation invocation succeeds. If it does not succeed, the contents of this message are undefined. (This is a return value of this method.)
fault - an empty message which will be filled in if the operation invocation fails. If it succeeds, the contents of this message are undefined. (This is a return value of this method.)
Returns:
true indicating that operation succeded and result is output message, if false the fault is int the fault message.
Throws:
WSIFException - if something goes wrong.

executeInputOnlyOperation

public void executeInputOnlyOperation(WSIFMessage input)
                               throws WSIFException
Execute an input-only operation.

Parameters:
input - input message to send to the operation
Throws:
WSIFException - if something goes wrong.

createInputMessage

public WSIFMessage createInputMessage()
Create an input message that will be sent via this port. It is responsibility of caller to set message name.

Returns:
a new message

createOutputMessage

public WSIFMessage createOutputMessage()
Create an output message that will be received into via this port. It is responsibility of caller to set message name.

Returns:
a new message

createFaultMessage

public WSIFMessage createFaultMessage()
Create a fault message that may be received into via this port. It is responsibility of caller to set message name.

Returns:
a new message


IU Extreme! Lab (http://www.extreme.indiana.edu)