Modifier and Type	Class and Description
public static class	DriverManagerConnectionProviderImpl.PooledConnections
private static class	DriverManagerConnectionProviderImpl.PoolState
private static class	DriverManagerConnectionProviderImpl.ValidationThreadFactory

Modifier and Type	Field and Description
public static final String	CONNECTION_CREATOR_FACTORY
public static final String	INIT_SQL
public static final String	INITIAL_SIZE
private static final ConnectionPoolingLogger	log
public static final String	MIN_SIZE
private volatile ServiceRegistryImplementor	serviceRegistry
private volatile DriverManagerConnectionProviderImpl.PoolState	state
public static final String	VALIDATION_INTERVAL

Access	Constructor and Description
public	DriverManagerConnectionProviderImpl()

Method Summary

Modifier and Type	Method and Description
private static ConnectionCreator	buildCreator(Map<K, V> configurationValues, ServiceRegistryImplementor serviceRegistry)
private DriverManagerConnectionProviderImpl.PooledConnections	buildPool(Map<K, V> configurationValues, ServiceRegistryImplementor serviceRegistry)
public void	closeConnection(Connection The JDBC connection to release conn) Implements org.hibernate.engine.jdbc.connections.spi.ConnectionProvider.closeConnection. Release a connection from Hibernate use.
public void	configure(Map<K, V> The configuration properties. configurationValues) Implements org.hibernate.service.spi.Configurable.configure. Configure the service.
protected void	finalize() Overrides java.lang.Object.finalize. Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
public Connection	getConnection() Implements org.hibernate.engine.jdbc.connections.spi.ConnectionProvider.getConnection. Obtains a connection for Hibernate use according to the underlying strategy of this provider.
public Properties	getConnectionProperties() Exposed to facilitate testing only.
public void	injectServices(ServiceRegistryImplementor The registry serviceRegistry) Implements org.hibernate.service.spi.ServiceRegistryAwareService.injectServices. Callback to inject the registry.
public boolean	isUnwrappableAs(Class<T> The type to check. unwrapType) Implements org.hibernate.service.spi.Wrapped.isUnwrappableAs. Can this wrapped service be unwrapped as the indicated type?
public boolean	isValid(Connection connection) Implements org.hibernate.engine.jdbc.connections.internal.ConnectionValidator.isValid. Checks if the connection is still valid
private static ConnectionCreatorFactory	loadConnectionCreatorFactory(String connectionCreatorFactoryClassName, ServiceRegistryImplementor serviceRegistry)
private static Driver	loadDriverIfPossible(String driverClassName, ServiceRegistryImplementor serviceRegistry)
public void	stop() Implements org.hibernate.service.spi.Stoppable.stop. Stop phase notification
public boolean	supportsAggressiveRelease() Implements org.hibernate.engine.jdbc.connections.spi.ConnectionProvider.supportsAggressiveRelease. Does this connection provider support aggressive release of JDBC connections and re-acquisition of those connections (if need be) later?
public <T> T	unwrap(Class<T> The java type as which to unwrap this instance. unwrapType) Implements org.hibernate.service.spi.Wrapped.unwrap. Unproxy the service proxy
protected void	validateConnectionsReturned()

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

Field Detail

CONNECTION_CREATOR_FACTORY	back to summary
public static final String CONNECTION_CREATOR_FACTORY

INIT_SQL	back to summary
public static final String INIT_SQL

INITIAL_SIZE	back to summary
public static final String INITIAL_SIZE

log	back to summary
private static final ConnectionPoolingLogger log

MIN_SIZE	back to summary
public static final String MIN_SIZE

serviceRegistry	back to summary
private volatile ServiceRegistryImplementor serviceRegistry

state	back to summary
private volatile DriverManagerConnectionProviderImpl.PoolState state

VALIDATION_INTERVAL	back to summary
public static final String VALIDATION_INTERVAL

Constructor Detail

DriverManagerConnectionProviderImpl	back to summary
public DriverManagerConnectionProviderImpl()

Method Detail

buildCreator	back to summary
private static ConnectionCreator buildCreator(Map<K, V> configurationValues, ServiceRegistryImplementor serviceRegistry)

buildPool	back to summary
private DriverManagerConnectionProviderImpl.PooledConnections buildPool(Map<K, V> configurationValues, ServiceRegistryImplementor serviceRegistry)

