Package oracle.jdbc.replay

Interface ConnectionInitializationCallback

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 Details

    • 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