org.hibernate.proxool.internal

Class ProxoolConnectionProvider

java.lang.Object

org.hibernate.proxool.internal.ProxoolConnectionProvider

All Implemented Interfaces:

java.io.Serializable, ConnectionProvider, Service, Configurable, ServiceRegistryAwareService, Stoppable, Wrapped

public class ProxoolConnectionProvider
extends java.lang.Object
implements ConnectionProvider, Configurable, Stoppable, ServiceRegistryAwareService

A connection provider that uses a Proxool connection pool. Hibernate will use this by default if the hibernate.proxool.* properties are set.

See Also:

ConnectionProvider, Serialized Form

Constructor Summary

Constructors

Constructor and Description
ProxoolConnectionProvider()

Method Summary

Modifier and Type	Method and Description
void	close() Deprecated. Use stop() instead
void	closeConnection(java.sql.Connection conn) Release a connection from Hibernate use.
void	configure(java.util.Map props) Configure the service.
java.sql.Connection	getConnection() Obtains a connection for Hibernate use according to the underlying strategy of this provider.
void	injectServices(ServiceRegistryImplementor serviceRegistry) Callback to inject the registry.
boolean	isUnwrappableAs(java.lang.Class unwrapType) Can this wrapped service be unwrapped as the indicated type?
void	stop() Stop phase notification
boolean	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 AvailableSettings.RELEASE_CONNECTIONS to aggressively release JDBC connections.
<T> T	unwrap(java.lang.Class<T> unwrapType) Unproxy the service proxy

Methods inherited from class java.lang.Object

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

Constructor Detail

ProxoolConnectionProvider

public ProxoolConnectionProvider()

Method Detail

getConnection

public java.sql.Connection getConnection()
                                  throws java.sql.SQLException

Description copied from interface: ConnectionProvider

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

Specified by:

getConnection in interface ConnectionProvider

Returns:

The obtained JDBC connection

Throws:

java.sql.SQLException - Indicates a problem opening a connection

isUnwrappableAs

public boolean isUnwrappableAs(java.lang.Class unwrapType)

Description copied from interface: Wrapped

Can this wrapped service be unwrapped as the indicated type?

Specified by:

isUnwrappableAs in interface Wrapped

Parameters:

unwrapType - The type to check.

Returns:

True/false.

unwrap

public <T> T unwrap(java.lang.Class<T> unwrapType)

Description copied from interface: Wrapped

Unproxy the service proxy

Specified by:

unwrap in interface Wrapped

Parameters:

unwrapType - The java type as which to unwrap this instance.

Returns:

The unwrapped reference

closeConnection

public void closeConnection(java.sql.Connection conn)
                     throws java.sql.SQLException

Description copied from interface: ConnectionProvider

Release a connection from Hibernate use.

Specified by:

closeConnection in interface ConnectionProvider

Parameters:

conn - The JDBC connection to release

Throws:

java.sql.SQLException - Indicates a problem closing the connection

injectServices

public void injectServices(ServiceRegistryImplementor serviceRegistry)

Description copied from interface: ServiceRegistryAwareService

Callback to inject the registry.

Specified by:

injectServices in interface ServiceRegistryAwareService

Parameters:

serviceRegistry - The registry

configure

public void configure(java.util.Map props)

Description copied from interface: Configurable

Configure the service.

Specified by:

configure in interface Configurable

Parameters:

props - The configuration properties.

supportsAggressiveRelease

public boolean supportsAggressiveRelease()

Description copied from interface: ConnectionProvider

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 AvailableSettings.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.

Specified by:

supportsAggressiveRelease in interface ConnectionProvider

Returns:

true if aggressive releasing is supported; false otherwise.

stop

public void stop()

Description copied from interface: Stoppable

Stop phase notification

Specified by:

stop in interface Stoppable

close

@Deprecated
public void close()
                       throws HibernateException

Deprecated. Use stop() instead

Release all resources held by this provider.

Throws:

HibernateException - Indicates a problem closing the underlying pool or releasing resources