jOOQ 3.18.7 · org.jooq.tools.jdbc.MockConnectionProvider

A mock connection provider.

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

Disclaimer

The general idea of mocking a JDBC connection with this jOOQ API is to provide quick workarounds, injection points, etc. using a very simple JDBC abstraction. It is NOT RECOMMENDED to emulate an entire database (including complex state transitions, transactions, locking, etc.) using this mock API. Once you have this requirement, please consider using an actual database instead for integration testing (e.g. using https://www.testcontainers.org), rather than implementing your test database inside of a MockDataProvider.

Modifier and Type	Class and Description
private class	MockConnectionProvider.MockConnectionWrapper Deprecated as a consequence of `MockConnection` being deprecated.

Modifier and Type	Field and Description
private final ConnectionProvider	delegate
private final MockDataProvider	provider

Constructor Summary

Access	Constructor and Description
public	MockConnectionProvider(ConnectionProvider delegate, MockDataProvider provider)

Method Summary

Modifier and Type	Method and Description
public final Connection	acquire() Implements org.jooq.ConnectionProvider.acquire. Acquire a connection from the connection lifecycle handler.
public final void	release(Connection A connection that was previously obtained from `acquire()`. This is never `null`. connection) Implements org.jooq.ConnectionProvider.release. Release a connection to the connection lifecycle handler.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

delegate	back to summary
private final ConnectionProvider delegate

provider	back to summary
private final MockDataProvider provider

Constructor Detail

MockConnectionProvider	back to summary
public MockConnectionProvider(ConnectionProvider delegate, MockDataProvider provider)

Method Detail

acquire back to summary

acquire	back to summary
public final Connection acquire() Implements org.jooq.ConnectionProvider.acquire. Doc from org.jooq.ConnectionProvider.acquire. 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:Connection 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`. Annotations @Override

public final Connection acquire()

Implements org.jooq.ConnectionProvider.acquire.

Doc from org.jooq.ConnectionProvider.acquire.

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:Connection

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.

Annotations

@Override

release back to summary

release	back to summary
public final void release(Connection connection) Implements org.jooq.ConnectionProvider.release. Doc from org.jooq.ConnectionProvider.release. Release a connection to the connection lifecycle handler. jOOQ will guarantee that every acquired connection is released exactly once. Parameters connection:Connection A connection that was previously obtained from `acquire()`. This is never `null`. Annotations @Override

public final void release(Connection connection)

Implements org.jooq.ConnectionProvider.release.

Doc from org.jooq.ConnectionProvider.release.

Release a connection to the connection lifecycle handler.

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

Parameters

connection:Connection: A connection that was previously obtained from acquire(). This is never null.

Annotations

@Override

public Class MockConnectionProvider

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class MockConnectionProvider.MockConnectionWrapper

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail