org.apache.derby.jdbc
Class EmbedPooledConnection40

java.lang.Object
  org.apache.derby.jdbc.EmbedPooledConnection
      org.apache.derby.jdbc.EmbedPooledConnection40

All Implemented Interfaces:

javax.sql.PooledConnection, BrokeredConnectionControl

 class EmbedPooledConnection40
extends EmbedPooledConnection

A PooledConnection object is a connection object that provides hooks for connection pool management.

This is Derby's implementation of a PooledConnection for use in the following environments:

• JDBC 4.0 - J2SE 6.0

Field Summary

private java.util.concurrent.CopyOnWriteArrayList<javax.sql.StatementEventListener>

statementEventListeners List of statement event listeners.

Fields inherited from class org.apache.derby.jdbc.EmbedPooledConnection

currentConnectionHandle, dataSource, defaultIsolationLevel, isActive, realConnection

Constructor Summary

EmbedPooledConnection40(EmbeddedBaseDataSource ds, java.lang.String user, java.lang.String password, boolean requestPassword)

Method Summary

void	addStatementEventListener(javax.sql.StatementEventListener listener) Registers a StatementEventListener with this PooledConnection object.
void	onStatementClose(java.sql.PreparedStatement statement) Raise the statementClosed event for all the listeners when the corresponding events occurs
void	onStatementErrorOccurred(java.sql.PreparedStatement statement, java.sql.SQLException sqle) Raise the statementErrorOccurred event for all the listeners when the corresponding events occurs
void	removeStatementEventListener(javax.sql.StatementEventListener listener) Removes the specified StatementEventListener from the list of components that will be notified when the driver detects that a PreparedStatement has been closed or is invalid.

Methods inherited from class org.apache.derby.jdbc.EmbedPooledConnection

addConnectionEventListener, checkActive, checkAutoCommit, checkClose, checkCommit, checkHoldCursors, checkRollback, checkSavepoint, close, closingConnection, getConnection, getLanguageConnection, getNewCurrentConnectionHandle, getPassword, getRealConnection, getUsername, isActive, isInGlobalTransaction, isIsolationLevelSetUsingSQLorJDBC, notifyError, notifyException, openRealConnection, removeConnectionEventListener, resetIsolationLevelFlag, resetRealConnection, toString, wrapStatement, wrapStatement, wrapStatement

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

statementEventListeners

private final java.util.concurrent.CopyOnWriteArrayList<javax.sql.StatementEventListener> statementEventListeners

List of statement event listeners. The list is copied on each write, ensuring that it can be safely iterated over even if other threads or the listeners fired in the same thread add or remove listeners.

Constructor Detail

EmbedPooledConnection40

EmbedPooledConnection40(EmbeddedBaseDataSource ds,
                        java.lang.String user,
                        java.lang.String password,
                        boolean requestPassword)
                  throws java.sql.SQLException

Throws:

java.sql.SQLException

Method Detail

removeStatementEventListener

public void removeStatementEventListener(javax.sql.StatementEventListener listener)

Removes the specified StatementEventListener from the list of components that will be notified when the driver detects that a PreparedStatement has been closed or is invalid.

Parameters:

listener - the component which implements the StatementEventListener interface that was previously registered with this PooledConnection object

Since:

1.6

addStatementEventListener

public void addStatementEventListener(javax.sql.StatementEventListener listener)

Registers a StatementEventListener with this PooledConnection object. Components that wish to be notified when PreparedStatements created by the connection are closed or are detected to be invalid may use this method to register a StatementEventListener with this PooledConnection object.

Parameters:

listener - an component which implements the StatementEventListener interface that is to be registered with this PooledConnection object

Since:

1.6

onStatementClose

public void onStatementClose(java.sql.PreparedStatement statement)

Raise the statementClosed event for all the listeners when the corresponding events occurs

Specified by:

onStatementClose in interface BrokeredConnectionControl

Overrides:

onStatementClose in class EmbedPooledConnection

Parameters:

statement - PreparedStatement

onStatementErrorOccurred

public void onStatementErrorOccurred(java.sql.PreparedStatement statement,
                                     java.sql.SQLException sqle)

Raise the statementErrorOccurred event for all the listeners when the corresponding events occurs

Specified by:

onStatementErrorOccurred in interface BrokeredConnectionControl

Overrides:

onStatementErrorOccurred in class EmbedPooledConnection

Parameters:

statement - PreparedStatement

sqle - SQLException