Apache Derby Database Engine and Embedded JDBC Driver 10.17.1.0 · org.apache.derby.impl.jdbc.EmbedPooledConnection

Modifier and Type	Field and Description
private String	connString the connection string
pack-priv BrokeredConnection	currentConnectionHandle
pack-priv final EmbeddedDataSourceInterface	dataSource
pack-priv int	defaultIsolationLevel
private boolean	defaultReadOnly
private int	eventIterators The number of iterators going through the list of connection event listeners at the current time.
private ArrayList<ConnectionEventListener>	eventListener The list of `ConnectionEventListener`s.
protected boolean	isActive
private final String	password
pack-priv EmbedConnection	realConnection
private final boolean	requestPassword True if the password was passed in on the connection request, false if it came from the data source property.
private final CopyOnWriteArrayList<StatementEventListener>	statementEventListeners List of statement event listeners.
private final String	username

Access	Constructor and Description
public	EmbedPooledConnection(EmbeddedDataSourceInterface ds, String u, String p, boolean requestPassword)

Method Summary

Modifier and Type	Method and Description
public final synchronized void	addConnectionEventListener(ConnectionEventListener a component, usually the connection pool manager, that has implemented the `ConnectionEventListener` interface and wants to be notified when the connection is closed or has an error listener) Implements javax.sql.PooledConnection.addConnectionEventListener. Add an event listener.
public void	addStatementEventListener(StatementEventListener an component which implements the `StatementEventListener` interface that is to be registered with this `PooledConnection` object listener) Implements javax.sql.PooledConnection.addStatementEventListener. Registers a `StatementEventListener` with this `PooledConnection` object.
pack-priv final void	checkActive()
public void	checkAutoCommit(boolean New auto commit setting autoCommit) Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkAutoCommit. Allow control over setting auto commit mode.
public void	checkClose() Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkClose. Check if the brokered connection can be closed.
public void	checkCommit() Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkCommit. Allow control over calling commit.
public int	checkHoldCursors(int Current holdability holdability, boolean true to downgrade the holdability, false to throw an exception. downgrade) Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkHoldCursors. Are held cursors allowed.
public void	checkRollback() Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkRollback. Allow control over calling rollback.
public void	checkSavepoint() Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkSavepoint. Allow control over creating a Savepoint (JDBC 3.0)
public synchronized void	close() Implements javax.sql.PooledConnection.close. Close the Pooled connection.
private void	closeCurrentConnectionHandle() In this case the Listeners are not notified.
public synchronized boolean	closingConnection() Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.closingConnection. Close called on BrokeredConnection.
private void	fireConnectionEventListeners(SQLException the exception that caused the event, or `null` if it is a close event exception) Fire all the `ConnectionEventListener`s registered.
public synchronized Connection	Returns: a Connection object getConnection() Implements javax.sql.PooledConnection.getConnection. Create an object handle for a database connection.
public synchronized LanguageConnectionContext	Returns: The underlying language connection. getLanguageConnection()
private static LanguageConnectionContext	getLanguageConnectionContext(final EmbedConnection conn) Gets the LanguageConnectionContext for this connection.
pack-priv final Connection	getNewCurrentConnectionHandle()
pack-priv String	getPassword()
public synchronized EngineConnection	getRealConnection() Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.getRealConnection. Return the real JDBC connection for the brokered connection.
pack-priv String	getUsername()
public boolean	Returns: boolean is isActive is true isActive() getter function for isActive
public boolean	isInGlobalTransaction() Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.isInGlobalTransaction. Is this a global transaction
public boolean	isIsolationLevelSetUsingSQLorJDBC() Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.isIsolationLevelSetUsingSQLorJDBC. Returns true if isolation level has been set using either JDBC api or SQL
public synchronized void	notifyError(SQLException exception)
public void	notifyException(SQLException A sql exception sqle) Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.notifyException. Notify the control class that a SQLException was thrown during a call on one of the brokered connection's methods.
public void	onStatementClose(PreparedStatement the `PreparedStatement` that was closed statement) Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.onStatementClose. Raise the statementClosed event for all the listeners when the corresponding events occurs
public void	onStatementErrorOccurred(PreparedStatement the `PreparedStatement` in which the error occurred statement, SQLException the `SQLException` that was thrown sqle) Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.onStatementErrorOccurred. Raise the statementErrorOccurred event for all the listeners when the corresponding events occurs
pack-priv final void	openRealConnection()
public final synchronized void	removeConnectionEventListener(ConnectionEventListener a component, usually the connection pool manager, that has implemented the `ConnectionEventListener` interface and been registered with this `PooledConnection` object as a listener listener) Implements javax.sql.PooledConnection.removeConnectionEventListener. Remove an event listener.
public void	removeStatementEventListener(StatementEventListener the component which implements the `StatementEventListener` interface that was previously registered with this `PooledConnection` object listener) Implements javax.sql.PooledConnection.removeStatementEventListener. 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.
public void	resetIsolationLevelFlag() Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.resetIsolationLevelFlag. Reset the isolation level flag used to keep state in BrokeredConnection.
pack-priv void	resetRealConnection()
public String	Returns: a string representation of the uniquie id for this pooled connection. toString() Overrides java.lang.Object.toString. Get the string representation of this pooled connection.
public Statement	wrapStatement(Statement The original statement s) Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.wrapStatement. No need to wrap statements for PooledConnections.
public PreparedStatement	Returns: returns the wrapped PreparedStatement wrapStatement(PreparedStatement PreparedStatment to be wrapped ps, String String sql, Object Object generatedKeys) Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.wrapStatement. Call the setBrokeredConnectionControl method inside the EmbedPreparedStatement class to set the BrokeredConnectionControl variable to this instance of EmbedPooledConnection This will then be used to call the onStatementErrorOccurred and onStatementClose events when the corresponding events occur on the PreparedStatement
public CallableStatement	Returns: returns the wrapped CallableStatement wrapStatement(CallableStatement CallableStatment to be wrapped cs, String String sql) Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.wrapStatement. Call the setBrokeredConnectionControl method inside the EmbedCallableStatement class to set the BrokeredConnectionControl variable to this instance of EmbedPooledConnection This will then be used to call the onStatementErrorOccurred and onStatementClose events when the corresponding events occur on the CallableStatement

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll wait wait wait