closeConnection	back to summary
public void closeConnection(Connection conn) throws SQLException Implements org.hibernate.engine.jdbc.connections.spi.ConnectionProvider.closeConnection. Doc from org.hibernate.engine.jdbc.connections.spi.ConnectionProvider.closeConnection. Release a connection from Hibernate use. Parameters conn:Connection The JDBC connection to release Annotations @Override Exceptions SQLException: Indicates a problem closing the connection

closeConnection

back to summary

public void closeConnection(Connection conn) throws SQLException

Implements org.hibernate.engine.jdbc.connections.spi.ConnectionProvider.closeConnection.

Doc from org.hibernate.engine.jdbc.connections.spi.ConnectionProvider.closeConnection.

Release a connection from Hibernate use.

Parameters

conn:Connection: The JDBC connection to release

Annotations

@Override

Exceptions

SQLException:: Indicates a problem closing the connection

configure	back to summary
public void configure(Map<K, V> configurationValues) Implements org.hibernate.service.spi.Configurable.configure. Doc from org.hibernate.service.spi.Configurable.configure. Configure the service. Parameters configurationValues:Map<K, V> The configuration properties. Annotations @Override

configure

back to summary

public void configure(Map<K, V> configurationValues)

Implements org.hibernate.service.spi.Configurable.configure.

Doc from org.hibernate.service.spi.Configurable.configure.

Configure the service.

Parameters

configurationValues:Map<K, V>: The configuration properties.

Annotations

@Override

finalize back to summary

finalize	back to summary
protected void finalize() throws Throwable Overrides java.lang.Object.finalize. Doc from java.lang.Object.finalize. Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. A subclass overrides the `finalize` method to dispose of system resources or to perform other cleanup. When running in a Java virtual machine in which finalization has been disabled or removed, the garbage collector will never call `finalize()`. In a Java virtual machine in which finalization is enabled, the garbage collector might call `finalize` only after an indefinite delay. The general contract of `finalize` is that it is invoked if and when the Java virtual machine has determined that there is no longer any means by which this object can be accessed by any thread that has not yet died, except as a result of an action taken by the finalization of some other object or class which is ready to be finalized. The `finalize` method may take any action, including making this object available again to other threads; the usual purpose of `finalize`, however, is to perform cleanup actions before the object is irrevocably discarded. For example, the finalize method for an object that represents an input/output connection might perform explicit I/O transactions to break the connection before the object is permanently discarded. The `finalize` method of class `Object` performs no special action; it simply returns normally. Subclasses of `Object` may override this definition. The Java programming language does not guarantee which thread will invoke the `finalize` method for any given object. It is guaranteed, however, that the thread that invokes finalize will not be holding any user-visible synchronization locks when finalize is invoked. If an uncaught exception is thrown by the finalize method, the exception is ignored and finalization of that object terminates. After the `finalize` method has been invoked for an object, no further action is taken until the Java virtual machine has again determined that there is no longer any means by which this object can be accessed by any thread that has not yet died, including possible actions by other objects or classes which are ready to be finalized, at which point the object may be discarded. The `finalize` method is never invoked more than once by a Java virtual machine for any given object. Any exception thrown by the `finalize` method causes the finalization of this object to be halted, but is otherwise ignored. Annotations @Override Exceptions Throwable: the `Exception` raised by this method

protected void finalize() throws Throwable

Overrides java.lang.Object.finalize.

Doc from java.lang.Object.finalize.

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. A subclass overrides the finalize method to dispose of system resources or to perform other cleanup.

When running in a Java virtual machine in which finalization has been disabled or removed, the garbage collector will never call finalize(). In a Java virtual machine in which finalization is enabled, the garbage collector might call finalize only after an indefinite delay.

The general contract of finalize is that it is invoked if and when the Java virtual machine has determined that there is no longer any means by which this object can be accessed by any thread that has not yet died, except as a result of an action taken by the finalization of some other object or class which is ready to be finalized. The finalize method may take any action, including making this object available again to other threads; the usual purpose of finalize, however, is to perform cleanup actions before the object is irrevocably discarded. For example, the finalize method for an object that represents an input/output connection might perform explicit I/O transactions to break the connection before the object is permanently discarded.

The finalize method of class Object performs no special action; it simply returns normally. Subclasses of Object may override this definition.

The Java programming language does not guarantee which thread will invoke the finalize method for any given object. It is guaranteed, however, that the thread that invokes finalize will not be holding any user-visible synchronization locks when finalize is invoked. If an uncaught exception is thrown by the finalize method, the exception is ignored and finalization of that object terminates.

