javax.resource.cci.Interaction enables a component to
execute EIS functions. An Interaction instance supports the following ways
of interacting with an EIS instance:
execute method that takes an input Record, output
Record and an InteractionSpec. This method executes the EIS
function represented by the InteractionSpec and updates the
output Record
execute method that takes an input Record and an
InteractionSpec. This method implementation executes the EIS
function represented by the InteractionSpec and produces the
output Record as a return value.
An Interaction instance is created from a Connection and is required to maintain its association with the Connection instance. The close method releases all resources maintained by the resource adapter for the Interaction. The close of an Interaction instance should not close the associated Connection instance.
java.sql.ResultSet
| Modifier and Type | Method and Description |
|---|---|
| public void | |
| public void | close()
Closes the current Interaction and release all the resources held for this instance by the resource adapter. |
| public boolean | Returns: true if execution of the EIS function has been successful and output Record has been updated; false otherwiseInteractionSpec representing a target EIS
data/function module ispec, Record Input Record input, Record Output Record output)Executes an interaction represented by the InteractionSpec. |
| public Record | Returns: output Record if execution of the EIS function has been successful; null otherwiseInteractionSpec representing a target EIS
data/function module ispec, Record Input Record input)Executes an interaction represented by the InteractionSpec. |
| public Connection | Returns: Connection instance associated with the InteractionGets the Connection associated with the Interaction. |
| public ResourceWarning | Returns: ResourceWarning at top of the warning chainGets the first ResourceWarning from the chain of warnings associated with this Interaction instance. |
| clearWarnings | back to summary |
|---|---|
| public void clearWarnings() throws ResourceException Clears all the warning reported by this Interaction instance. After a call to this method, the method getWarnings will return null until a new warning is reported for this Interaction.
| |
| close | back to summary |
|---|---|
| public void close() throws ResourceException Closes the current Interaction and release all the resources held for this instance by the resource adapter. The close of an Interaction instance does not close the associated Connection instance. It is recommended that Interaction instances be closed explicitly to free any held resources.
| |
| execute | back to summary |
|---|---|
| public boolean execute(InteractionSpec ispec, Record input, Record output) throws ResourceException Executes an interaction represented by the InteractionSpec. This form of invocation takes an input Record and updates the output Record.
| |
| execute | back to summary |
|---|---|
| public Record execute(InteractionSpec ispec, Record input) throws ResourceException Executes an interaction represented by the InteractionSpec. This form of invocation takes an input Record and returns an output Record if the execution of the Interaction has been successfull.
| |
| getConnection | back to summary |
|---|---|
| public Connection getConnection() Gets the Connection associated with the Interaction.
| |
| getWarnings | back to summary |
|---|---|
| public ResourceWarning getWarnings() throws ResourceException Gets the first ResourceWarning from the chain of warnings associated with this Interaction instance.
| |