Module org.jooq

Class MockConnectionProvider

java.lang.Object
org.jooq.tools.jdbc.MockConnectionProvider
All Implemented Interfaces:
ConnectionProvider

public class MockConnectionProvider extends Object implements ConnectionProvider
A mock connection provider.

This ConnectionProvider wraps a delegate ConnectionProvider and wraps all acquired Connection references in MockConnection.

Author:
Lukas Eder
  • Constructor Details

  • Method Details

    • acquire

      public final Connection acquire()
      Description copied from interface: ConnectionProvider
      Acquire a connection from the connection lifecycle handler.

      This method is called by jOOQ exactly once per execution lifecycle, i.e. per ExecuteContext. Implementations may freely chose, whether subsequent calls to this method:

      • return the same connection instance
      • return the same connection instance for the same thread
      • return the same connection instance for the same transaction (e.g. a javax.transaction.UserTransaction)
      • return a fresh connection instance every time

      jOOQ will guarantee that every acquired connection is released through ConnectionProvider.release(Connection) exactly once.

      Specified by:
      acquire in interface ConnectionProvider
      Returns:
      A connection for the current ExecuteContext. If null is returned (e.g. by NoConnectionProvider), then statements cannot be executed. Attempts to execute statements will result in a DetachedException.
    • release

      public final void release(Connection connection)
      Description copied from interface: ConnectionProvider
      Release a connection to the connection lifecycle handler.

      jOOQ will guarantee that every acquired connection is released exactly once.

      Specified by:
      release in interface ConnectionProvider
      Parameters:
      connection - A connection that was previously obtained from ConnectionProvider.acquire(). This is never null.