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

Fields

Fields inherited from class java.util.EventObject

source

Constructors

Constructor and Description
`ConnectionEvent(PooledConnection con)` Constructs a `ConnectionEvent` object initialized with the given `PooledConnection` object.
`ConnectionEvent(PooledConnection con, SQLException ex)` Constructs a `ConnectionEvent` object initialized with the given `PooledConnection` object and `SQLException` object.

Methods

Modifier and Type	Method and Description
`SQLException`	`getSQLException()` Retrieves the `SQLException` for this `ConnectionEvent` object.

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

Constructors

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.

Methods

getSQLException

public SQLException getSQLException()

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

Returns:: the SQLException about to be thrown or null

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/javase/8/docs/api/javax/sql/ConnectionEvent.html