javax.resource.spi
Class ConnectionEvent

java.lang.Object
  java.util.EventObject
      javax.resource.spi.ConnectionEvent

All Implemented Interfaces:

java.io.Serializable

public class ConnectionEvent

extends java.util.EventObject

The ConnectionEvent class provides information about the source of a Connection related event. A ConnectionEvent contains:

• Type of connection event.
• Managed connection instance that generated the event.
• Connection handle associated with the managed connection.
• Optionally an exception indicating an error.

This class is used for the following types of notifications:

• Connection closed
• Local transaction started
• Local transaction commited
• Local transaction rolled back
• Connection error occurred

See Also:

Serialized Form

CONNECTION_CLOSED

public static final int CONNECTION_CLOSED

Connection has been closed

See Also:

Constant Field Values (src)

LOCAL_TRANSACTION_STARTED

public static final int LOCAL_TRANSACTION_STARTED

Local transaction has been started

See Also:

Constant Field Values (src)

LOCAL_TRANSACTION_COMMITTED

public static final int LOCAL_TRANSACTION_COMMITTED

Local transaction has been committed

See Also:

Constant Field Values (src)

LOCAL_TRANSACTION_ROLLEDBACK

public static final int LOCAL_TRANSACTION_ROLLEDBACK

Local transaction has been rolled back

See Also:

Constant Field Values (src)

CONNECTION_ERROR_OCCURRED

public static final int CONNECTION_ERROR_OCCURRED

Connection error has occurred

See Also:

Constant Field Values (src)

id

protected int id

Type of event

ConnectionEvent

public ConnectionEvent(ManagedConnection (src)  source,
                       int eid)

Create a new ConnectionEvent

Parameters:

source - the source of the event

eid - the event id

ConnectionEvent

public ConnectionEvent(ManagedConnection (src)  source,
                       int eid,
                       java.lang.Exception exception)

Create a new ConnectionEvent

Parameters:

source - the source of the event

eid - the event id

exception - the exception associated with the event

getId

public int getId()

Get the event type

Returns:

the event id

getException

public java.lang.Exception getException()

Get the exception

Returns:

the exception

setConnectionHandle

public void setConnectionHandle(java.lang.Object connectionHandle)

Set the ConnectionHandle

Parameters:

connectionHandle - the connection handle

getConnectionHandle

public java.lang.Object getConnectionHandle()

Get the ConnectionHandle

Returns:

the connection handle