javax.sql

Class 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 Detail

      • 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 Detail

      • getSQLException

        public SQLException getSQLException()

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

        Returns:
        the SQLException about to be thrown or null