org.apache.wsif.providers.jca
Class WSIFOperation_JCA

java.lang.Object
  extended by org.apache.wsif.providers.jca.WSIFOperation_JCA
All Implemented Interfaces:
java.io.Serializable, WSIFOperation

public class WSIFOperation_JCA
extends java.lang.Object
implements WSIFOperation

The WSIFOperation_JCA class is an implementation of the WSIFOperation interface, which is used to execute interactions with the EIS.

Author:
Michael Beisiegel, Piotr Przybylski , John Green
See Also:
Serialized Form

Constructor Summary
WSIFOperation_JCA(javax.wsdl.Definition aDefinition, javax.wsdl.Service aService, javax.wsdl.Port aPort, java.lang.String aOperationName, java.lang.String aInputName, java.lang.String aOutputName, WSIFDynamicTypeMap typeMap, WSIFPort_JCA jcaPort, WSIFProviderJCAExtensions aFactory, Connection aConnection, InteractionSpec aInteractionSpec)
          The WSIFOperation_JCA constructor.
 
Method Summary
 WSIFMessage createFaultMessage()
          This method creates the fault message.
 WSIFMessage createFaultMessage(java.lang.String name)
          This method creates the fault message with specific name.
 WSIFMessage createInputMessage()
          This method creates the input message.
 WSIFMessage createInputMessage(java.lang.String name)
          This method creates the input message with specific name.
 WSIFMessage createOutputMessage()
          This method creates the output message.
 WSIFMessage createOutputMessage(java.lang.String name)
          This method creates the output message with specific name.
 void executeInputOnlyOperation(WSIFMessage input)
          Invokes input only operation.
 WSIFCorrelationId executeRequestResponseAsync(WSIFMessage input)
          Method not supported.
 WSIFCorrelationId executeRequestResponseAsync(WSIFMessage input, WSIFResponseHandler handler)
          Method not supported.
 boolean executeRequestResponseOperation(WSIFMessage input, WSIFMessage output, WSIFMessage fault)
          Invokes the request/response operation.
 void fireAsyncResponse(java.lang.Object response)
          Method not supported.
 WSIFMessage getContext()
          Method not supported.
 InteractionSpec getInteractionSpec()
          Returns the interactionSpec.
 boolean processAsyncResponse(java.lang.Object response, WSIFMessage output, WSIFMessage fault)
          Method not supported.
 void setContext(WSIFMessage context)
          Method not supported.
 void setInteractionSpec(InteractionSpec interactionSpec)
          Sets the interactionSpec.
 java.lang.String toString()
           
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

WSIFOperation_JCA

public WSIFOperation_JCA(javax.wsdl.Definition aDefinition,
                         javax.wsdl.Service aService,
                         javax.wsdl.Port aPort,
                         java.lang.String aOperationName,
                         java.lang.String aInputName,
                         java.lang.String aOutputName,
                         WSIFDynamicTypeMap typeMap,
                         WSIFPort_JCA jcaPort,
                         WSIFProviderJCAExtensions aFactory,
                         Connection aConnection,
                         InteractionSpec aInteractionSpec)
The WSIFOperation_JCA constructor.

Parameters:
aDefinition -
aBinding -
aOperationName -
aInputName -
aOutputName -
aConnection -
aInteractionSpec -
aFactory -
typeMap -
aPort -
aService -
jcaPort -
Method Detail

executeRequestResponseOperation

public boolean executeRequestResponseOperation(WSIFMessage input,
                                               WSIFMessage output,
                                               WSIFMessage fault)
                                        throws WSIFException
Invokes the request/response operation. This method

Specified by:
executeRequestResponseOperation in interface WSIFOperation
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 or false indicating whether a fault message was generated or not. The truth value indicates whether the output or fault message has useful information.
Throws:
WSIFException - if something goes wrong.

executeInputOnlyOperation

public void executeInputOnlyOperation(WSIFMessage input)
                               throws WSIFException
Invokes input only operation. This method

Specified by:
executeInputOnlyOperation in interface WSIFOperation
Parameters:
input - input message to send to the operation
Throws:
WSIFException - if something goes wrong.

createFaultMessage

public WSIFMessage createFaultMessage()
This method creates the fault message. It first attempts to use Resource Adapter specific class to create the message. If this fails (i.e. the Resource Adapter does not require specialized messages), the method creates and returns WSIFMessage_JCAStreamable message.

