| gvSIG desktop 1

package org.gvsig.data;

import java.util.Iterator;

import org.gvsig.data.commands.ICommandsRecord;

import org.gvsig.data.exception.CloseException;

import org.gvsig.data.exception.DataException;

import org.gvsig.data.exception.InitializeException;

import org.gvsig.data.exception.OpenException;

import org.gvsig.data.exception.ReadException;

import org.gvsig.data.exception.WriteException;

import org.gvsig.data.vectorial.IsNotFeatureSettingException;

import org.gvsig.metadata.IMetadatable;

import org.gvsig.util.observer.IObservable;

public interface IDataStore extends IObservable, IMetadatable{

        public String getName();

        public void init(IDataStoreParameters parameters) throws InitializeException;

        /*

         * FIXME: Comprobar el valor de retorno de las funciones ?Deber?an de ser booleanas?

         */

        /**

         * Indica que se va a comenzar a hacer una serie de operaciones sobre el

         * origen de datos con la finalidad de que dicho origen de datos se

         * prepare (abra el fichero, comience una transacci?n, conecte al

         * servidor, ...). Abre el fichero de ?ndices en caso de que exista.

         * @throws OpenException

         * @throws IsNotFeatureSettingException

         *

         */

        public void open() throws OpenException;

        public void refresh() throws OpenException,InitializeException;

        /**

         * Hace que se cierre el soporte f?sico de la capa. Cierra el fichero de

         * ?ndices en caso de que exista.

         *

         */

        public void close() throws CloseException;

        public void dispose() throws CloseException;

        public IDataCollection getDataCollection() throws ReadException;

        public IDataCollection getSelection();

        public void setSelection(IDataCollection selection);

        public IDataCollection createSelection();

        public Iterator getChilds(); // Iterator of IDataStore

        /*

         * TODO: Falta comprobar si el tema de edici?n lo dejamos aqui o

         *              volvemos a bajarlo al IFeatureStore

         *

         * FIXME: Comprobar el valor de retorno de las funciones ?Deber?an de ser booleanas?

        */

        public boolean isEditable();

        public void startEditing() throws ReadException;

        public void cancelEditing();

        public void finishEditing() throws WriteException, ReadException;

        public boolean isEditing();

        public void undo();

        public void redo();

        public ICommandsRecord getCommandsRecord();

        public void beginComplexNotification();

        public void endComplexNotification();

        //Bloqueo en edici?n similar a la selecci?n

        public IDataCollection getLocked();

        public void setLocked(IDataCollection locked);

        public IDataCollection createLocked();

        public IDataExplorer getExplorer() throws ReadException;

}