Module org.jooq

Package org.jooq.tools.jdbc

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 Summary

Constructors

Constructor	Description
MockConnectionProvider(ConnectionProvider delegate, MockDataProvider provider)

Method Summary

Modifier and Type	Method	Description
Connection	acquire()	Acquire a connection from the connection lifecycle handler.
void	release(Connection connection)	Release a connection to the connection lifecycle handler.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MockConnectionProvider

public MockConnectionProvider(ConnectionProvider delegate,
                              MockDataProvider provider)

Method Detail

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.