After the finalize method has been invoked for an object, no further action is taken until the Java virtual machine has again determined that there is no longer any means by which this object can be accessed by any thread that has not yet died, including possible actions by other objects or classes which are ready to be finalized, at which point the object may be discarded.

The finalize method is never invoked more than once by a Java virtual machine for any given object.

Any exception thrown by the finalize method causes the finalization of this object to be halted, but is otherwise ignored.

Annotations

@Override

Exceptions

Throwable:: the Exception raised by this method

getConnection	back to summary
public Connection getConnection() throws SQLException Implements org.hibernate.engine.jdbc.connections.spi.ConnectionProvider.getConnection. Doc from org.hibernate.engine.jdbc.connections.spi.ConnectionProvider.getConnection. Obtains a connection for Hibernate use according to the underlying strategy of this provider. Returns:Connection The obtained JDBC connection Annotations @Override Exceptions SQLException: Indicates a problem opening a connection

getConnection

back to summary

public Connection getConnection() throws SQLException

Implements org.hibernate.engine.jdbc.connections.spi.ConnectionProvider.getConnection.

Doc from org.hibernate.engine.jdbc.connections.spi.ConnectionProvider.getConnection.

Obtains a connection for Hibernate use according to the underlying strategy of this provider.

Returns:Connection

The obtained JDBC connection

Annotations

@Override

Exceptions

SQLException:: Indicates a problem opening a connection

getConnectionProperties	back to summary
public Properties getConnectionProperties() Exposed to facilitate testing only.

injectServices	back to summary
public void injectServices(ServiceRegistryImplementor serviceRegistry) Implements org.hibernate.service.spi.ServiceRegistryAwareService.injectServices. Doc from org.hibernate.service.spi.ServiceRegistryAwareService.injectServices. Callback to inject the registry. Parameters serviceRegistry:ServiceRegistryImplementor The registry Annotations @Override

injectServices

back to summary

public void injectServices(ServiceRegistryImplementor serviceRegistry)

Implements org.hibernate.service.spi.ServiceRegistryAwareService.injectServices.

Doc from org.hibernate.service.spi.ServiceRegistryAwareService.injectServices.

Callback to inject the registry.

Parameters

serviceRegistry:ServiceRegistryImplementor: The registry

Annotations

@Override

isUnwrappableAs	back to summary
public boolean isUnwrappableAs(Class<T> unwrapType) Implements org.hibernate.service.spi.Wrapped.isUnwrappableAs. Doc from org.hibernate.service.spi.Wrapped.isUnwrappableAs. Can this wrapped service be unwrapped as the indicated type? Parameters unwrapType:Class<T> The type to check. Returns:boolean True/false. Annotations @Override

isUnwrappableAs

back to summary

public boolean isUnwrappableAs(Class<T> unwrapType)

Implements org.hibernate.service.spi.Wrapped.isUnwrappableAs.

Doc from org.hibernate.service.spi.Wrapped.isUnwrappableAs.

Can this wrapped service be unwrapped as the indicated type?

Parameters

unwrapType:Class<T>: The type to check.

Returns:boolean

True/false.

Annotations

@Override

isValid back to summary

isValid	back to summary
public boolean isValid(Connection connection) throws SQLException Implements org.hibernate.engine.jdbc.connections.internal.ConnectionValidator.isValid. Doc from org.hibernate.engine.jdbc.connections.internal.ConnectionValidator.isValid. Checks if the connection is still valid Returns:boolean `true` if the connection is valid, `false` otherwise Annotations @Override Exceptions SQLException: when an error happens due to the connection usage leading to a connection close

public boolean isValid(Connection connection) throws SQLException

Implements org.hibernate.engine.jdbc.connections.internal.ConnectionValidator.isValid.

Doc from org.hibernate.engine.jdbc.connections.internal.ConnectionValidator.isValid.

Checks if the connection is still valid

Returns:boolean

true if the connection is valid, false otherwise

Annotations

@Override

Exceptions

SQLException:: when an error happens due to the connection usage leading to a connection close

loadConnectionCreatorFactory	back to summary
private static ConnectionCreatorFactory loadConnectionCreatorFactory(String connectionCreatorFactoryClassName, ServiceRegistryImplementor serviceRegistry)

loadDriverIfPossible	back to summary
private static Driver loadDriverIfPossible(String driverClassName, ServiceRegistryImplementor serviceRegistry)

