org.apache.wsif.providers.jca
Interface WSIFProviderJCAExtensions


public interface WSIFProviderJCAExtensions

This interface contains methods implemented by each Resource Adapter and used by the Connector Architecture provider to delegate Connector specific operations, for example creation of the WSIFOperation to the Resource Adapter.

Author:
Michael Beisiegel, Piotr Przybylski , John Green

Method Summary
 Connection createConnection(WSIFMessage input, javax.wsdl.Definition definition, javax.wsdl.Service service, javax.wsdl.Port port, WSIFDynamicTypeMap typeMap, javax.wsdl.Binding aBinding, java.lang.String aOperationName, java.lang.String aInputName, java.lang.String aOutputName)
          Creates a javax.resource.cci.Connection.
 WSIFMessage createFaultMessage(javax.wsdl.Definition definition, javax.wsdl.Binding binding, java.lang.String operationName, java.lang.String inputName, java.lang.String outputName)
          This method creates a FaultMessage.
 WSIFMessage createInputMessage(javax.wsdl.Definition definition, javax.wsdl.Binding binding, java.lang.String operationName, java.lang.String inputName, java.lang.String outputName)
          This method creates input message.
 WSIFOperation createOperation(javax.wsdl.Definition definition, javax.wsdl.Service aService, javax.wsdl.Port aPort, java.lang.String operationName, java.lang.String inputName, java.lang.String outputName, WSIFDynamicTypeMap typeMap, WSIFPort_JCA jcaPort, Connection connection)
          The provider for a resource adapter creates a WSIFOperation based on the specified WSDL operation.
 WSIFMessage createOutputMessage(javax.wsdl.Definition definition, javax.wsdl.Binding binding, java.lang.String operationName, java.lang.String inputName, java.lang.String outputName)
          This method creates output message.
 void updateInteractionSpec(WSIFMessage input, javax.wsdl.Binding aBinding, java.lang.String aOperationName, java.lang.String aInputName, java.lang.String aOutputName, InteractionSpec aInteractionSpec)
          Updates the interactionSpec from input message values.
 void updateOutputMessage(WSIFMessage output, javax.wsdl.Binding aBinding, java.lang.String aOperationName, java.lang.String aInputName, java.lang.String aOutputName, InteractionSpec aInteractionSpec)
          Updates the output message using output InteractionSpec values.
 

Method Detail

createOperation

WSIFOperation createOperation(javax.wsdl.Definition definition,
                              javax.wsdl.Service aService,
                              javax.wsdl.Port aPort,
                              java.lang.String operationName,
                              java.lang.String inputName,
                              java.lang.String outputName,
                              WSIFDynamicTypeMap typeMap,
                              WSIFPort_JCA jcaPort,
                              Connection connection)
                              throws WSIFException
The provider for a resource adapter creates a WSIFOperation based on the specified WSDL operation. The binding operation extensibility element allows the resource adapter to populate its InteractionSpec to be used in the operation.

Parameters:
definition -
aService -
aPort -
operationName -
inputName -
outputName -
typeMap -
jcaPort -
connection -
Returns:
WSIFOperation
Throws:
WSIFException

createInputMessage

WSIFMessage createInputMessage(javax.wsdl.Definition definition,
                               javax.wsdl.Binding binding,
                               java.lang.String operationName,
                               java.lang.String inputName,
                               java.lang.String outputName)
This method creates input message. It only needs to be implemented by Resource Adapter which uses custom format of the input and output records (i.e. does not use javax.resource.cci.Streamable interface).

Parameters:
definition -
binding -
operationName -
inputName -
outputName -
Returns:
WSIFMessage

createOutputMessage

WSIFMessage createOutputMessage(javax.wsdl.Definition definition,
                                javax.wsdl.Binding binding,
                                java.lang.String operationName,
                                java.lang.String inputName,
                                java.lang.String outputName)
This method creates output message. It only needs to be implemented by Resource Adapter which uses custom format of the input and output records (i.e. does not use javax.resource.cci.Streamable interface).

Parameters:
definition -
binding -
operationName -
inputName -
outputName -
Returns:
WSIFMessage

createFaultMessage

WSIFMessage createFaultMessage(javax.wsdl.Definition definition,
                               javax.wsdl.Binding binding,
                               java.lang.String operationName,
                               java.lang.String inputName,
                               java.lang.String outputName)
This method creates a FaultMessage.

Parameters:
definition -
binding -
operationName -
inputName -
outputName -
Returns:
WSIFMessage

updateInteractionSpec

void updateInteractionSpec(WSIFMessage input,
                           javax.wsdl.Binding aBinding,
                           java.lang.String aOperationName,
                           java.lang.String aInputName,
                           java.lang.String aOutputName,
                           InteractionSpec aInteractionSpec)
                           throws WSIFException
Updates the interactionSpec from input message values. The method is called from within the operation execute method, before invocation of Interaction.execute() method of the resource adapter.

Parameters:
input -
aBinding -
aOperationName -
aInputName -
aOutputName -
aInteractionSpec -
Throws:
WSIFException

updateOutputMessage

void updateOutputMessage(WSIFMessage output,
                         javax.wsdl.Binding aBinding,
                         java.lang.String aOperationName,
                         java.lang.String aInputName,
                         java.lang.String aOutputName,
                         InteractionSpec aInteractionSpec)
                         throws WSIFException
Updates the output message using output InteractionSpec values. This method is called from within the WSIFOperation execute method, after processing the Interaction.execute() method of the resource adapter..

Parameters:
output - Output message to populate
aBinding - Bonding
aOperationName - Operation name
aInputName - Inpput name
aOutputName - Output name
aInteractionSpec - InteractionSpec after the execute() method invocation
Throws:
WSIFException

createConnection

Connection createConnection(WSIFMessage input,
                            javax.wsdl.Definition definition,
                            javax.wsdl.Service service,
                            javax.wsdl.Port port,
                            WSIFDynamicTypeMap typeMap,
                            javax.wsdl.Binding aBinding,
                            java.lang.String aOperationName,
                            java.lang.String aInputName,
                            java.lang.String aOutputName)
                            throws WSIFException
Creates a javax.resource.cci.Connection. This should be used when a resource adapter supports passing ConnectionSpec values as part of the input message. WSIFOperation_JCA will only call this method during the execute method if the WSIFPort_JCA does not contain a connection.

Parameters:
input -
definition -
service -
port -
typeMap -
aBinding -
aOperationName -
aInputName -
aOutputName -
Returns:
Connection
Throws:
WSIFException


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