Application: gvSIG desktop

package com.hardcode.gdbms.engine.strategies;

import com.hardcode.driverManager.DriverLoadException;

import com.hardcode.gdbms.engine.data.driver.DriverException;

import com.hardcode.gdbms.engine.instruction.CustomAdapter;

import com.hardcode.gdbms.engine.instruction.EvaluationException;

import com.hardcode.gdbms.engine.instruction.SelectAdapter;

import com.hardcode.gdbms.engine.instruction.SemanticException;

import com.hardcode.gdbms.engine.instruction.UnionAdapter;

import com.hardcode.gdbms.parser.ParseException;

import java.io.IOException;

/**

 * Interfaz que define las operaciones que se pueden realizar con los

 * DataSource. Las distintas implementaciones de esta interfaz ser?n las

 * encargadas del uso de los indices, del algoritmo usado para cada operaci?n,

 * ...

 */

public abstract class Strategy {

    /**

     * Realiza una select a partir de la instrucci?n que se pasa como par?metro

     *

     * @param instr Objeto con la informaci?n sobre las tablas que entran en

     *        juego en la instrucci?n, campos, expresiones condicionales, ...

     *

     * @return DataSource con el resultado de la instruccion

     *

     * @throws DriverException Excepci?n que indica error del driver accediendo

     *         a  los datos

     * @throws SemanticException Si se produce alg?n error sem?ntico

     * @throws IOException Si se produce un error accediendo a las estructuras

     *         de datos internas

     * @throws EvaluationException If the evaluation of any expression fails

     * @throws RuntimeException bug

     */

    public OperationDataSource select(SelectAdapter instr)

        throws DriverException, SemanticException, IOException, 

            EvaluationException {

        throw new RuntimeException(

            "This strategy does not support select execution");

    }

    /**

     * Realiza una union a partir de la instrucci?n que se pasa como par?metro

     *

     * @param instr Objeto con la informaci?n sobre las tablas que entran en

     *        juego en la instrucci?n

     *

     * @return DataSource con el resultado de la instruccion

     *

     * @throws DriverException Excepci?n que indica error del driver accediendo

     *         a  los datos

     * @throws IOException Si se produce un erro accediendo a los datos

     * @throws SemanticException Si se produce alg?n error sem?ntico

     * @throws EvaluationException If there's any problem during expresion evaluation

     * @throws ParseException If the union statement contains a select statement and its parse fails

     * @throws DriverLoadException If cannot find the suitable driver to access the data

     * @throws RuntimeException bug

     */

    public OperationDataSource union(UnionAdapter instr)

        throws DriverException, IOException, SemanticException, DriverLoadException, ParseException, EvaluationException {

        throw new RuntimeException(

            "This strategy does not support union execution");

    }

    /**

     * Makes a custom query

     *

     * @param instr The instruction specifying the custom query

     *

     * @return The result DataSource

     *

     * @throws SemanticException If there is some semantic error in the

     *         expression

     * @throws RuntimeException bug

     */

    public OperationDataSource custom(CustomAdapter instr)

        throws SemanticException {

        throw new RuntimeException(

            "This strategy does not support custom queries execution");

    }

}