connString	back to summary
private String connString the connection string

currentConnectionHandle	back to summary
pack-priv BrokeredConnection currentConnectionHandle

dataSource	back to summary
pack-priv final EmbeddedDataSourceInterface dataSource

defaultIsolationLevel	back to summary
pack-priv int defaultIsolationLevel

defaultReadOnly	back to summary
private boolean defaultReadOnly

eventIterators	back to summary
private int eventIterators The number of iterators going through the list of connection event listeners at the current time. Only one thread may be iterating over the list at any time (because of synchronization), but a single thread may have multiple iterators if for instance an event listener performs database calls that trigger a new event.

eventListener	back to summary
private ArrayList<ConnectionEventListener> eventListener The list of `ConnectionEventListener`s. It is initially `null` and will be initialized lazily when the first listener is added.

isActive	back to summary
protected boolean isActive

password	back to summary
private final String password

realConnection	back to summary
pack-priv EmbedConnection realConnection

requestPassword	back to summary
private final boolean requestPassword True if the password was passed in on the connection request, false if it came from the data source property.

statementEventListeners	back to summary
private final CopyOnWriteArrayList<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.

username	back to summary
private final String username

EmbedPooledConnection	back to summary
public EmbedPooledConnection(EmbeddedDataSourceInterface ds, String u, String p, boolean requestPassword) throws SQLException

Method Detail

addConnectionEventListener back to summary

addConnectionEventListener	back to summary
public final synchronized void addConnectionEventListener(ConnectionEventListener listener) Implements javax.sql.PooledConnection.addConnectionEventListener. Add an event listener. Parameters listener:ConnectionEventListener Doc from javax.sql.PooledConnection.addConnectionEventListener. a component, usually the connection pool manager, that has implemented the `ConnectionEventListener` interface and wants to be notified when the connection is closed or has an error