stop	back to summary
public void stop() Implements org.hibernate.service.spi.Stoppable.stop. Doc from org.hibernate.service.spi.Stoppable.stop. Stop phase notification Annotations @Override

stop

back to summary

public void stop()

Implements org.hibernate.service.spi.Stoppable.stop.

Doc from org.hibernate.service.spi.Stoppable.stop.

Stop phase notification

Annotations

@Override

supportsAggressiveRelease back to summary

supportsAggressiveRelease	back to summary
public boolean supportsAggressiveRelease() Implements org.hibernate.engine.jdbc.connections.spi.ConnectionProvider.supportsAggressiveRelease. Doc from org.hibernate.engine.jdbc.connections.spi.ConnectionProvider.supportsAggressiveRelease. Does this connection provider support aggressive release of JDBC connections and re-acquisition of those connections (if need be) later? This is used in conjunction with `org.hibernate.cfg.Environment#RELEASE_CONNECTIONS` to aggressively release JDBC connections. However, the configured ConnectionProvider must support re-acquisition of the same underlying connection for that semantic to work. Typically, this is only true in managed environments where a container tracks connections by transaction or thread. Note that JTA semantic depends on the fact that the underlying connection provider does support aggressive release. Returns:boolean `true` if aggressive releasing is supported; `false` otherwise. Annotations @Override

public boolean supportsAggressiveRelease()

Implements org.hibernate.engine.jdbc.connections.spi.ConnectionProvider.supportsAggressiveRelease.

Doc from org.hibernate.engine.jdbc.connections.spi.ConnectionProvider.supportsAggressiveRelease.

Does this connection provider support aggressive release of JDBC connections and re-acquisition of those connections (if need be) later?

This is used in conjunction with org.hibernate.cfg.Environment#RELEASE_CONNECTIONS to aggressively release JDBC connections. However, the configured ConnectionProvider must support re-acquisition of the same underlying connection for that semantic to work.

Typically, this is only true in managed environments where a container tracks connections by transaction or thread. Note that JTA semantic depends on the fact that the underlying connection provider does support aggressive release.

Returns:boolean

true if aggressive releasing is supported; false otherwise.

Annotations

@Override

unwrap	back to summary
public <T> T unwrap(Class<T> unwrapType) Implements org.hibernate.service.spi.Wrapped.unwrap. Doc from org.hibernate.service.spi.Wrapped.unwrap. Unproxy the service proxy Parameters unwrapType:Class<T> The java type as which to unwrap this instance. Returns:T The unwrapped reference Annotations @Override @SuppressWarnings:unchecked

unwrap

back to summary

public <T> T unwrap(Class<T> unwrapType)

Implements org.hibernate.service.spi.Wrapped.unwrap.

Doc from org.hibernate.service.spi.Wrapped.unwrap.

Unproxy the service proxy

Parameters

unwrapType:Class<T>: The java type as which to unwrap this instance.

Returns:T

The unwrapped reference

Annotations

@Override
@SuppressWarnings:unchecked

validateConnectionsReturned	back to summary
protected void validateConnectionsReturned()

org.hibernate.engine.jdbc.connections.internal back to summary

public Class DriverManagerConnectionProviderImpl.PooledConnections

Class Inheritance

extends Object

java.lang.Object
org.hibernate.engine.jdbc.connections.internal.DriverManagerConnectionProviderImpl.PooledConnections

Nested and Inner Type Summary

Modifier and Type	Class and Description
public static class	DriverManagerConnectionProviderImpl.PooledConnections.Builder

Field Summary

Modifier and Type	Field and Description
private final ConcurrentLinkedQueue<Connection>	allConnections
private final boolean	autoCommit
private final ConcurrentLinkedQueue<Connection>	availableConnections
private final ConnectionCreator	connectionCreator
private final ConnectionValidator	connectionValidator
private static final CoreMessageLogger	log
private final int	maxSize
private final int	minSize
private volatile boolean	primed

Constructor Summary

Access	Constructor and Description
private	PooledConnections(DriverManagerConnectionProviderImpl.PooledConnections.Builder builder)

Method Summary

Modifier and Type	Method and Description
public void	add(Connection conn)
protected void	addConnections(int numberOfConnections)
public void	close()
protected void	closeConnection(Connection conn, Throwable t)
public String	getUrl()
public Connection	poll()
protected Connection	prepareConnection(Connection conn)
protected Connection	releaseConnection(Connection conn)
protected void	removeConnections(int numberToBeRemoved)
public int	size()
public void	validate()

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

Field Detail

