StatementEvent

public class StatementEvent
extends EventObject

java.lang.Object
   ↳ java.util.EventObject
     ↳ javax.sql.StatementEvent


A StatementEvent is sent to all StatementEventListeners which were registered with a PooledConnection. This occurs when the driver determines that a PreparedStatement that is associated with the PooledConnection has been closed or the driver determines is invalid.

Summary

Inherited fields

protected Object source

The object on which the Event initially occurred.

Public constructors

StatementEvent(PooledConnection con, PreparedStatement statement)

Constructs a StatementEvent with the specified PooledConnection and PreparedStatement.

StatementEvent(PooledConnection con, PreparedStatement statement, SQLException exception)

Constructs a StatementEvent with the specified PooledConnection, PreparedStatement and SQLException

Public methods

SQLException getSQLException()

Returns the SQLException the driver is about to throw

PreparedStatement getStatement()

Returns the PreparedStatement that is being closed or is invalid

Inherited methods

Object getSource()

The object on which the Event initially occurred.

String toString()

Returns a String representation of this EventObject.

Object clone()

Creates and returns a copy of this object.

boolean equals(Object obj)

Indicates whether some other object is "equal to" this one.

void finalize()

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.

final Class<?> getClass()

Returns the runtime class of this Object.

int hashCode()

Returns a hash code value for the object.

final void notify()

Wakes up a single thread that is waiting on this object's monitor.

final void notifyAll()

Wakes up all threads that are waiting on this object's monitor.

String toString()

Returns a string representation of the object.

final void wait(long timeoutMillis, int nanos)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait(long timeoutMillis)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait()

Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Public constructors

StatementEvent

Added in API level 9
public StatementEvent (PooledConnection con, 
                PreparedStatement statement)

Constructs a StatementEvent with the specified PooledConnection and PreparedStatement. The SQLException contained in the event defaults to null.

Parameters
con PooledConnection: The PooledConnection that the closed or invalid PreparedStatementis associated with.

statement PreparedStatement: The PreparedStatement that is bieng closed or is invalid

Throws
IllegalArgumentException if con is null.

StatementEvent

Added in API level 9
public StatementEvent (PooledConnection con, 
                PreparedStatement statement, 
                SQLException exception)

Constructs a StatementEvent with the specified PooledConnection, PreparedStatement and SQLException

Parameters
con PooledConnection: The PooledConnection that the closed or invalid PreparedStatement is associated with.

statement PreparedStatement: The PreparedStatement that is being closed or is invalid

exception SQLException: The SQLException the driver is about to throw to the application

Throws
IllegalArgumentException if con is null.

Public methods

getSQLException

Added in API level 9
public SQLException getSQLException ()

Returns the SQLException the driver is about to throw

Returns
SQLException The SQLException the driver is about to throw

getStatement

Added in API level 9
public PreparedStatement getStatement ()

Returns the PreparedStatement that is being closed or is invalid

Returns
PreparedStatement The PreparedStatement that is being closed or is invalid