IBM WebSphere Application ServerTM
Release 7

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.

public interface ConnectionEventListener
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
static 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
 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

static final int INTERACTION_PENDING
Deprecated. 
Identifier for the interactionPending event.

See Also:
Constant Field Values
Method Detail

interactionPending

void interactionPending(javax.resource.spi.ConnectionEvent connectionevent)
                        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.

IBM WebSphere Application ServerTM
Release 7