org.seedstack.cci

Interface ManagedInteraction<I extends javax.resource.cci.Record,O extends javax.resource.cci.Record>

Type Parameters:

I - the input type of the EIS function.

O - the output type of the EIS function.

public interface ManagedInteraction<I extends javax.resource.cci.Record,O extends javax.resource.cci.Record>

Provides the ability to execute EIS functions that have been detected by scanning classes annotated with InteractionInput, optionally paired with a class annotated with an InteractionOutput annotation with the same value.

Consider the following input/output classes:

  @InteractionInput("someInteraction")
  public class TestInputRecord implements Record {...}

  @InteractionOutput("someInteraction")
  public class TestOutputRecord implements Record {...}
 

The managed interaction can be injected as:

 public class SomeClass {
    @Inject
    @Named("someInteraction")
    private ManagedInteraction<TestInputRecord, TestOutputRecord> someInteraction;
 }
 

The managed interaction can also be injected as the plain Interaction interface:

 public class SomeClass {
    @Inject
    @Named("someInteraction")
    private Interaction someInteraction;
 }
 

Method Summary

Modifier and Type	Method and Description
void	clearWarnings() Clears all the warning reported by this Interaction instance.
O	execute(javax.resource.cci.InteractionSpec ispec, I input) Executes the EIS function with the specified input.
boolean	execute(javax.resource.cci.InteractionSpec ispec, I input, O output) Executes the EIS function with the specified input and output.
javax.resource.cci.ResourceWarning	getWarnings() Gets the first ResourceWarning from the chain of warnings associated with this Interaction instance.

Method Detail

execute

boolean execute(javax.resource.cci.InteractionSpec ispec,
                I input,
                O output)

Executes the EIS function with the specified input and output.

Parameters:

ispec - the properties driving the interaction.

input - the input object.

output - the output object.

Returns:

true if the interaction has succeeded, false otherwise.

execute

O execute(javax.resource.cci.InteractionSpec ispec,
          I input)

Executes the EIS function with the specified input.

Parameters:

ispec - the properties driving the interaction.

input - the input object.

Returns:

the output object.

getWarnings

javax.resource.cci.ResourceWarning getWarnings()

Gets the first ResourceWarning from the chain of warnings associated with this Interaction instance.

Returns:

the first warning of the chain.

clearWarnings

void clearWarnings()

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.