Package org.apache.openjpa.lib.jdbc

Class JDBCEvent

java.lang.Object

java.util.EventObject

org.apache.openjpa.lib.jdbc.JDBCEvent

All Implemented Interfaces:

Serializable

public class JDBCEvent
extends EventObject

A JDBC event. The event source will be the connection.

Author:

Marc Prud'hommeaux, Abe White

See Also:

• JDBCListener
• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final short	AFTER_COMMIT	Type code indicating that a Connection was just committed.
static final short	AFTER_CONNECT	Type code indicating that a connection was obtained.
static final short	AFTER_CREATE_STATEMENT	Type code indicating that a Statement is being created.
static final short	AFTER_EXECUTE_STATEMENT	Type code indicating that a Statement completed execution.
static final short	AFTER_PREPARE_STATEMENT	Type code indicating that a Statement is being prepared.
static final short	AFTER_ROLLBACK	Type code indicating that a rollback just occured.
static final short	BEFORE_CLOSE	Type code indicating that a connection was closed.
static final short	BEFORE_COMMIT	Type code indicating that a Connection is about to be committed.
static final short	BEFORE_CREATE_STATEMENT	Type code indicating that a Statement is being created.
static final short	BEFORE_EXECUTE_STATEMENT	Type code indicating that a Statement is about to be executed.
static final short	BEFORE_PREPARE_STATEMENT	Type code indicating that a Statement is being prepared.
static final short	BEFORE_ROLLBACK	Type code indicating that a rollback is about to occur.

Fields inherited from class java.util.EventObject

source

Constructor Summary

Constructors

Constructor	Description
JDBCEvent(Connection source, short type, JDBCEvent associatedEvent, Statement statement, String sql)	Constructor.

Method Summary

Modifier and Type	Method	Description
final JDBCEvent	getAssociatedEvent()	Return the associated JDBCEvent for this event.
final Connection	getConnection()	Return the Connection for this event.
final String	getSQL()	Return the SQL associated with this event; may be null.
final Statement	getStatement()	Return the Statement for this event, may be null for events unrelated to Statement execution.
final long	getTime()	Return the time the event was constructed.
final short	getType()	Return the event's type code.

Methods inherited from class java.util.EventObject

getSource, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

BEFORE_PREPARE_STATEMENT

public static final short BEFORE_PREPARE_STATEMENT

Type code indicating that a Statement is being prepared.

See Also:

• Constant Field Values

AFTER_PREPARE_STATEMENT

public static final short AFTER_PREPARE_STATEMENT

Type code indicating that a Statement is being prepared.

See Also:

• Constant Field Values

BEFORE_CREATE_STATEMENT

public static final short BEFORE_CREATE_STATEMENT

Type code indicating that a Statement is being created.

See Also:

• Constant Field Values

AFTER_CREATE_STATEMENT

public static final short AFTER_CREATE_STATEMENT

Type code indicating that a Statement is being created.

See Also:

• Constant Field Values

BEFORE_EXECUTE_STATEMENT

public static final short BEFORE_EXECUTE_STATEMENT

Type code indicating that a Statement is about to be executed.

See Also:

• Constant Field Values

AFTER_EXECUTE_STATEMENT

public static final short AFTER_EXECUTE_STATEMENT

Type code indicating that a Statement completed execution.

See Also:

• Constant Field Values

BEFORE_COMMIT

public static final short BEFORE_COMMIT

Type code indicating that a Connection is about to be committed.

See Also:

• Constant Field Values

AFTER_COMMIT

public static final short AFTER_COMMIT

Type code indicating that a Connection was just committed.

See Also:

• Constant Field Values

BEFORE_ROLLBACK

public static final short BEFORE_ROLLBACK

Type code indicating that a rollback is about to occur.

See Also:

• Constant Field Values

AFTER_ROLLBACK

public static final short AFTER_ROLLBACK

Type code indicating that a rollback just occured.

See Also:

• Constant Field Values

AFTER_CONNECT

public static final short AFTER_CONNECT

Type code indicating that a connection was obtained. This does not necessarily mean that the connection is new if pooling is enabled.

See Also:

• Constant Field Values

BEFORE_CLOSE

public static final short BEFORE_CLOSE

Type code indicating that a connection was closed. This does not necessarily mean that the underlying database connection was severed if pooling is enabled.

See Also:

• Constant Field Values

Constructor Details

JDBCEvent

public JDBCEvent(Connection source,
 short type,
 JDBCEvent associatedEvent,
 Statement statement,
 String sql)

Constructor.

Method Details

getType

public final short getType()

Return the event's type code.

getConnection

public final Connection getConnection()

Return the Connection for this event.

getTime

public final long getTime()

Return the time the event was constructed.

getAssociatedEvent

public final JDBCEvent getAssociatedEvent()

Return the associated JDBCEvent for this event. For AFTER_XXX events, this will typically be the JDBCEvent that was created in the BEFORE_XXX stage. This may be null when an association is not appropriate for the event.

getSQL

public final String getSQL()

Return the SQL associated with this event; may be null.

getStatement

public final Statement getStatement()

Return the Statement for this event, may be null for events unrelated to Statement execution.