public final synchronized void addConnectionEventListener(ConnectionEventListener listener)

Implements javax.sql.PooledConnection.addConnectionEventListener.

Add an event listener.

Parameters

listener:ConnectionEventListener

Doc from javax.sql.PooledConnection.addConnectionEventListener.

a component, usually the connection pool manager, that has implemented the ConnectionEventListener interface and wants to be notified when the connection is closed or has an error

addStatementEventListener back to summary

addStatementEventListener	back to summary
public void addStatementEventListener(StatementEventListener listener) Implements javax.sql.PooledConnection.addStatementEventListener. Registers a `StatementEventListener` with this `PooledConnection` object. Components that wish to be notified when `PreparedStatement`s 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:StatementEventListener an component which implements the `StatementEventListener` interface that is to be registered with this `PooledConnection` object

public void addStatementEventListener(StatementEventListener listener)

Implements javax.sql.PooledConnection.addStatementEventListener.

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:StatementEventListener: an component which implements the StatementEventListener interface that is to be registered with this PooledConnection object

checkActive	back to summary
pack-priv final void checkActive() throws SQLException

checkAutoCommit	back to summary
public void checkAutoCommit(boolean autoCommit) throws SQLException Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkAutoCommit. Allow control over setting auto commit mode. Parameters autoCommit:boolean Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkAutoCommit. New auto commit setting Exceptions SQLException: Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkAutoCommit. on error

checkAutoCommit

back to summary

public void checkAutoCommit(boolean autoCommit) throws SQLException

Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkAutoCommit.

Allow control over setting auto commit mode.

Parameters

autoCommit:boolean

Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkAutoCommit.

New auto commit setting

Exceptions

SQLException:

Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkAutoCommit.

on error

checkClose back to summary

checkClose	back to summary
public void checkClose() throws SQLException Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkClose. Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkClose. Check if the brokered connection can be closed. Exceptions SQLException: if it is not allowed to call close on the brokered connection See Also `BrokeredConnectionControl#checkClose()`

public void checkClose() throws SQLException

Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkClose.

Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkClose.

Check if the brokered connection can be closed.

Exceptions

SQLException:: if it is not allowed to call close on the brokered connection

checkCommit	back to summary
public void checkCommit() throws SQLException Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkCommit. Allow control over calling commit. Exceptions SQLException: Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkCommit. on error

checkCommit

back to summary

public void checkCommit() throws SQLException

Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkCommit.

Allow control over calling commit.

Exceptions

SQLException:

Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkCommit.

on error

checkHoldCursors	back to summary
public int checkHoldCursors(int holdability, boolean downgrade) throws SQLException Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkHoldCursors. Are held cursors allowed. Parameters holdability:int Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkHoldCursors. Current holdability downgrade:boolean Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkHoldCursors. true to downgrade the holdability, false to throw an exception. Returns:int Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkHoldCursors. whether cursors can be held across commits Exceptions SQLException: Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkHoldCursors. on error

checkHoldCursors

back to summary

public int checkHoldCursors(int holdability, boolean downgrade) throws SQLException

Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkHoldCursors.

Are held cursors allowed.

Parameters

holdability:int

Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkHoldCursors.

Current holdability

downgrade:boolean

Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkHoldCursors.

true to downgrade the holdability, false to throw an exception.

Returns:int

Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkHoldCursors.

whether cursors can be held across commits

Exceptions

SQLException:

Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkHoldCursors.

on error

checkRollback	back to summary
public void checkRollback() throws SQLException Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkRollback. Allow control over calling rollback. Exceptions SQLException: Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkRollback. on error

checkRollback

back to summary

public void checkRollback() throws SQLException

Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkRollback.

Allow control over calling rollback.

Exceptions

SQLException:

Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkRollback.

on error

checkSavepoint	back to summary
public void checkSavepoint() throws SQLException Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkSavepoint. Allow control over creating a Savepoint (JDBC 3.0) Exceptions SQLException: Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkSavepoint. on error

checkSavepoint

back to summary

