Package oracle.jdbc.replay

Interface ConnectionInitializationCallback

All Known Implementing Classes:

OracleReplayableConnectionConnectionPool

public interface ConnectionInitializationCallback

This callback allows applications to re-establish session initial starting point after a failover and before replay starts. This callback is registered on the Replay Data Source. It is executed every time the Replay Data Source gets a new physical connection at failover. There is a requirement that the initialization be idempotent or make a decision that the connection is already initialized and does not repeat itself. The callback execution must not leave an open local transaction without committing it or rolling it back. If this is violated, an exception is thrown. If a callback invocation fails, replay is disabled on the related connection.

Method Summary

Modifier and Type	Method	Description
void	initialize(Connection connection)	Initializes the connection.

Method Detail

initialize

void initialize(Connection connection)
         throws SQLException

Initializes the connection. This typically involves establishing NTSS (Non-Transactional Session State) outside database transactions, such as NLS parameters, cursor state, PL/SQL package variables, and auto-commit mode. For failover, the connection passed in is usually a new physical connection, although a connection pool or application framework utilizing this can provide the callback uniformly for all checked-out connections.

Parameters:

connection - The connection to be initialized.

Throws:

SQLException