Module org.jooq
Package org.jooq

Interface ConnectionProvider

    • Method Detail

      • acquire

        @Nullable
        @Nullable Connection acquire()
                              throws DataAccessException
        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 release(Connection) exactly once.

        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.
        Throws:
        DataAccessException - If anything went wrong while acquiring a connection
      • release

        void release​(Connection connection)
              throws DataAccessException
        Release a connection to the connection lifecycle handler.

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

        Parameters:
        connection - A connection that was previously obtained from acquire(). This is never null.
        Throws:
        DataAccessException - If anything went wrong while releasing a connection