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