ConnectionEvent

AI-generated Key Takeaways

• ConnectionEvent objects provide information about connection-related events, such as closing a pooled connection or encountering an error.

• These events contain details about the pooled connection and any associated SQLException.

• ConnectionEvent objects are constructed with a PooledConnection object and optionally an SQLException.

• The getSQLException method retrieves the SQLException associated with the event, which may be null.

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

Inherited Field Summary

From class java.util.EventObject

protected Object

source

The object on which the Event initially occurred.

Public Constructor Summary

	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.

Public Method Summary

SQLException

getSQLException() Retrieves the SQLException for this ConnectionEvent object.

Inherited Method Summary

From class java.util.EventObject

Object	getSource() The object on which the Event initially occurred.
String	toString() Returns a String representation of this EventObject.

From class java.lang.Object

Object	clone() Creates and returns a copy of this Object.
boolean	equals(Object obj) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of Class that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait(long timeout, int nanos) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires.
final void	wait(long timeout) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires.
final void	wait() Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object.

Public Constructors

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.

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.

Public Methods

public SQLException getSQLException ()

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

Returns

• the SQLException about to be thrown or null