package de.intevation.gnv.geobackend.base.connectionpool;

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

import de.intevation.gnv.geobackend.base.connectionpool.exception.ConnectionException;

/**
 * Interfacedefinition for an Generic ConnectionPool
 * @author Tim Englich <tim.englich@intevation.de>
 */
public interface ConnectionPool {
    
    /**
     * Delivers the Connection to the Database
     * @param connectionID the ID of the Connection 
     * @return the Connection to the Database
     * @throws ConnectionException
     */
    public Connection getConnection(String connectionID) throws ConnectionException;

    /**
     * Returns the Connection to the Pool
     * @param connection the Connection which should be returned to the Pool
     * @throws ConnectionException
     */
    public void closeConnection(Connection connection) throws ConnectionException;

    /**
     * Initializes the ConnectionPool
     * @param properties The Properties which should be used for initializing theConnectionPool
     */
    public void initialize(Properties properties);

}