Class StatementEvent

java.lang.Object
java.util.EventObject
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:

  • Field Summary

    Fields declared in class EventObject

    source
    Modifier and Type
    Field
    Description
    protected Object
    source
    The object on which the Event initially occurred.

  • Constructor Summary

    Constructors
    Constructor
    Description
    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

    Modifier and Type
    Method
    Description
    SQLException
    getSQLException()
    Returns the SQLException the driver is about to throw
    PreparedStatement
    getStatement()
    Returns the PreparedStatement that is being closed or is invalid

    Methods declared in class EventObject

    getSource, toString
    Modifier and Type
    Method
    Description
    Object
    getSource()
    The object on which the Event initially occurred.
    String
    toString()
    Returns a String representation of this EventObject.

    Methods declared in class Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    Modifier and Type
    Method
    Description
    protected Object
    clone()
    Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
    boolean
    equals(Object o)
    Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
    protected void
    finalize()
    Deprecated, for removal: This API element is subject to removal in a future version.
    May cause performance issues, deadlocks and hangs.
    final Class<? extends Object>
    getClass()
    Answers the unique instance of java.lang.Class which represents the class of the receiver.
    int
    hashCode()
    Answers an integer hash code for the receiver.
    final void
    notify()
    Causes one thread which is waiting on the receiver to be made ready to run.
    final void
    notifyAll()
    Causes all threads which are waiting on the receiver to be made ready to run.
    final void
    wait()
    Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
    final void
    wait(long time)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
    final void
    wait(long time, int frac)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

  • Constructor Details

    • 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 being 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 Details

    • 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