- java.lang.Object
-
- java.util.EventObject
-
- javax.sql.ConnectionEvent
-
- All Implemented Interfaces:
Serializable
public class ConnectionEvent extends EventObject
An
Eventobject that provides information about the source of a connection-related event.ConnectionEventobjects are generated when an application closes a pooled connection and when an error occurs. TheConnectionEventobject contains two kinds of information:- The pooled connection closed by the application
- In the case of an error event, the
SQLExceptionabout to be thrown to the application
- Since:
- 1.4
- See Also:
- Serialized Form
-
-
Field Summary
-
Fields declared in class java.util.EventObject
source
-
-
Constructor Summary
Constructors Constructor Description ConnectionEvent(PooledConnection con)Constructs aConnectionEventobject initialized with the givenPooledConnectionobject.ConnectionEvent(PooledConnection con, SQLException ex)Constructs aConnectionEventobject initialized with the givenPooledConnectionobject andSQLExceptionobject.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description SQLExceptiongetSQLException()Retrieves theSQLExceptionfor thisConnectionEventobject.-
Methods declared in class java.util.EventObject
getSource, toString
-
-
-
-
Constructor Detail
-
ConnectionEvent
public ConnectionEvent(PooledConnection con)
Constructs a
ConnectionEventobject initialized with the givenPooledConnectionobject.SQLExceptiondefaults tonull.- Parameters:
con- the pooled connection that is the source of the event- Throws:
IllegalArgumentException- ifconis null.
-
ConnectionEvent
public ConnectionEvent(PooledConnection con, SQLException ex)
Constructs a
ConnectionEventobject initialized with the givenPooledConnectionobject andSQLExceptionobject.- Parameters:
con- the pooled connection that is the source of the eventex- the SQLException about to be thrown to the application- Throws:
IllegalArgumentException- ifconis null.
-
-
Method Detail
-
getSQLException
public SQLException getSQLException()
Retrieves the
SQLExceptionfor thisConnectionEventobject. May benull.- Returns:
- the SQLException about to be thrown or
null
-
-