Java™ Platform
Standard Ed. 6

javax.sql
Class StatementEvent

java.lang.Object
  extended by java.util.EventObject
      extended by javax.sql.StatementEvent
All Implemented Interfaces:
Serializable

public class StatementEvent
extends EventObject

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.

Since:
1.6
See Also:
Serialized Form

Field Summary
 
Fields inherited from class java.util.EventObject
source
 
Constructor Summary
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
 
Method Summary
 SQLException getSQLException()
          Returns the SQLException the driver is about to throw
 PreparedStatement getStatement()
          Returns the PreparedStatement that is being closed or is invalid
 
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
 

Constructor Detail

StatementEvent

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 - The PooledConnection that the closed or invalid PreparedStatementis associated with.
statement - The PreparedStatement that is bieng closed or is invalid

Throws:
IllegalArgumentException - if con is null.
Since:
1.6

StatementEvent

public StatementEvent(PooledConnection con,
                      PreparedStatement statement,
                      SQLException exception)
Constructs a StatementEvent with the specified PooledConnection, PreparedStatement and SQLException

Parameters:
con - The PooledConnection that the closed or invalid PreparedStatement is associated with.
statement - The PreparedStatement that is being closed or is invalid
exception - The SQLException the driver is about to throw to the application
Throws:
IllegalArgumentException - if con is null.

Since:
1.6
Method Detail

getStatement

public PreparedStatement getStatement()
Returns the PreparedStatement that is being closed or is invalid

Returns:
The PreparedStatement that is being closed or is invalid

Since:
1.6

getSQLException

public SQLException getSQLException()
Returns the SQLException the driver is about to throw

Returns:
The SQLException the driver is about to throw

Since:
1.6

Java™ Platform
Standard Ed. 6

Submit a bug or feature
For further API reference and developer documentation, see Java SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.