allConnections	back to summary
private final ConcurrentLinkedQueue<Connection> allConnections

autoCommit	back to summary
private final boolean autoCommit

availableConnections	back to summary
private final ConcurrentLinkedQueue<Connection> availableConnections

connectionCreator	back to summary
private final ConnectionCreator connectionCreator

connectionValidator	back to summary
private final ConnectionValidator connectionValidator

log	back to summary
private static final CoreMessageLogger log

maxSize	back to summary
private final int maxSize

minSize	back to summary
private final int minSize

primed	back to summary
private volatile boolean primed

Constructor Detail

PooledConnections	back to summary
private PooledConnections(DriverManagerConnectionProviderImpl.PooledConnections.Builder builder)

Method Detail

add	back to summary
public void add(Connection conn) throws SQLException

addConnections	back to summary
protected void addConnections(int numberOfConnections)

close	back to summary
public void close() throws SQLException

closeConnection	back to summary
protected void closeConnection(Connection conn, Throwable t)

getUrl	back to summary
public String getUrl()

poll	back to summary
public Connection poll() throws SQLException

prepareConnection	back to summary
protected Connection prepareConnection(Connection conn)

releaseConnection	back to summary
protected Connection releaseConnection(Connection conn)

removeConnections	back to summary
protected void removeConnections(int numberToBeRemoved)

size	back to summary
public int size()

validate	back to summary
public void validate()

org.hibernate.engine.jdbc.connections.internal back to summary

public Class DriverManagerConnectionProviderImpl.PooledConnections.Builder

Class Inheritance

extends Object

java.lang.Object
org.hibernate.engine.jdbc.connections.internal.DriverManagerConnectionProviderImpl.PooledConnections.Builder

Field Summary

Modifier and Type	Field and Description
private boolean	autoCommit
private final ConnectionCreator	connectionCreator
private ConnectionValidator	connectionValidator
private int	initialSize
private int	maxSize
private int	minSize

Constructor Summary

Access	Constructor and Description
public	Builder(ConnectionCreator connectionCreator, boolean autoCommit)

Method Summary

Modifier and Type	Method and Description
public DriverManagerConnectionProviderImpl.PooledConnections	build()
public DriverManagerConnectionProviderImpl.PooledConnections.Builder	initialSize(int initialSize)
public DriverManagerConnectionProviderImpl.PooledConnections.Builder	maxSize(int maxSize)
public DriverManagerConnectionProviderImpl.PooledConnections.Builder	minSize(int minSize)
public DriverManagerConnectionProviderImpl.PooledConnections.Builder	validator(ConnectionValidator connectionValidator)

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

Field Detail

autoCommit	back to summary
private boolean autoCommit

connectionCreator	back to summary
private final ConnectionCreator connectionCreator

connectionValidator	back to summary
private ConnectionValidator connectionValidator

initialSize	back to summary
private int initialSize

maxSize	back to summary
private int maxSize

minSize	back to summary
private int minSize

Constructor Detail

Builder	back to summary
public Builder(ConnectionCreator connectionCreator, boolean autoCommit)

Method Detail

build	back to summary
public DriverManagerConnectionProviderImpl.PooledConnections build()

initialSize	back to summary
public DriverManagerConnectionProviderImpl.PooledConnections.Builder initialSize(int initialSize)

maxSize	back to summary
public DriverManagerConnectionProviderImpl.PooledConnections.Builder maxSize(int maxSize)

minSize	back to summary
public DriverManagerConnectionProviderImpl.PooledConnections.Builder minSize(int minSize)

validator	back to summary
public DriverManagerConnectionProviderImpl.PooledConnections.Builder validator(ConnectionValidator connectionValidator)

Modifier and Type	Field and Description
private volatile boolean	active
private ScheduledExecutorService	executorService
private final DriverManagerConnectionProviderImpl.PooledConnections	pool
private final ReadWriteLock	statelock
private final long	validationInterval

public Class DriverManagerConnectionProviderImpl

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Class DriverManagerConnectionProviderImpl.PooledConnections

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Class DriverManagerConnectionProviderImpl.PooledConnections.Builder

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class DriverManagerConnectionProviderImpl.PoolState

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class DriverManagerConnectionProviderImpl.ValidationThreadFactory

Constructor Summary

Method Summary

Constructor Detail

Method Detail

Modifier and Type	Method and Description
public void	closeConnection(Connection conn)
public Connection	getConnection()
private void	startIfNeeded()
public void	stop()