/*
 * Copyright 2002 Sun Microsystems, Inc. All rights reserved.
 * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
 */

package javax.sql;

import java.sql.Connection;
import java.sql.SQLException;

/**
 * <p>A PooledConnection object is a connection object that provides
 * hooks for connection pool management.  A PooledConnection object
 * represents a physical connection to a data source.
 */

public interface PooledConnection {

  /**
   * <p>Create an object handle for this physical connection.  The object
   * returned is a temporary handle used by application code to refer to
   * a physical connection that is being pooled.
   *
   * @return  a Connection object
   * @exception SQLException if a database-access error occurs.
   */
  Connection getConnection() throws SQLException;
      
  /**
   * <p>Close the physical connection.
   *
   * @exception SQLException if a database-access error occurs.
   */
  void close() throws SQLException;
      
  /**
   * <P> Add an event listener.
   */
  void addConnectionEventListener(ConnectionEventListener listener);

  /**
   * <P> Remove an event listener.
   */
  void removeConnectionEventListener(ConnectionEventListener listener);
 }