public interface Interaction
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.
ResultSet
Modifier and Type | Method and Description |
---|---|
void |
clearWarnings()
Clears all the warning reported by this Interaction instance.
|
void |
close()
Closes the current Interaction and release all the resources
held for this instance by the resource adapter.
|
Record |
execute(InteractionSpec ispec,
Record input)
Executes an interaction represented by the InteractionSpec.
|
boolean |
execute(InteractionSpec ispec,
Record input,
Record output)
Executes an interaction represented by the InteractionSpec.
|
Connection |
getConnection()
Gets the Connection associated with the Interaction.
|
ResourceWarning |
getWarnings()
Gets the first ResourceWarning from the chain of warnings
associated with this Interaction instance.
|
void close() throws ResourceException
ResourceException
- Failed to close the Interaction
instance. Invoking close on an
already closed Interaction should
also throw this exception.Connection getConnection()
boolean execute(InteractionSpec ispec, Record input, Record output) throws ResourceException
ispec
- InteractionSpec representing a target EIS
data/function moduleinput
- Input Recordoutput
- Output RecordResourceException
- Exception if execute operation
fails. Examples of error cases
are:
NotSupportedException
- Operation not supportedRecord execute(InteractionSpec ispec, Record input) throws ResourceException
ispec
- InteractionSpec representing a target EIS
data/function moduleinput
- Input RecordResourceException
- Exception if execute operation
fails. Examples of error cases
are:
NotSupportedException
- Operation not supportedResourceWarning getWarnings() throws ResourceException
ResourceException
- Failed to get ResourceWarnings
associated with Interactionvoid clearWarnings() throws ResourceException
ResourceException
- Failed to clear ResourceWarnings
associated with InteractionCopyright © 2017 JBoss by Red Hat. All rights reserved.