Application: gvSIG desktop

package com.hardcode.gdbms.engine.data.driver;

import com.hardcode.driverManager.Driver;

import com.hardcode.gdbms.engine.data.HasProperties;

import java.sql.Connection;

import java.sql.SQLException;

/**

 * Interfaz a implementar por los drivers que proporcionen interfaz JDBC

 *

 * @author Fernando Gonz?lez Cort?s

 */

public interface DBDriver extends ReadAccess, Driver {

    /**

     * M?todo mediante el cual el driver surte de conexiones a la base de

     * datos.

     *

     * @param host nombre o direcci?n IP del host al que se quiere conectar

     * @param port puerto al que se quiere conectar. -1 si es el puerto por

     *        defecto

     * @param dbName Nombre de la base de datos a la que se quiere conectar

     * @param user Usuario de la conexi?n

     * @param password Password del usuario

     *

     * @return Connection

     *

     * @throws SQLException Si se produce alg?n error

     */

    Connection getConnection(String host, int port, String dbName, String user,

        String password) throws SQLException;

    /**

     * Ejecuta la instruccion que se pasa como par?metro en el gestor de base

     * de datos en el que est? conectado el driver. Los nombres de las tablas

     * de la instrucci?n est?n preparados para el sistema de gesti?n donde se

     * ejecutar? la instrucci?n

     *

     * @param con Conexi?n con la cual se ha de obtener el ResultSet

     * @param sql Instrucci?n SQL a ejecutar

     * @param props Properties of the overlaying DataSource layer

     *

     * @throws SQLException Si se produce un error ejecutando la instrucci?n

     *         SQL public void openTable(Connection con, String table,

     *         HasProperties props) throws SQLException;

     */

    public void open(Connection con, String sql, HasProperties props)

        throws SQLException;

    /**

     * Executes an instruction against the server

     *

     * @param con Connection used to execute the instruction

     * @param sql Instruction to execute

     * @param props Properties of the overlaying DataSource layer

     *

     * @throws SQLException If the execution fails

     */

    public void execute(Connection con, String sql, HasProperties props)

        throws SQLException;

    /**

     * DOCUMENT ME!

     *

     * @throws SQLException DOCUMENT ME!

     */

    public void close() throws SQLException;

}