Specified by:
createFaultMessage in interface WSIFOperation
Returns:
a new message

createFaultMessage

public WSIFMessage createFaultMessage(java.lang.String name)
This method creates the fault message with specific name. It first attempts to use Resource Adapter specific class to create message. If this fails (i.e. the Resource Adapter does not require specialized messages), the method creates and returns WSIFMessage_JCAStreamable message.

Specified by:
createFaultMessage in interface WSIFOperation
Parameters:
name - for the new message
Returns:
a new message

createInputMessage

public WSIFMessage createInputMessage()
This method creates the input message. It first attempts to use Resource Adapter specific class to create message. If this fails (i.e. the Resource Adapter does not require specialized messages), the method creates and returns WSIFMessage_JCAStreamable message.

Specified by:
createInputMessage in interface WSIFOperation
Returns:
a new message

createInputMessage

public WSIFMessage createInputMessage(java.lang.String name)
This method creates the input message with specific name. It first attempts to use Resource Adapter specific class to create message. If this fails (i.e. the Resource Adapter does not require specialized messages), the method creates and returns WSIFMessage_JCAStreamable message.

Specified by:
createInputMessage in interface WSIFOperation
Parameters:
name - for the new message
Returns:
a new message

createOutputMessage

public WSIFMessage createOutputMessage()
This method creates the output message. It first attempts to use Resource Adapter specific class to create message. If this fails (i.e. the Resource Adapter does not require specialized messages), the method creates and returns WSIFMessage_JCAStreamable message.

Specified by:
createOutputMessage in interface WSIFOperation
Returns:
a new message

createOutputMessage

public WSIFMessage createOutputMessage(java.lang.String name)
This method creates the output message with specific name. It first attempts to use Resource Adapter specific class to create message. If this fails (i.e. the Resource Adapter does not require specialized messages), the method creates and returns WSIFMessage_JCAStreamable message.

Specified by:
createOutputMessage in interface WSIFOperation
Parameters:
name - for the new message
Returns:
a new message

getInteractionSpec

public InteractionSpec getInteractionSpec()
Returns the interactionSpec.

Returns:
Returns a InteractionSpec

setInteractionSpec

public void setInteractionSpec(InteractionSpec interactionSpec)
Sets the interactionSpec.

Parameters:
interactionSpec - The interactionSpec to set

toString

public java.lang.String toString()
Overrides:
toString in class java.lang.Object

executeRequestResponseAsync

public WSIFCorrelationId executeRequestResponseAsync(WSIFMessage input,
                                                     WSIFResponseHandler handler)
                                              throws WSIFException
Method not supported.

Specified by:
executeRequestResponseAsync in interface WSIFOperation
Parameters:
input - input message to send to the operation
handler - the response handler that will be notified when the asynchronous response becomes available.
Returns:
the correlation ID or the request. The correlation ID is used to associate the request with the WSIFOperation.
Throws:
WSIFException - if something goes wrong.

executeRequestResponseAsync

public WSIFCorrelationId executeRequestResponseAsync(WSIFMessage input)
                                              throws WSIFException
Method not supported.

Specified by:
executeRequestResponseAsync in interface WSIFOperation
Parameters:
input - input message to send to the operation
Returns:
the correlation ID or the request. The correlation ID is used to associate the request with the WSIFOperation.
Throws:
WSIFException - if something goes wrong.

fireAsyncResponse

public void fireAsyncResponse(java.lang.Object response)
                       throws WSIFException
Method not supported.

Specified by:
fireAsyncResponse in interface WSIFOperation
Parameters:
response - an Object representing the response
Throws:
WSIFException - if something goes wrong

processAsyncResponse

public boolean processAsyncResponse(java.lang.Object response,
                                    WSIFMessage output,
                                    WSIFMessage fault)
                             throws WSIFException
Method not supported.

Specified by:
processAsyncResponse in interface WSIFOperation
Parameters:
response - an Object representing the response.
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 or false indicating whether a fault message was generated or not. The truth value indicates whether the output or fault message has useful information.
Throws:
WSIFException - if something goes wrong

setContext

public void setContext(WSIFMessage context)
Method not supported.

Specified by:
setContext in interface WSIFOperation
Parameters:
context - context information

getContext

public WSIFMessage getContext()
Method not supported.

Specified by:
getContext in interface WSIFOperation
Returns:
context


Copyright ? 2002, 2006 Apache XML Project. All Rights Reserved.