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
Field Summary
Fields declared in class java.util.EventObject
source
Constructor Summary
Constructor | Description |
---|---|
ConnectionEvent(PooledConnection con) | Constructs a |
ConnectionEvent(PooledConnection con,
SQLException ex) | Constructs a |
Method Summary
Modifier and Type | Method | Description |
---|---|---|
SQLException | getSQLException() | Retrieves the |
Methods declared in class java.util.EventObject
getSource, toString
Methods declared in class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
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
- ifcon
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
- ifcon
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