- 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. TheConnectionEvent
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
Constructors Constructor Description ConnectionEvent(PooledConnection con)
Constructs aConnectionEvent
object initialized with the givenPooledConnection
object.ConnectionEvent(PooledConnection con, SQLException ex)
Constructs aConnectionEvent
object initialized with the givenPooledConnection
object andSQLException
object.
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description SQLException
getSQLException()
Retrieves theSQLException
for thisConnectionEvent
object.Methods declared in class java.util.EventObject
getSource, toString
Constructor Detail
ConnectionEvent
public ConnectionEvent(PooledConnection con)
Constructs a
ConnectionEvent
object initialized with the givenPooledConnection
object.SQLException
defaults tonull
.- 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 givenPooledConnection
object andSQLException
object.- Parameters:
con
- the pooled connection that is the source of the eventex
- the SQLException about to be thrown to the application- Throws:
IllegalArgumentException
- ifcon
is null.
Method Detail
getSQLException
public SQLException getSQLException()
Retrieves the
SQLException
for thisConnectionEvent
object. May benull
.- Returns:
- the SQLException about to be thrown or
null