org.apache.wsif.providers.jca
Class WSIFOperation_JCA

java.lang.Object
  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 -

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

• Updates the InteractionSpec using data from the input message.
• If a Connection is not currently available creates one, where a ConnectionSpec can be created using data from the input message and then used when creating the Connection.
• Uses the Connection to create a javax.resource.cci.Interaction.
• Invokes the Interaction execute method.
• Closes the interaction.
• Updates the output message with InteractionSpec properties.

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

• Updates the InteractionSpec using data from the input message.
• If a Connection is not currently available creates one, where a ConnectionSpec can be created using data from the input message and then used when creating the Connection.
• Uses the Connection to create a javax.resource.cci.Interaction.
• Invokes the Interaction execute method.
• Closes the interaction.

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()

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