org.apache.derby.iapi.jdbc
Interface BrokeredConnectionControl

All Known Implementing Classes:
EmbedPooledConnection, EmbedPooledConnection40, EmbedXAConnection, EmbedXAConnection40

public interface BrokeredConnectionControl

Provides control over a BrokeredConnection


Method Summary
 void checkAutoCommit(boolean autoCommit)
          Allow control over setting auto commit mode.
 void checkClose()
          Check if the brokered connection can be closed.
 void checkCommit()
          Allow control over calling commit.
 int checkHoldCursors(int holdability, boolean downgrade)
          Can cursors be held across commits.
 void checkRollback()
          Allow control over calling rollback.
 void checkSavepoint()
          Allow control over creating a Savepoint (JDBC 3.0)
 boolean closingConnection()
          Close called on BrokeredConnection.
 EngineConnection getRealConnection()
          Return the real JDBC connection for the brokered connection.
 boolean isInGlobalTransaction()
          Is this a global transaction
 boolean isIsolationLevelSetUsingSQLorJDBC()
          Returns true if isolation level has been set using JDBC/SQL.
 void notifyException(java.sql.SQLException sqle)
          Notify the control class that a SQLException was thrown during a call on one of the brokered connection's methods.
 void onStatementClose(java.sql.PreparedStatement statement)
          Close called on the associated PreparedStatement object
 void onStatementErrorOccurred(java.sql.PreparedStatement statement, java.sql.SQLException sqle)
          Error occurred on associated PreparedStatement object
 void resetIsolationLevelFlag()
          Reset the isolation level flag used to keep state in BrokeredConnection.
 java.sql.CallableStatement wrapStatement(java.sql.CallableStatement realStatement, java.lang.String sql)
          Optionally wrap a CallableStatement with an CallableStatement.
 java.sql.PreparedStatement wrapStatement(java.sql.PreparedStatement realStatement, java.lang.String sql, java.lang.Object generateKeys)
          Optionally wrap a PreparedStatement with another PreparedStatement.
 java.sql.Statement wrapStatement(java.sql.Statement realStatement)
          Optionally wrap a Statement with another Statement.
 

Method Detail

getRealConnection

EngineConnection getRealConnection()
                                   throws java.sql.SQLException
Return the real JDBC connection for the brokered connection.

Throws:
java.sql.SQLException

notifyException

void notifyException(java.sql.SQLException sqle)
Notify the control class that a SQLException was thrown during a call on one of the brokered connection's methods.


checkAutoCommit

void checkAutoCommit(boolean autoCommit)
                     throws java.sql.SQLException
Allow control over setting auto commit mode.

Throws:
java.sql.SQLException

checkSavepoint

void checkSavepoint()
                    throws java.sql.SQLException
Allow control over creating a Savepoint (JDBC 3.0)

Throws:
java.sql.SQLException

checkRollback

void checkRollback()
                   throws java.sql.SQLException
Allow control over calling rollback.

Throws:
java.sql.SQLException

checkCommit

void checkCommit()
                 throws java.sql.SQLException
Allow control over calling commit.

Throws:
java.sql.SQLException

checkClose

void checkClose()
                throws java.sql.SQLException
Check if the brokered connection can be closed.

Throws:
java.sql.SQLException - if it is not allowed to call close on the brokered connection

checkHoldCursors

int checkHoldCursors(int holdability,
                     boolean downgrade)
                     throws java.sql.SQLException
Can cursors be held across commits.

Parameters:
downgrade - true to downgrade the holdability, false to throw an exception.
Throws:
java.sql.SQLException

isIsolationLevelSetUsingSQLorJDBC

boolean isIsolationLevelSetUsingSQLorJDBC()
                                          throws java.sql.SQLException
Returns true if isolation level has been set using JDBC/SQL.

Throws:
java.sql.SQLException

resetIsolationLevelFlag

void resetIsolationLevelFlag()
                             throws java.sql.SQLException
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.

Throws:
java.sql.SQLException

isInGlobalTransaction

boolean isInGlobalTransaction()
Is this a global transaction

Returns:
true if this is a global XA transaction

closingConnection

boolean closingConnection()
                          throws java.sql.SQLException
Close called on BrokeredConnection. If this call returns true then getRealConnection().close() will be called.

Throws:
java.sql.SQLException

wrapStatement

java.sql.Statement wrapStatement(java.sql.Statement realStatement)
                                 throws java.sql.SQLException
Optionally wrap a Statement with another Statement.

Throws:
java.sql.SQLException

wrapStatement

java.sql.PreparedStatement wrapStatement(java.sql.PreparedStatement realStatement,
                                         java.lang.String sql,
                                         java.lang.Object generateKeys)
                                         throws java.sql.SQLException
Optionally wrap a PreparedStatement with another PreparedStatement.

Throws:
java.sql.SQLException

wrapStatement

java.sql.CallableStatement wrapStatement(java.sql.CallableStatement realStatement,
                                         java.lang.String sql)
                                         throws java.sql.SQLException
Optionally wrap a CallableStatement with an CallableStatement.

Throws:
java.sql.SQLException

onStatementClose

void onStatementClose(java.sql.PreparedStatement statement)
Close called on the associated PreparedStatement object

Parameters:
statement - PreparedStatement object on which the close event occurred

onStatementErrorOccurred

void onStatementErrorOccurred(java.sql.PreparedStatement statement,
                              java.sql.SQLException sqle)
Error occurred on associated PreparedStatement object

Parameters:
statement - PreparedStatement object on which the error occured
sqle - The SQLExeption that caused the error

Built on Thu 2011-03-10 11:54:14+0000, from revision ???

Apache Derby V10.6 Internals - Copyright © 2004,2007 The Apache Software Foundation. All Rights Reserved.