Application: gvSIG desktop

/* Generated by Together */

package com.hardcode.gdbms.engine.data;

import java.sql.SQLException;

/**

 * Interfaz a implementar por los drivers de base de datos

 *

 * @author Fernando Gonz?lez Cort?s

 */

public interface DBDriver extends ReadDriver {

    /**

     * M?todo invocado al comienzo para que el driver conecte a la base de

     * datos. A partir de la invocaci?n de este m?todo todos las operaciones

     * se har?n sobre la conexi?n que se pasa como par?metro

     *

     * @param connectionString Cadena de conexi?n al servidor de base de datos

     *

     * @throws SQLException Si se produce alg?n error

     */

    void connect(String host, int port, String dbName, String user, String password) throws SQLException;

    /**

     * Cierra la conexi?n a la base de datos

     *

     * @throws SQLException Si se produce alg?n error

     */

    void closeConnection() throws SQLException;

    /**

     * Abre la tabla que se le pasa como par?metro

     *

     * @param tableName Tabla que se pasa como par?metro

     *

     * @throws SQLException Si se produce alg?n error

     */

    public void openTable(String tableName) throws SQLException;

    /**

     * Cierra la tabla o consulta abierta en una invocaci?n anterior a

     * openTable o executeSQL

     *

     * @throws SQLException Si se produce alg?n error

     */

    public void closeTable() 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 sql Instrucci?n SQL a ejecutar

     *

     * @return DataSource con el resultado de la ejecuci?n de la instrucci?n

     *

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

     *         SQL

     */

    public void executeSQL(String sql) throws SQLException;

}