org.jooq.impl

Class DataSourceConnectionProvider

java.lang.Object

org.jooq.impl.DataSourceConnectionProvider

All Implemented Interfaces:

ConnectionProvider

public class DataSourceConnectionProvider
extends Object
implements ConnectionProvider

A default implementation for a pooled DataSource-oriented ConnectionProvider

This implementation wraps a JDBC DataSource. jOOQ will use that data source for initialising connections, and creating statements.

Use this connection provider if you want to run distributed transactions, such as javax.transaction.UserTransaction. jOOQ will close() all connections after query execution (and result fetching) in order to return the connection to the connection pool. If you do not use distributed transactions, this will produce driver-specific behaviour at the end of query execution at close() invocation (e.g. a transaction rollback). Use a DefaultConnectionProvider instead, to control the connection's lifecycle, or implement your own ConnectionProvider.

Author:

Aaron Digulla, Lukas Eder

Constructor Summary

Constructors

Constructor and Description
DataSourceConnectionProvider(DataSource datasource)

Method Summary

Methods

Modifier and Type	Method and Description
Connection	acquire() Acquire a connection from the connection lifecycle handler The general contract is that a ConnectionProvider is expected to always return the same connection, until this connection is returned by jOOQ through ConnectionProvider.release(Connection).
void	release(Connection released) Release a connection to the connection lifecycle handler The general contract is that a ConnectionProvider must not generate a new connection in ConnectionProvider.acquire(), before a previous connection is returned.

Methods inherited from class java.lang.Object

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

Constructor Detail

DataSourceConnectionProvider

public DataSourceConnectionProvider(DataSource datasource)

Method Detail

acquire

public Connection acquire()

Description copied from interface: ConnectionProvider

Acquire a connection from the connection lifecycle handler

The general contract is that a ConnectionProvider is expected to always return the same connection, until this connection is returned by jOOQ through ConnectionProvider.release(Connection).

Specified by:

acquire in interface ConnectionProvider

release

public void release(Connection released)

Description copied from interface: ConnectionProvider

Release a connection to the connection lifecycle handler

The general contract is that a ConnectionProvider must not generate a new connection in ConnectionProvider.acquire(), before a previous connection is returned.

Specified by:

release in interface ConnectionProvider