javax.sql: public class: ConnectionEvent

javax.sql
public class: ConnectionEvent [javadoc | source]

java.lang.Object
   java.util.EventObject
      javax.sql.ConnectionEvent

All Implemented Interfaces:
Serializable

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 -

Field Summary
static final long	serialVersionUID	Private serial version unique ID to ensure serialization compatibility.

Fields inherited from java.util.EventObject:
source

Constructor:

Constructor:
public ConnectionEvent(PooledConnection con) { super(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) { super(con); this.ex = 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 ConnectionEvent(PooledConnection con) {
    super(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) {
    super(con);
    this.ex = 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.

Method from javax.sql.ConnectionEvent Summary:
getSQLException

Methods from java.util.EventObject:
getSource, toString

Methods from java.lang.Object:
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from javax.sql.ConnectionEvent Detail:
public SQLException getSQLException() { return ex; } Retrieves the `SQLException` for this `ConnectionEvent` object. May be `null`.

Method from javax.sql.ConnectionEvent Detail:

 public SQLException getSQLException() {
 return ex;
}

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