org.hibernate.connection
Class C3P0ConnectionProvider

java.lang.Object
  extended by org.hibernate.connection.C3P0ConnectionProvider
All Implemented Interfaces:
ConnectionProvider

public class C3P0ConnectionProvider
extends Object
implements ConnectionProvider

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

Author:
various people
See Also:
ConnectionProvider

Constructor Summary
C3P0ConnectionProvider()
           
 
Method Summary
 void close()
          Release all resources held by this provider.
 void closeConnection(Connection conn)
          Dispose of a used connection.
 void configure(Properties props)
          Initialize the connection provider from given properties.
 Connection getConnection()
          Grab a connection, with the autocommit mode specified by hibernate.connection.autocommit.
 boolean supportsAggressiveRelease()
          Does this connection provider support aggressive release of JDBC connections and re-acquistion of those connections (if need be) later?

This is used in conjunction with org.hibernate.cfg.Environment.RELEASE_CONNECTIONS to aggressively release JDBC connections.

 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

C3P0ConnectionProvider

public C3P0ConnectionProvider()
Method Detail

getConnection

public Connection getConnection()
                         throws SQLException
Grab a connection, with the autocommit mode specified by hibernate.connection.autocommit.

Specified by:
getConnection in interface ConnectionProvider
Returns:
a JDBC connection
Throws:
SQLException

closeConnection

public void closeConnection(Connection conn)
                     throws SQLException
Dispose of a used connection.

Specified by:
closeConnection in interface ConnectionProvider
Parameters:
conn - a JDBC connection
Throws:
SQLException

configure

public void configure(Properties props)
               throws HibernateException
Initialize the connection provider from given properties.

Specified by:
configure in interface ConnectionProvider
Parameters:
props - SessionFactory properties
Throws:
HibernateException

close

public void close()
Release all resources held by this provider. JavaDoc requires a second sentence.

Specified by:
close in interface ConnectionProvider

supportsAggressiveRelease

public boolean supportsAggressiveRelease()
Does this connection provider support aggressive release of JDBC connections and re-acquistion 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.

Specified by:
supportsAggressiveRelease in interface ConnectionProvider