public void checkSavepoint() throws SQLException

Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkSavepoint.

Allow control over creating a Savepoint (JDBC 3.0)

Exceptions

SQLException:

Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.checkSavepoint.

on error

close	back to summary
public synchronized void close() throws SQLException Implements javax.sql.PooledConnection.close. Close the Pooled connection. Exceptions SQLException: - if a database-access error occurs.

back to summary

public synchronized void close() throws SQLException

Implements javax.sql.PooledConnection.close.

Close the Pooled connection.

Exceptions

SQLException:: - if a database-access error occurs.

closeCurrentConnectionHandle	back to summary
private void closeCurrentConnectionHandle() throws SQLException In this case the Listeners are not notified. JDBC 3.0 spec section 11.4

closingConnection	back to summary
public synchronized boolean closingConnection() throws SQLException Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.closingConnection. Close called on BrokeredConnection. If this call returns true then getRealConnection().close() will be called. Notify listners that connection is closed. Don't close the underlying real connection as it is pooled. Returns:boolean Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.closingConnection. true if getRealConnection().close() will be called Exceptions SQLException: Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.closingConnection. on error

closingConnection

back to summary

public synchronized boolean closingConnection() throws SQLException

Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.closingConnection.

Close called on BrokeredConnection. If this call returns true then getRealConnection().close() will be called. Notify listners that connection is closed. Don't close the underlying real connection as it is pooled.

Returns:boolean

Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.closingConnection.

true if getRealConnection().close() will be called

Exceptions

SQLException:

Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.closingConnection.

on error

fireConnectionEventListeners back to summary

fireConnectionEventListeners	back to summary
private void fireConnectionEventListeners(SQLException exception) Fire all the `ConnectionEventListener`s registered. Callers must synchronize on `this` to prevent others from modifying the list of listeners. Parameters exception:SQLException the exception that caused the event, or `null` if it is a close event

private void fireConnectionEventListeners(SQLException exception)

Fire all the ConnectionEventListeners registered. Callers must synchronize on this to prevent others from modifying the list of listeners.

Parameters

exception:SQLException: the exception that caused the event, or null if it is a close event

getConnection	back to summary
public synchronized Connection getConnection() throws SQLException Implements javax.sql.PooledConnection.getConnection. Create an object handle for a database connection. Returns:Connection a Connection object Exceptions SQLException: - if a database-access error occurs.

getConnection

back to summary

public synchronized Connection getConnection() throws SQLException

Implements javax.sql.PooledConnection.getConnection.

Create an object handle for a database connection.

Returns:Connection

a Connection object

Exceptions

SQLException:: - if a database-access error occurs.

getLanguageConnection	back to summary
public synchronized LanguageConnectionContext getLanguageConnection() throws SQLException Returns:LanguageConnectionContext The underlying language connection.

getLanguageConnectionContext	back to summary
private static LanguageConnectionContext getLanguageConnectionContext(final EmbedConnection conn) Gets the LanguageConnectionContext for this connection.

getNewCurrentConnectionHandle	back to summary
pack-priv final Connection getNewCurrentConnectionHandle() throws SQLException

getPassword	back to summary
pack-priv String getPassword()

getRealConnection	back to summary
public synchronized EngineConnection getRealConnection() throws SQLException Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.getRealConnection. Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.getRealConnection. Return the real JDBC connection for the brokered connection. Returns:EngineConnection the real JDBC connection Exceptions SQLException: on error

getRealConnection

back to summary

public synchronized EngineConnection getRealConnection() throws SQLException

Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.getRealConnection.

Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.getRealConnection.

Return the real JDBC connection for the brokered connection.

Returns:EngineConnection

the real JDBC connection

Exceptions

SQLException:: on error

getUsername	back to summary
pack-priv String getUsername()

isActive	back to summary
public boolean isActive() getter function for isActive Returns:boolean boolean is isActive is true

isActive

back to summary

public boolean isActive()

getter function for isActive

Returns:boolean: boolean is isActive is true

isInGlobalTransaction back to summary

