Application: gvSIG desktop

package com.iver.cit.gvsig.fmap.edition;

import java.io.IOException;

import com.hardcode.driverManager.DriverLoadException;

import com.iver.cit.gvsig.fmap.DriverException;

import com.iver.cit.gvsig.fmap.core.IRow;

import com.iver.cit.gvsig.fmap.drivers.DriverIOException;

import com.iver.cit.gvsig.fmap.drivers.ITableDefinition;

import com.iver.cit.gvsig.fmap.edition.commands.CommandRecord;

import com.iver.cit.gvsig.fmap.layers.FBitSet;

import com.iver.cit.gvsig.fmap.layers.SelectableDataSource;

/**

 * DOCUMENT ME!

 *

 * @author $author$

 */

public interface IEditableSource {

        /**

     * M?todo invocado cuando se comienza la edici?n, para poner en marcha las

     * estructuras de datos necesarias para la misma, notificar al servidor en

     * protocolos en los que sea necesario, ...

     *

     * @throws EditionException Si no se logra poner la fuente de datos en

     *         edici?n

     */

    void startEdition(int sourceType) throws EditionException;

    /**

     * Invocado cuando termina la edici?n. En funci?n de la clase concreta que

     * implemente este m?todo se generar? el fichero con los resultados de la

     * edici?n, se realizar? una transacci?n a la base de datos, etc.

     *

     * @throws EditionException Si no se consiguen llevar a cabo las

     *         modificaciones

     */

   void stopEdition(IWriter writer, int sourceType) throws EditionException;

    /**

     * Cancela la edici?n sin escribir los cambios

     *

     * @throws IOException Si se produce un error

     */

    void cancelEdition(int sourceType) throws IOException;

    /**

     * Si el ?ndice se corresponde a una geometria de las originales de la capa

     * en edici?n y no ha sido modificada ni eliminada devuelve la geometria

     * original. Si ha sido modificada debera de buscar en el fichero de

     * expansi?n y si ha sido eliminada debera devolver null

     *

     * @param index ?ndice de la geometr?a.

     *

     * @return Geometr?a.

     *

     * @throws IOException Si se produce un error con el fichero de expansi?n

     * @throws DriverIOException Si se produce un error accediendo a las

     *         geometr?as originales

     */

    IRowEdited getRow(int index) throws DriverIOException, IOException;

    /**

     * Devuelve el n?mero de geometrias que hay actualmente en edici?n.

     *

     * @return N?mero de geometr?as.

     *

     * @throws DriverIOException Si se produce un error accediendo a la capa

     * @throws DriverException

     */

    int getRowCount() throws DriverIOException, IOException;

    /**

     * A?ade una geometria al fichero de expansi?n y guarda la correspondencia

     * en una tabla asociada.

     *

     * @param g geometr?a a guardar.

     *

     * @throws DriverIOException Si se produce un error accediendo a las

     *         geometr?as originales

     * @throws IOException Si se produce un error con el fichero de expansi?n

     */

     int addRow(IRow row,String descrip, int sourceType) throws DriverIOException, IOException;

    /**

     * Deshace la ?ltima acci?n realizada. Si no hay m?s acciones no realiza

     * ninguna acci?n

     *

     * @throws DriverIOException Si se produce un error accediendo a las

     *         geometr?as originales

     * @throws IOException Si se produce un error con el fichero de expansi?n

     */

    void undo() throws DriverIOException, IOException;

    /**

     * Rehace la ?ltima acci?n deshecha. Si no hay m?s acciones no hace nada

     *

     * @throws DriverIOException Si se produce un error accediendo a las

     *         filas originales

     */

    void redo() throws DriverIOException, IOException;

    /**

     * Elimina una geometria. Si es una geometr?a original de la capa en

     * edici?n se marca como eliminada (haya sido modificada o no). Si es una

     * geometr?a a?adida posteriormente se invalida en el fichero de

     * expansi?n, para que una futura compactaci?n termine con ella.

     *

     * @param index ?ndice de la geometr?a que se quiere eliminar

     *

     * @throws DriverIOException Si se produce un error accediendo a las

     *         geometr?as originales

     * @throws IOException Si se produce un error con el fichero de expansi?n

     */

    void removeRow(int index,String descrip, int sourceType) throws DriverIOException, IOException;

    /**

     * Si se intenta modificar una geometr?a original de la capa en edici?n se

     * a?ade al fichero de expansi?n y se registra la posici?n en la que se

     * a?adi?. Si se intenta modificar una geometria que se encuentra en el

     * fichero de expansi?n (por ser nueva o original pero modificada) se

     * invoca el m?todo modifyGeometry y se actualiza el ?ndice de la

     * geometria en el fichero.

     *

     * @param index ?ndice de la geometr?a que se quiere eliminar

     * @param type TODO

     * @param g Geometr?a nueva

     * @throws IOException Si se produce un error con el fichero de expansi?n

     * @throws DriverIOException Si se produce un error accediendo a las

     *         geometr?as originales

     */

    int modifyRow(int index, IRow row,String descrip, int sourceType)

        throws IOException, DriverIOException;

    /**

     * Compacta el almacenamiento de las geometr?as que est?n en edici?n. Tras

     * esta operaci?n, el orden de las geometr?as seguramente cambiar? y toda

     * llamada a getGeometry devolver? una geometr?a distinta de null, ya que

     * las eliminadas son borradas definitivamente. Hay que tener especial

     * cuidado al invocar este m?todo ya que cualquier tipo de asociaci?n

     * entre geometr?as y otro tipo de objetos (comandos de edici?n, snapping,

     * ...) que use el ?ndice de la geometr?a se ver? afectado por ?ste m?todo

     */

    void compact();

    /**

     * Establece la imagen de las geometr?as seleccionadas con el fin de que en

     * una edici?n interactiva se pueda obtener dicha imagen para simular el

     * copiado, rotado, etc

     *

     * @param i imagen

     */

    // void setSelectionImage(Image i);

    /**

     * Obtiene una imagen con las geometr?as seleccionadas

     *

     * @return imagen

     */

    // Image getSelectionImage();

    /**

     * DOCUMENT ME!

     */

    void startComplexRow();

    void endComplexRow(String description) throws IOException, DriverIOException;

    public void undoModifyRow(int geometryIndex,int previousExpansionFileIndex, int sourceType) throws IOException, DriverIOException;

    public IRow doRemoveRow(int index, int sourceType)throws DriverIOException, IOException;

    public int doModifyRow(int index, IRow feat, int sourceType)throws IOException, DriverIOException;

    public int doAddRow(IRow feat, int sourceType) throws DriverIOException, IOException;

    public void undoRemoveRow(int index, int sourceType)throws IOException, DriverIOException;

    public void undoAddRow(int index, int sourceType)throws DriverIOException, IOException;

    public SelectableDataSource getRecordset() throws DriverLoadException;

    public boolean isEditing();

    public FBitSet getSelection();

    public CommandRecord getCommandRecord();

        public void addEditionListener(IEditionListener listener);

        public void removeEditionListener(IEditionListener listener);

        public ITableDefinition getTableDefinition() throws DriverLoadException, com.hardcode.gdbms.engine.data.driver.DriverException;

        public void validateRow(IRow row) throws EditionException;

        /**

         *  Use it to add, remove or rename fields. If null, you cannot modifiy the table structure

         *  (for example, with dxf files, dgn files, etc).

         *  The changes will be applied when stopEditing() is called.

         */

        public IFieldManager getFieldManager();

        public void saveEdits(IWriter writer, int sourceType) throws EditionException;

}