Class ConnectionEvent
- 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 inherited from class java.util.EventObject
source
-
-
Constructor Summary
Constructors Constructor and 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 and Description SQLExceptiongetSQLException()Retrieves theSQLExceptionfor thisConnectionEventobject.-
Methods inherited from 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 event -
ex- 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
-
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.