isInGlobalTransaction	back to summary
public boolean isInGlobalTransaction() Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.isInGlobalTransaction. Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.isInGlobalTransaction. Is this a global transaction Returns:boolean true if this is a global XA transaction See Also `BrokeredConnectionControl#isInGlobalTransaction()`

public boolean isInGlobalTransaction()

Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.isInGlobalTransaction.

Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.isInGlobalTransaction.

Is this a global transaction

Returns:boolean: true if this is a global XA transaction
See Also: BrokeredConnectionControl#isInGlobalTransaction()

isIsolationLevelSetUsingSQLorJDBC	back to summary
public boolean isIsolationLevelSetUsingSQLorJDBC() throws SQLException Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.isIsolationLevelSetUsingSQLorJDBC. Returns true if isolation level has been set using either JDBC api or SQL Returns:boolean Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.isIsolationLevelSetUsingSQLorJDBC. true if isolation level has been set by user Exceptions SQLException: Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.isIsolationLevelSetUsingSQLorJDBC. on error

isIsolationLevelSetUsingSQLorJDBC

back to summary

public boolean isIsolationLevelSetUsingSQLorJDBC() throws SQLException

Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.isIsolationLevelSetUsingSQLorJDBC.

Returns true if isolation level has been set using either JDBC api or SQL

Returns:boolean

Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.isIsolationLevelSetUsingSQLorJDBC.

true if isolation level has been set by user

Exceptions

SQLException:

Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.isIsolationLevelSetUsingSQLorJDBC.

on error

notifyError	back to summary
public synchronized void notifyError(SQLException exception)

notifyException	back to summary
public void notifyException(SQLException sqle) Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.notifyException. Notify the control class that a SQLException was thrown during a call on one of the brokered connection's methods. Parameters sqle:SQLException Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.notifyException. A sql exception

notifyException

back to summary

public void notifyException(SQLException sqle)

Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.notifyException.

Notify the control class that a SQLException was thrown during a call on one of the brokered connection's methods.

Parameters

sqle:SQLException

Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.notifyException.

A sql exception

onStatementClose back to summary

onStatementClose	back to summary
public void onStatementClose(PreparedStatement statement) Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.onStatementClose. Raise the statementClosed event for all the listeners when the corresponding events occurs Parameters statement:PreparedStatement the `PreparedStatement` that was closed

public void onStatementClose(PreparedStatement statement)

Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.onStatementClose.

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

Parameters

statement:PreparedStatement: the PreparedStatement that was closed

onStatementErrorOccurred back to summary

onStatementErrorOccurred	back to summary
public void onStatementErrorOccurred(PreparedStatement statement, SQLException sqle) Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.onStatementErrorOccurred. Raise the statementErrorOccurred event for all the listeners when the corresponding events occurs Parameters statement:PreparedStatement the `PreparedStatement` in which the error occurred sqle:SQLException the `SQLException` that was thrown

public void onStatementErrorOccurred(PreparedStatement statement, SQLException sqle)

Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.onStatementErrorOccurred.

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

Parameters

statement:PreparedStatement: the PreparedStatement in which the error occurred
sqle:SQLException: the SQLException that was thrown

openRealConnection	back to summary
pack-priv final void openRealConnection() throws SQLException

removeConnectionEventListener back to summary

removeConnectionEventListener	back to summary
public final synchronized void removeConnectionEventListener(ConnectionEventListener listener) Implements javax.sql.PooledConnection.removeConnectionEventListener. Remove an event listener. Parameters listener:ConnectionEventListener Doc from javax.sql.PooledConnection.removeConnectionEventListener. a component, usually the connection pool manager, that has implemented the `ConnectionEventListener` interface and been registered with this `PooledConnection` object as a listener

public final synchronized void removeConnectionEventListener(ConnectionEventListener listener)

Implements javax.sql.PooledConnection.removeConnectionEventListener.

Remove an event listener.

Parameters

listener:ConnectionEventListener

Doc from javax.sql.PooledConnection.removeConnectionEventListener.

a component, usually the connection pool manager, that has implemented the ConnectionEventListener interface and been registered with this PooledConnection object as a listener

