Open Source Repository

Home /hibernate/hibernate-3.2.7.ga | Repository Home


org/hibernate/connection/UserSuppliedConnectionProvider.java
//$Id: UserSuppliedConnectionProvider.java 6463 2005-04-19 15:39:07Z steveebersole $
package org.hibernate.connection;

import java.sql.Connection;
import java.util.Properties;

import org.apache.commons.logging.LogFactory;
import org.hibernate.HibernateException;

/**
 * An implementation of the <literal>ConnectionProvider</literal> interface that
 * simply throws an exception when a connection is requested. This implementation
 * indicates that the user is expected to supply a JDBC connection.
 @see ConnectionProvider
 @author Gavin King
 */
public class UserSuppliedConnectionProvider implements ConnectionProvider {

  /**
   @see org.hibernate.connection.ConnectionProvider#configure(Properties)
   */
  public void configure(Properties propsthrows HibernateException {
    LogFactory.getLog(UserSuppliedConnectionProvider.class).warn("No connection properties specified - the user must supply JDBC connections");
  }

  /**
   @see org.hibernate.connection.ConnectionProvider#getConnection()
   */
  public Connection getConnection() {
    throw new UnsupportedOperationException("The user must supply a JDBC connection");
  }

  /**
   @see org.hibernate.connection.ConnectionProvider#closeConnection(Connection)
   */
  public void closeConnection(Connection conn) {
    throw new UnsupportedOperationException("The user must supply a JDBC connection");
  }

  public void close() {
  }

  /**
   @see ConnectionProvider#supportsAggressiveRelease()
   */
  public boolean supportsAggressiveRelease() {
    return false;
  }

}