Module java.sql
Package javax.sql

Class ConnectionEvent

java.lang.Object
java.util.EventObject
javax.sql.ConnectionEvent
All Implemented Interfaces:
Serializable

public class ConnectionEvent
extends EventObject

An Event object that provides information about the source of a connection-related event. ConnectionEvent objects are generated when an application closes a pooled connection and when an error occurs. The ConnectionEvent object contains two kinds of information:

  • The pooled connection closed by the application
  • In the case of an error event, the SQLException about to be thrown to the application
Since:
1.4
See Also:
Serialized Form
  • Constructor Details

    • ConnectionEvent

      public ConnectionEvent​(PooledConnection con)

      Constructs a ConnectionEvent object initialized with the given PooledConnection object. SQLException defaults to null.

      Parameters:
      con - the pooled connection that is the source of the event
      Throws:
      IllegalArgumentException - if con is null.
    • ConnectionEvent

      public ConnectionEvent​(PooledConnection con, SQLException ex)

      Constructs a ConnectionEvent object initialized with the given PooledConnection object and SQLException object.

      Parameters:
      con - the pooled connection that is the source of the event
      ex - the SQLException about to be thrown to the application
      Throws:
      IllegalArgumentException - if con is null.
  • Method Details

    • getSQLException

      public SQLException getSQLException()

      Retrieves the SQLException for this ConnectionEvent object. May be null.

      Returns:
      the SQLException about to be thrown or null