removeStatementEventListener back to summary

removeStatementEventListener	back to summary
public void removeStatementEventListener(StatementEventListener listener) Implements javax.sql.PooledConnection.removeStatementEventListener. 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:StatementEventListener the component which implements the `StatementEventListener` interface that was previously registered with this `PooledConnection` object

public void removeStatementEventListener(StatementEventListener listener)

Implements javax.sql.PooledConnection.removeStatementEventListener.

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:StatementEventListener: the component which implements the StatementEventListener interface that was previously registered with this PooledConnection object

resetIsolationLevelFlag	back to summary
public void resetIsolationLevelFlag() throws SQLException Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.resetIsolationLevelFlag. Reset the isolation level flag used to keep state in BrokeredConnection. It will get set to true when isolation level is set using JDBC/SQL. It will get reset to false at the start and the end of a global transaction. Exceptions SQLException: Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.resetIsolationLevelFlag. on error

resetIsolationLevelFlag

back to summary

public void resetIsolationLevelFlag() throws SQLException

Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.resetIsolationLevelFlag.

Reset the isolation level flag used to keep state in BrokeredConnection. It will get set to true when isolation level is set using JDBC/SQL. It will get reset to false at the start and the end of a global transaction.

Exceptions

SQLException:

Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.resetIsolationLevelFlag.

on error

resetRealConnection	back to summary
pack-priv void resetRealConnection() throws SQLException

toString	back to summary
public String toString() Overrides java.lang.Object.toString. Get the string representation of this pooled connection. A pooled connection is assigned a separate id from a physical connection. When a container calls PooledConnection.toString(), it gets the string representation of this id. This is useful for developers implementing connection pools when they are trying to debug pooled connections. Returns:String a string representation of the uniquie id for this pooled connection.

toString

back to summary

public String toString()

Overrides java.lang.Object.toString.

Get the string representation of this pooled connection. A pooled connection is assigned a separate id from a physical connection. When a container calls PooledConnection.toString(), it gets the string representation of this id. This is useful for developers implementing connection pools when they are trying to debug pooled connections.

Returns:String: a string representation of the uniquie id for this pooled connection.

wrapStatement

back to summary

public Statement wrapStatement(Statement s) throws SQLException

Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.wrapStatement.

No need to wrap statements for PooledConnections.

Parameters

s:Statement

Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.wrapStatement.

The original statement

Returns:Statement

Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.wrapStatement.

a wrapper statement

Exceptions

SQLException:

Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.wrapStatement.

on error

wrapStatement

back to summary

public PreparedStatement wrapStatement(PreparedStatement ps, String sql, Object generatedKeys) throws SQLException

Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.wrapStatement.

Call the setBrokeredConnectionControl method inside the EmbedPreparedStatement class to set the BrokeredConnectionControl variable to this instance of EmbedPooledConnection This will then be used to call the onStatementErrorOccurred and onStatementClose events when the corresponding events occur on the PreparedStatement

Parameters

ps:PreparedStatement: PreparedStatment to be wrapped
sql:String: String
generatedKeys:Object: Object

Returns:PreparedStatement

returns the wrapped PreparedStatement

Exceptions

SQLException:

Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.wrapStatement.

on error

wrapStatement

back to summary

public CallableStatement wrapStatement(CallableStatement cs, String sql) throws SQLException

Implements org.apache.derby.iapi.jdbc.BrokeredConnectionControl.wrapStatement.

Call the setBrokeredConnectionControl method inside the EmbedCallableStatement class to set the BrokeredConnectionControl variable to this instance of EmbedPooledConnection This will then be used to call the onStatementErrorOccurred and onStatementClose events when the corresponding events occur on the CallableStatement

Parameters

cs:CallableStatement: CallableStatment to be wrapped
sql:String: String

Returns:CallableStatement

returns the wrapped CallableStatement

Exceptions

SQLException:

Doc from org.apache.derby.iapi.jdbc.BrokeredConnectionControl.wrapStatement.

on error

public Class EmbedPooledConnection

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail