com.ibm.websphere.j2c

Interface ConnectionEventListener

All Superinterfaces:
javax.resource.spi.ConnectionEventListener, java.util.EventListener, InteractionMetrics

Deprecated. As of WAS 6.0, the functionality of this interface is replaced by J2EE Connector Architecture 1.5. Please reference javax.resource.spi.LazyEnlistableConnectionManager.
  1. public interface ConnectionEventListener
  2. extends javax.resource.spi.ConnectionEventListener, InteractionMetrics
ConnectionEventListener extends the javax.resource.spi.ConnectionEventListener to add support for deferred enlistment. Deferred enlistment is enabled by adding a new event to the ConnectionEventListener (interactionPending) which is used to indicate that a connection should be enlisted in a transaction.

This interface also extends the InteractionMetrics interface. The reason this extends the InteractionMetrics interface is so that any ResouceAdapter can report usage statics on a per connection basis and participate in WebSphere's Request Metrics tracking and in advanced diagnostic information support.

See Also:
JCAPaper

Field Summary

Modifier and Type Field and Description
  1. static
  2. int
INTERACTION_PENDING
Deprecated. Identifier for the interactionPending event.
Fields inherited from interface com.ibm.websphere.j2c.InteractionMetrics
RM_ARM_ABORT, RM_ARM_FAILED, RM_ARM_GOOD, RM_ARM_UNKNOWN, TRAN_DETAIL_LEVEL_BASIC, TRAN_DETAIL_LEVEL_EXTENDED, TRAN_DETAIL_LEVEL_PERF

Method Summary

Modifier and Type Method and Description
  1. void
interactionPending(javax.resource.spi.ConnectionEvent connectionevent)
Deprecated. Method interactionPending is used to signal that a ManagedConnection needs to be enlisted in a transaction - this should happen just prior to when work is performed on the back end.
Methods inherited from interface javax.resource.spi.ConnectionEventListener
connectionClosed, connectionErrorOccurred, localTransactionCommitted, localTransactionRolledback, localTransactionStarted
Methods inherited from interface com.ibm.websphere.j2c.InteractionMetrics
getCorrelator, getTranDetailLevel, isInteractionMetricsEnabled, postInteraction, postInteraction, preInteraction

Field Detail

INTERACTION_PENDING

  1. static final int INTERACTION_PENDING
Deprecated.
Identifier for the interactionPending event.
See Also:

Method Detail

interactionPending

  1. void interactionPending(javax.resource.spi.ConnectionEvent connectionevent)
  2. throws javax.resource.ResourceException
Deprecated.
Method interactionPending is used to signal that a ManagedConnection needs to be enlisted in a transaction - this should happen just prior to when work is performed on the back end.
Parameters:
connectionevent - This should be an interactionPending event with the identifier defined in this class. The ManagedConnection to be enlisted should be included in the event.
Throws:
javax.resource.ResourceException - if an error occurs when enlisting the ManagedConnection.