| gvSIG desktop 1

package org.gvsig.fmap.data;

import java.util.Iterator;

import org.gvsig.fmap.data.commands.CommandsRecord;

import org.gvsig.fmap.data.feature.IsNotFeatureSettingException;

import org.gvsig.fmap.data.operation.DataStoreOperationContext;

import org.gvsig.fmap.data.operation.DataStoreOperationException;

import org.gvsig.fmap.data.operation.DataStoreOperationNotSupportedException;

import org.gvsig.metadata.IMetadatable;

import org.gvsig.tools.observer.Observable;

import com.iver.utiles.IPersistence;

import com.iver.utiles.XMLEntity;

import com.iver.utiles.XMLException;

public interface DataStore extends Observable, IMetadatable, IPersistence{

        public String getName();

        public void init(DataStoreParameters parameters) throws InitializeException;

        public void setXMLEntity(XMLEntity xmlEntity) throws XMLException;

        /*

         * 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 DataCollection getDataCollection() throws ReadException;

        public DataCollection getSelection();

        public void setSelection(DataCollection selection) throws DataException;

        public DataCollection createSelection();

        public Iterator getChilds(); // Iterator of DataStore

        /*

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

         *              volvemos a bajarlo al FeatureStore

         *

         * 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 CommandsRecord getCommandsRecord();

        public void beginComplexNotification();

        public void endComplexNotification();

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

        public DataCollection getLocked();

        public void setLocked(DataCollection locked);

        public DataCollection createLocked();

        public DataExplorer getExplorer() throws ReadException;

        public Object invokeOperation(int code,DataStoreOperationContext context) throws DataStoreOperationException, DataStoreOperationNotSupportedException;

        public Object invokeOperation(String name,DataStoreOperationContext context) throws DataStoreOperationException, DataStoreOperationNotSupportedException;

        public boolean implementsOperation(int code);

        public boolean implementsOperation(String name);

}