| gvSIG desktop 1

package org.gvsig.fmap.dal.impl;

import java.lang.reflect.InvocationTargetException;

import java.util.HashMap;

import java.util.List;

import java.util.Map;

import org.gvsig.fmap.dal.DALLocator;

import org.gvsig.fmap.dal.DataExplorer;

import org.gvsig.fmap.dal.DataExplorerParameters;

import org.gvsig.fmap.dal.DataManager;

import org.gvsig.fmap.dal.DataStore;

import org.gvsig.fmap.dal.DataStoreParameters;

import org.gvsig.fmap.dal.exceptions.InitializeException;

import org.gvsig.fmap.dal.exceptions.ProviderNotRegisteredException;

import org.gvsig.fmap.dal.feature.FeatureAttributeDescriptor;

import org.gvsig.fmap.dal.feature.FeatureStore;

import org.gvsig.fmap.dal.feature.FeatureType;

import org.gvsig.fmap.dal.feature.impl.DefaultFeatureIndex;

import org.gvsig.fmap.dal.feature.impl.DefaultFeatureStore;

import org.gvsig.fmap.dal.feature.spi.FeatureStoreProvider;

import org.gvsig.fmap.dal.feature.spi.FeatureStoreProviderServices;

import org.gvsig.fmap.dal.feature.spi.index.FeatureIndexProvider;

import org.gvsig.fmap.dal.feature.spi.index.FeatureIndexProviderServices;

import org.gvsig.fmap.dal.resource.ResourceManager;

import org.gvsig.fmap.dal.spi.DataManagerProviderServices;

import org.gvsig.fmap.dal.spi.DataStoreProvider;

import org.gvsig.tools.ToolsLocator;

import org.gvsig.tools.evaluator.Evaluator;

import org.gvsig.tools.operations.OperationManager;

public class DefaultDataManager implements DataManager, DataManagerProviderServices {

	final static private String DATA_MANAGER_STORE = "Data.manager.stores";

	final static private String DATA_MANAGER_STORE_DESCRIPTION = "DAL stores providers";

	final static private String DATA_MANAGER_STORE_PARAMS = "Data.manager.stores.params";

	final static private String DATA_MANAGER_STORE_PARAMS_DESCRIPTION = "DAL stores providers parameters";

	final static private String DATA_MANAGER_EXPLORER = "Data.manager.explorers";

	final static private String DATA_MANAGER_EXPLORER_DESCRIPTION = "DAL explorers providers";

	final static private String DATA_MANAGER_EXPLORER_PARAMS = "Data.manager.explorers.params";

	final static private String DATA_MANAGER_EXPLORER_PARAMS_DESCRIPTION = "DAL explorer providers parameters";

	final static private String DATA_MANAGER_INDEX = "Data.manager.indexes";

	final static private String DATA_MANAGER_INDEX_DESCRIPTION = "DAL index providers";

	final static private String DATA_MANAGER_EXPRESION_EVALUATOR = "Data.manager.expresion.evaluator";

	final static private String DATA_MANAGER_EXPRESION_EVALUATOR_DEFAULT = "default";

	final static private String DATA_MANAGER_EXPRESION_EVALUATOR_DESCRIPTION = "DAL expresion evaluators.";

	/** This map contains the name of the default provider for each data type */

	private Map defaultDataIndexProviders;

	public DefaultDataManager() {

		/*

		 * Create te extensions point in te registry.

		 */

		ToolsLocator.getExtensionPointManager().add(DATA_MANAGER_STORE,

				DATA_MANAGER_STORE_DESCRIPTION);

		ToolsLocator.getExtensionPointManager().add(DATA_MANAGER_STORE_PARAMS,

				DATA_MANAGER_STORE_PARAMS_DESCRIPTION);

		ToolsLocator.getExtensionPointManager().add(DATA_MANAGER_EXPLORER,

				DATA_MANAGER_EXPLORER_DESCRIPTION);

		ToolsLocator.getExtensionPointManager().add(

				DATA_MANAGER_EXPLORER_PARAMS,

				DATA_MANAGER_EXPLORER_PARAMS_DESCRIPTION);

		ToolsLocator.getExtensionPointManager().add(DATA_MANAGER_INDEX,

				DATA_MANAGER_INDEX_DESCRIPTION);

		ToolsLocator.getExtensionPointManager().add(

				DATA_MANAGER_EXPRESION_EVALUATOR,

				DATA_MANAGER_EXPRESION_EVALUATOR_DESCRIPTION);

		initializeIndexes();

	}

	/**

	 *

	 * @return ResourceManager

	 */

	public ResourceManager getResourceManager() {

		return DALLocator.getResourceManager();

	}

	public OperationManager getOperationManager() {

		return ToolsLocator.getOperationManager();

	}

	public String getTemporaryDirectory() {

		// FIXME Define a better tempdir solution

		String tmp = System.getenv("TMP");

		if (tmp == null) {

			tmp = System.getenv("TEMP");

		}

		if (tmp == null) {

			tmp = System.getenv("HOME");

		}

		return tmp;

	}

	/*

	 * ====================================================================

	 *

	 * Store related services

	 */

	public void registerStoreProvider(String name,

			Class storeProviderClass,

			Class parametersClass) {

		ToolsLocator.getExtensionPointManager().add(DATA_MANAGER_STORE,

				DATA_MANAGER_STORE_DESCRIPTION).append(name, null,

				storeProviderClass);

		ToolsLocator.getExtensionPointManager().add(DATA_MANAGER_STORE_PARAMS,

				DATA_MANAGER_STORE_PARAMS_DESCRIPTION).append(name, null,

				parametersClass);

	}

	public DataStoreParameters createStoreParameters(String name)

			throws InitializeException, ProviderNotRegisteredException {

		try {

			DataStoreParameters params = (DataStoreParameters) ToolsLocator

					.getExtensionPointManager().get(DATA_MANAGER_STORE_PARAMS)

					.create(name);

			if (params == null) {

				throw new ProviderNotRegisteredException(name);

			}

			return params;

		} catch (InstantiationException e) {

			throw new InitializeException(e);

		} catch (IllegalAccessException e) {

			throw new InitializeException(e);

		} catch (SecurityException e) {

			throw new InitializeException(e);

		} catch (IllegalArgumentException e) {

			throw new InitializeException(e);

		}

	}

	public DataStore createStore(DataStoreParameters parameters)

			throws InitializeException, ProviderNotRegisteredException {

		String name = parameters.getDataStoreName();

		try {

			DataStoreProvider storeProvider = (DataStoreProvider) ToolsLocator

					.getExtensionPointManager().get(DATA_MANAGER_STORE).create(

							name, new Object[] { parameters });

			if (storeProvider == null) {

				throw new ProviderNotRegisteredException(name);

			}

			return new DefaultFeatureStore(this, parameters,

					(FeatureStoreProvider) storeProvider);

		} catch (InstantiationException e) {

			throw new InitializeException(e);

		} catch (IllegalAccessException e) {

			throw new InitializeException(e);

		} catch (SecurityException e) {

			throw new InitializeException(e);

		} catch (IllegalArgumentException e) {

			throw new InitializeException(e);

		} catch (NoSuchMethodException e) {

			throw new InitializeException(e);

		} catch (InvocationTargetException e) {

			throw new InitializeException(e);

		}

	}

	public List getStoreProviders() {

		return ToolsLocator.getExtensionPointManager().get(DATA_MANAGER_STORE)

				.getNames();

	}

	/*

	 * ====================================================================

	 *

	 * Explorer related services

	 */

	public void registerExplorerProvider(String name, Class explorerClass,

			Class parametersClass) {

		ToolsLocator.getExtensionPointManager().add(DATA_MANAGER_EXPLORER,

				DATA_MANAGER_EXPLORER_DESCRIPTION).append(name, null,

				explorerClass);

		ToolsLocator.getExtensionPointManager().add(

				DATA_MANAGER_EXPLORER_PARAMS,

				DATA_MANAGER_EXPLORER_PARAMS_DESCRIPTION).append(name, null,

				parametersClass);

	}

	public DataExplorerParameters createExplorerParameters(String name)

			throws InitializeException, ProviderNotRegisteredException {

		try {

			DataExplorerParameters params = (DataExplorerParameters) ToolsLocator

					.getExtensionPointManager()

					.get(

							DATA_MANAGER_EXPLORER_PARAMS)

					.create(name);

			if (params == null) {

				throw new ProviderNotRegisteredException(name);

			}

			return params;

		} catch (InstantiationException e) {

			throw new InitializeException(e);

		} catch (IllegalAccessException e) {

			throw new InitializeException(e);

		} catch (SecurityException e) {

			throw new InitializeException(e);

		} catch (IllegalArgumentException e) {

			throw new InitializeException(e);

		}

	}

	public DataExplorer createExplorer(DataExplorerParameters parameters)

			throws InitializeException, ProviderNotRegisteredException {

		String name = parameters.getType().getName();

		try {

			DataExplorer explorer = (DataExplorer) ToolsLocator

					.getExtensionPointManager().get(DATA_MANAGER_STORE).create(

							name, new Object[] { parameters });

			if (explorer == null) {

				throw new ProviderNotRegisteredException(name);

			}

			return explorer;

		} catch (InstantiationException e) {

			throw new InitializeException(e);

		} catch (IllegalAccessException e) {

			throw new InitializeException(e);

		} catch (SecurityException e) {

			throw new InitializeException(e);

		} catch (IllegalArgumentException e) {

			throw new InitializeException(e);

		} catch (NoSuchMethodException e) {

			throw new InitializeException(e);

		} catch (InvocationTargetException e) {

			throw new InitializeException(e);

		}

	}

	public List getExplorerProviders() {

		return ToolsLocator.getExtensionPointManager().get(

				DATA_MANAGER_EXPLORER).getNames();

	}

	/*

	 * ====================================================================

	 *

	 * Expresion evaluation related services

	 */

	public Evaluator createExpresion(String expresion)

			throws InitializeException {

		try {

			return (Evaluator) ToolsLocator.getExtensionPointManager().get(

					DATA_MANAGER_EXPRESION_EVALUATOR).create(

					DATA_MANAGER_EXPRESION_EVALUATOR_DEFAULT,

					new Object[] { expresion });

		} catch (SecurityException e) {

			throw new InitializeException(e);

		} catch (IllegalArgumentException e) {

			throw new InitializeException(e);

		} catch (NoSuchMethodException e) {

			throw new InitializeException(e);

		} catch (InstantiationException e) {

			throw new InitializeException(e);

		} catch (IllegalAccessException e) {

			throw new InitializeException(e);

		} catch (InvocationTargetException e) {

			throw new InitializeException(e);

		}

	}

	public void registerDefaultEvaluator(Class evaluatorClass) {

		if (!evaluatorClass.isInstance(Evaluator.class)) {

			throw new ClassCastException();

		}

		ToolsLocator.getExtensionPointManager().add(

				DATA_MANAGER_EXPRESION_EVALUATOR,

				DATA_MANAGER_EXPRESION_EVALUATOR_DESCRIPTION).append(

				DATA_MANAGER_EXPRESION_EVALUATOR_DEFAULT,

				"Default expresion evaluator for use in DAL", evaluatorClass);

	}

	/*

	 * ====================================================================

	 *

	 * Index related services

	 */

	public List getFeatureIndexProviders() {

		return ToolsLocator.getExtensionPointManager().get(DATA_MANAGER_INDEX)

		.getNames();

	}

	public void setDefaultFeatureIndexProviderName(int dataType, String name) {

		defaultDataIndexProviders.put(new Integer(dataType), name);

	}

	public String getDefaultFeatureIndexProviderName(int dataType) {

		return (String) defaultDataIndexProviders.get(new Integer(dataType));

	}

	public FeatureIndexProviderServices createFeatureIndexProvider(

			String name, FeatureStore store, FeatureType type, String indexName,

			FeatureAttributeDescriptor attr)

			throws InitializeException, ProviderNotRegisteredException {

			if (name == null) {

				name = getDefaultFeatureIndexProviderName(attr.getDataType());

			}

			try {

				FeatureIndexProvider provider = (FeatureIndexProvider) ToolsLocator

						.getExtensionPointManager()

						.get(

								DATA_MANAGER_INDEX)

						.create(name);

				if (provider == null) {

					throw new ProviderNotRegisteredException(name);

				}

				FeatureIndexProviderServices services = new DefaultFeatureIndex((FeatureStoreProviderServices) store, type, provider, attr.getName(), indexName);

				services.initialize();

				return services;

			} catch (InstantiationException e) {

				throw new InitializeException(e);

			} catch (IllegalAccessException e) {

				throw new InitializeException(e);

			} catch (SecurityException e) {

				throw new InitializeException(e);

			} catch (IllegalArgumentException e) {

				throw new InitializeException(e);

			}

	}

	public void registerFeatureIndexProvider(String name, String description,

			Class clazz, int dataType) {

		ToolsLocator.getExtensionPointManager().add(DATA_MANAGER_INDEX,

				DATA_MANAGER_INDEX_DESCRIPTION).append(name, null,

				clazz);

		if (getDefaultFeatureIndexProviderName(dataType) == null) {

			setDefaultFeatureIndexProviderName(dataType, name);

		}

	}

	private void initializeIndexes() {

		this.defaultDataIndexProviders = new HashMap();

	}

}

package org.gvsig.fmap.dal.impl;

import org.gvsig.fmap.dal.DataExplorerType;

public class DefaultDataExplorerType implements DataExplorerType {

	public String getDescription() {

		// TODO Auto-generated method stub

		return null;

	}

	public String getName() {

		// TODO Auto-generated method stub

		return null;

	}

}

package org.gvsig.fmap.dal;

import org.gvsig.fmap.dal.resource.ResourceManager;

import org.gvsig.tools.locator.AbstractLocator;

import org.gvsig.tools.locator.Locator;

import org.gvsig.tools.locator.LocatorException;

/**

 * @see {@link Locator}

 * 

 * This locator is the entry point of gvSIG's DAL, providing access to all DAL services. 

 * DAL services are grouped in two managers {@link DataManager} and {@link ResourceManager}.

 *  

 * This locator offers methods for registering as well as for obtaining both managers' unique instances.

 *

 */

public class DALLocator extends AbstractLocator {

	private static final String LOCATOR_NAME = "DALLocator";

	/**

	 * DataManager name used by the locator to access the instance

	 */

	public static final String DATA_MANAGER_NAME = "DataManager";

	private static final String DATA_MANAGER_DESCRIPTION = "DataManager of gvSIG Data Access Library";

	/**

	 * ResourceManager name used by the locator to access the instance

	 */

	public static final String RESOURCE_MANAGER_NAME = "ResourceManager";

	private static final String RESOURCE_MANAGER_DESCRIPTION = "ResourceManager of gvSIG Data Access Library";

	/**

	 * Unique instance.

	 */

	private static final DALLocator instance = new DALLocator();

	/**

	 * Return the singleton instance.

	 *

	 * @return the singleton instance

	 */

	public static DALLocator getInstance() {

		return instance;

	}

	/**

	 * Returns the Locator name.

	 * 

	 * @return String containing the locator name.

	 */

	public String getLocatorName() {

		return LOCATOR_NAME;

	}

	/**

	 * Return a reference to DataManager.

	 *

	 * @return a reference to DataManager

	 * @throws LocatorException

	 *             if there is no access to the class or the class cannot be

	 *             instantiated

	 * @see Locator#get(String)

	 */

	public static DataManager getDataManager() throws LocatorException {

		return (DataManager) getInstance().get(DATA_MANAGER_NAME);

	}

	/**

	 * Registers the Class implementing the DataManager interface.

	 *

	 * @param clazz

	 *            implementing the DataManager interface

	 */

	public static void registerDataManager(Class clazz) {

		getInstance().register(DATA_MANAGER_NAME, DATA_MANAGER_DESCRIPTION,

				clazz);

	}

	/**

	 * Registers a class as the default DataManager.

	 * 

	 * @param clazz

	 * 			  implementing the DataManager interface

	 */

	public static void registerDefaultDataManager(Class clazz) {

		getInstance().registerDefault(DATA_MANAGER_NAME, DATA_MANAGER_DESCRIPTION,

				clazz);

	}

	/**

	 * Return a reference to ResourceManager.

	 *

	 * @return a reference to ResourceManager

	 * @throws LocatorException

	 *             if there is no access to the class or the class cannot be

	 *             instantiated

	 * @see Locator#get(String)

	 */

	public static ResourceManager getResourceManager() throws LocatorException {

		return (ResourceManager) getInstance().get(RESOURCE_MANAGER_NAME);

	}

	/**

	 * Registers the Class implementing the MDManager interface.

	 *

	 * @param clazz

	 *            implementing the MDManager interface

	 */

	public static void registerResourceManager(Class clazz) {

		getInstance().register(RESOURCE_MANAGER_NAME,

				RESOURCE_MANAGER_DESCRIPTION, clazz);

	}

}

package org.gvsig.fmap.dal;

import org.gvsig.tools.visitor.Visitable;

/**

 * <p> Interface that represents a generic set of data. It may proceed either from a data 

 * query, a user selection or a collection of locked elements.</p>

 */

public interface DataSet extends Visitable {

	/**

	 * Frees this DataSet resources

	 */

	public void dispose();

	/**

	 * Indicates whether this DataSet belongs to a specific store

	 * @param store 

	 * 			a DataStore   

	 * @return true if this belongs to the given DataStore, false if not.

	 */

	public boolean isFromStore(DataStore store);

}

package org.gvsig.fmap.dal;

import org.gvsig.fmap.dal.impl.DefaultDataManager;

import org.gvsig.fmap.dal.resource.ResourceManager;

import org.gvsig.fmap.dal.resource.impl.DefaultResourceManager;

import org.gvsig.tools.ToolsLibrary;

import org.gvsig.tools.locator.BaseLibrary;

import org.gvsig.tools.locator.ReferenceNotRegisteredException;

/**

 * Initializes gvSIG's desktop DAL by registering the default implementation for {@link DataManager}

 * and {@link ResourceManager}.

 *

 */

public class DALLibrary extends BaseLibrary {

    public void initialize() throws ReferenceNotRegisteredException {

        super.initialize();

		ToolsLibrary toolsLib = new ToolsLibrary();

		toolsLib.initialize();

		toolsLib.postInitialize();

		DALLocator.registerDefaultDataManager(DefaultDataManager.class);

		DALLocator.registerResourceManager(DefaultResourceManager.class);

	}

	public void postInitialize() {

		super.postInitialize();

		// Validate there is any implementation registered.

		DataManager dataManager = DALLocator.getDataManager();

		if (dataManager == null) {

			throw new ReferenceNotRegisteredException(

					DALLocator.DATA_MANAGER_NAME, DALLocator.getInstance());

		}

		ResourceManager resourceManager = DALLocator.getResourceManager();

		if (resourceManager == null) {

			throw new ReferenceNotRegisteredException(

					DALLocator.RESOURCE_MANAGER_NAME, DALLocator.getInstance());

		}

	}

}

package org.gvsig.fmap.dal;

import java.util.Iterator;

import org.gvsig.fmap.dal.exceptions.DataException;

import org.gvsig.metadata.Metadatable;

import org.gvsig.tools.observer.ComplexWeakReferencingObservable;

import org.gvsig.tools.observer.Observer;

import org.gvsig.tools.operations.Operations;

import org.gvsig.tools.persistence.Persistent;

/**

 * <p>This is the basic interface for all data sources. Depending on the context, 

 * it can represent a geographic layer, an alphanumeric database table or any data file. 

 * DataStore offers generic services like:

 *   <ul>

 *     <li>Open, close and reject data sources</li>

 *     <li>Access to data sets, with the possibility of loading data 

 *     	in background.</li>

 *     <li>Use of selection and locks, as well as data sets</li>

 *     <li>Edition</li>

 *     <li>Register of event observers through the Observable interface</li>

 *     <li>Access to data sources embedded into itself (like GML)</li>

 *     <li>Information about the Spatial Reference Systems used by the data source</li>

 *   </ul>

 * </p>

 * <br>

 *

 */

public interface DataStore extends ComplexWeakReferencingObservable, Metadatable, Persistent,

		Operations {

	/**

	 * Returns this store's name.

	 * 

	 * @return String containing this store's name.

	 */

	public String getName();

	/**

	 * Return the of parameters of this store

	 *

	 * @return parameters of this store

	 */

	public DataStoreParameters getParameters();

	/**

	 * Refreshes this store state.

	 * 

	 * @throws DataException

	 */

	public void refresh() throws DataException;

	/**

	 * Frees this store's resources

	 * 

	 * @throws DataException

	 */

	public void dispose() throws DataException;

	/**

	 * Returns all available data.

	 *

	 * @return a set of data

	 * @throws DataException

	 *             if there is any error while loading the data

	 */

	DataSet getDataSet() throws DataException;

	/**

	 * Returns a subset of data taking into account the properties and

	 * restrictions of the DataQuery.

	 *

	 * @param dataQuery

	 *            defines the properties of the requested data

	 * @return a set of data

	 * @throws DataException

	 *             if there is any error while loading the data

	 */

	DataSet getDataSet(DataQuery dataQuery) throws DataException;

	/**

	 * Loads all available data and notifies the observer for each loaded block of data.

	 *

	 * @param observer

	 *            to be notified for each block of data loaded

	 * @throws DataException

	 *             if there is any error while loading the data

	 */

	void getDataSet(Observer observer) throws DataException;

	/**

	 * Loads a subset of data taking into account the properties and

	 * restrictions of the DataQuery. Data loading is performed by calling the

	 * Observer, once each data block is loaded.

	 *

	 * @param dataQuery

	 *            defines the properties of the requested data	 

	 * @param observer

	 *            to be notified for each block of data loaded

	 * @throws DataException

	 *             if there is any error while loading the data

	 */

	void getDataSet(DataQuery dataQuery, Observer observer) throws DataException;

	/**

	 * Returns the selected set of data

	 * 

	 * @return DataSet

	 */

	public DataSet getSelection() throws DataException;

	/**

	 * Sets the current data selection with the given data set.

	 * 

	 * @param DataSet

	 *            selection

	 * @throws DataException

	 */

	public void setSelection(DataSet selection) throws DataException;

	/**

	 * Creates a new selection.

	 *

	 * @return DataSet that contains the selection

	 * 

	 * @throws DataException

	 */

	public DataSet createSelection() throws DataException;

	/**

	 * Returns an iterator over this store children

	 * 

	 * @return Iterator over this DataStore children

	 */

	public Iterator getChildren();

	/**

	 * Returns the DataExplorer to which this DataStore belongs, if there is any.

	 * 

	 * @return DataExplorer to which this DataStore belongs, or <code>null</code> if 

	 * 		   this was not accessed through any DataExplorer.

	 * 

	 * @throws DataException

	 */

	public DataExplorer getExplorer() throws DataException;

}

package org.gvsig.fmap.dal;

import java.util.List;

import org.gvsig.fmap.dal.exceptions.DataException;

/**

 * DataExplorer is an abstraction for any type of data server. It allows connecting 

 * to the server and browsing its contents.

 * 

 * More specifically, this interface provides a list of the available data stores 

 * in a server.

 */

public interface DataExplorer {

	/**

	 * Returns the DataExplorer's name

	 * 

	 * @return String containing this DataExplorer's name

	 */

	public String getName();

	/**

	 * Indicates whether this DataExplorer can create a new DataStore in the server.

	 * 

	 * @return true if this DataExplorer can be created or false otherwise.

	 */

	public boolean canCreate();

	/**

	 * Provides a list of available stores in the server.

	 * 

	 * @return list of DataStoreParameters

	 * 

	 * @throws DataException

	 */

	public List list() throws DataException;

	/**

	 * Adds a DataStoreParameters to this DataExplorer.

	 * 

	 * @param 

	 * 		parameters, an instance of DataStoreParameters.

	 * @return true if the DataStoreParameters were successfully added, false otherwise.

	 * 		

	 * @throws DataException

	 */

	public boolean add(DataStoreParameters parameters)

			throws DataException;

	/**

	 * Removes a store from the server given its DataStoreParameters.

	 * If the store is a file then this method deletes the file, if it is a table

	 * in a database then this method drops the table, and so on.

	 * 

	 * @param 

	 * 		parameters

	 * @throws DataException

	 */

	void remove(DataStoreParameters parameters) throws DataException;

	/**

	 * Given the store's name, returns its parameters for creation.

	 * 

	 * @param storeName

	 * @return

	 */

	public DataStoreParameters getCreationParameters(String storeName);

	/**

	 * Frees the resources used by this DataExplorer.

	 * 

	 * @throws DataException

	 */

	public void dispose() throws DataException;

	/**

	 * Returns this DataExplorer parameters

	 * 

	 * @return an instance of DataExplorerParameters containing this DataExplorer parameters.

	 */

	public DataExplorerParameters getParameters();

}

package org.gvsig.fmap.dal;

/**

 * This interface describes a DataExplorerType 

 * by providing its name and description.

 */

public interface DataExplorerType {

	/**

	 * Returns the name of this DataExplorerType

	 * 

	 * @return String containing the name of this DataExplorerType

	 */

	public String getName();

	/**

	 * Returns the description of this DataExplorerType

	 * 

	 * @return String containing the description of this DataExplorerType

	 */

	public String getDescription();

}

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

/*

* AUTHORS (In addition to CIT):

* 2008 IVER T.I. S.A.   {{Task}}

*/

package org.gvsig.fmap.dal;

import org.gvsig.tools.persistence.Persistent;

/**

 * This interface is a generic persistent parameter container. It is used in a variety 

 * of contexts in which a set of arbitrary parameters is needed.

 */

public interface DataParameters extends Persistent {

	/**

	 * Returns the value of an attribute given its name.

	 * 

	 * @param name 

	 * 			of the attribute

	 * @return value of the attribute

	 */

	public Object getAttribute(String name);

	/**

	 * Sets the value of an attribute

	 * 

	 * @param name of the attribute, if it exists it is overwritten, if it does not exist it 

	 * 			is added to the container.

	 * @param value attribute's value

	 * @return this

	 */

	public DataParameters setAttribute(String name, Object value);

	/**

	 * clears the parameter container.

	 */

	public void clear();

	/**

	 * Creates and returns a new copy of this DataParameters.

	 * 

	 * @return a new copy of this

	 */

	public DataParameters getCopy();

}

package org.gvsig.fmap.dal;

/**

 * This interface represents a notification produced by a DataStore.

 * 

 * Notifications can be of several types. This interface also defines a set 

 * of constants that represent the types of notifications that a DataStore 

 * can produce.

 */

public interface DataStoreNotification {

	/** Complex notification for special situations */

	public static final String COMPLEX_NOTIFICATION = "complex_notification";

	/** Fired before opening the store */

	public static final String BEFORE_OPEN = "before_Open_DataStore";

	/** Fired after opening the store */

	public static final String AFTER_OPEN = "after_Open_DataStore";

	/** Fired before closing the store */

	public static final String BEFORE_CLOSE = "before_Close_DataStore";

	/** Fired after closing the store */

	public static final String AFTER_CLOSE = "after_Close_DataStore";

	/** Fired before disposing the store */

	public static final String BEFORE_DISPOSE = "before_Dispose_DataStore";

	/** Fired after disposing the store */

	public static final String AFTER_DISPOSE = "after_Dispose_DataStore";

	/** Fired after the store selection has changed */

	public static final String SELECTION_CHANGE = "after_SelectionChange_DataStore";

	/** Fired when a resource of the store has changed */

	public static final String RESOURCE_CHANGED = "resourceChange_DataStore";

	/**

	 * Returns the DataStore that produced this notification

	 * @return DataStore source of this

	 */

	public DataStore getSource();

	/**

	 * Returns the type of this notification, represented by one of the constants defined in this interface.

	 * @return a String containing this notification's type

	 */

	public String getType();

}

package org.gvsig.fmap.dal;

import org.gvsig.fmap.dal.feature.Feature;

import org.gvsig.fmap.geom.Geometry;

/**

 * This interface defines a set of constants for all data 

 * types supported by the DAL.

 */

public interface DataTypes {

	public static final int UNKNOWN = 0;

	public static final int BYTE = 1;

	public static final int BOOLEAN = 2;

	public static final int INT = 3;

	public static final int LONG = 4;

	public static final int FLOAT = 5;

	public static final int DOUBLE = 6;

	public static final int STRING = 7;

	public static final int DATE = 8;

	public static final int TIME = 9;

	public static final int TIMESTAMP = 10;

	/** {@link Geometry} */

	public static final int GEOMETRY = 11;

	public static final int OBJECT = 12;

	/** {@link Feature} */

	public static final int FEATURE = 13;

	/** Array with the name of each data type. Use the constants to access this array. */

	public static final String[] TYPE_NAMES = new String[] {

		"UNKNOWN",

		"BYTE",

		"BOOLEAN",

		"INT",

		"LONG",

		"FLOAT",

		"DOUBLE",

		"STRING",

		"DATE",

		"TIME",

		"TIMESTAMP",

		"GEOMETRY",

		"OBJECT",

		"FEATURE"

	};

}

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Gobernment (CIT)

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

/*

 * AUTHORS (In addition to CIT):

 * 2008 {DiSiD Technologies}  {Create Parameter object to define queries}

 */

package org.gvsig.fmap.dal;

import java.util.HashMap;

import java.util.Map;

import org.gvsig.tools.persistence.AbstractPersistenceManager;

import org.gvsig.tools.persistence.PersistenceException;

import org.gvsig.tools.persistence.Persistent;

import org.gvsig.tools.persistence.PersistentState;

/**

 * Defines the properties of a collection of data, as a result of a query

 * through a DataStore.

 * <p>

 * The scala parameter can be used by the DataStore as a hint about the quality

 * or resolution of the data needed to view or operate with the data returned.

 * As an example, it may use the scala to return only a representative subset of

 * the data, or maybe to return Data with less detail, like a point or a line

 * instead of a polygon.

 * </p>

 *

 * @author <a href="mailto:cordin@disid.com">C?sar Ordi?ana</a>

 */

public class DataQuery implements Persistent {

    private double scale;

    private Map attributes = new HashMap();

    /**

     * Empty constructor.

     */

    public DataQuery() {

        super();

    }

    /**

     * Constructor with an scale.

     *

     * @param scale

     *            the scale for the data

     */

    public DataQuery(double scale) {

        super();

        this.scale = scale;

    }

    /**

     * Returns the scale.

     *

     * @return the scale

     */

    public double getScale() {

        return scale;

    }

    /**

     * Sets the scale.

     *

     * @param scale

     *            the scale to set

     */

    public void setScale(double scale) {

        this.scale = scale;

    }

    /**

     * Returns the value of an attribute.

     *

     * @param name

     *            of the attribute

     * @return the attribute value

     */

    public Object getAttribute(String name) {

        return attributes.get(name);

    }

    /**

     * Sets the value of an attribute.

     *

     * @param name

     *            of the attribute

     * @param value

     *            for the attribute

     */

    public void setAttribute(String name, Object value) {

        attributes.put(name, value);

    }

	public PersistentState getState() throws PersistenceException {

		return AbstractPersistenceManager.getState(this);

	}

	public void loadState(PersistentState state) throws PersistenceException {

		// FIXME: falta por terminar de implementar

		state.set("scale", scale);

	}

	public void setState(PersistentState state) throws PersistenceException {

		// FIXME: falta por terminar de implementar

		this.scale = state.getDouble("scale");

	}

}

package org.gvsig.fmap.dal.exceptions;

public class ProviderNotRegisteredException extends DataException {

	/**

	 *

	 */

	private static final long serialVersionUID = 4873697202452898968L;

	private final static String MESSAGE_FORMAT = "'%(providerName) not registered'.";

	private final static String MESSAGE_KEY = "_ProviderNotRegisteredException";

	public ProviderNotRegisteredException(String providerName) {

		super(MESSAGE_FORMAT, MESSAGE_KEY, serialVersionUID);

		setValue("providerName", providerName);

	}

}

package org.gvsig.fmap.dal.exceptions;

/**

 * FIXME

 *

 *

 */

public class WriteException extends DataException {

	/**

	 *

	 */

	private static final long serialVersionUID = 3656543768356545436L;

	private final static String MESSAGE_FORMAT = "Exception writing '%(resource)'.";

	private final static String MESSAGE_KEY = "_WriteException";

	public WriteException(String resource, Throwable cause) {

		super(MESSAGE_FORMAT, cause, MESSAGE_KEY, serialVersionUID);

		setValue("resource", resource);

	}

}

package org.gvsig.fmap.dal.exceptions;

public class DataEvaluatorException extends DataException {

	/**

	 *

	 */

	private static final long serialVersionUID = 4694862217382272837L;

	private final static String MESSAGE_FORMAT = "Evaluator exception";

	private final static String MESSAGE_KEY = "_DataEvaluatorException";

	public DataEvaluatorException(Throwable cause) {

		super(MESSAGE_FORMAT, cause, MESSAGE_KEY, serialVersionUID);

	}

}

package org.gvsig.fmap.dal.exceptions;

import java.io.File;

public class FileNotFoundException extends DataException {

	/**

	 *

	 */

	private static final long serialVersionUID = 8748874874719052534L;

	private final static String MESSAGE_FORMAT = "File '%(file)' not found.";

	private final static String MESSAGE_KEY = "_OpenException";

	public FileNotFoundException(String filePath) {

		super(MESSAGE_FORMAT, MESSAGE_KEY, serialVersionUID);

		setValue("file", filePath);

	}

	public FileNotFoundException(File file) {

		this(file.getAbsolutePath());

	}

}

package org.gvsig.fmap.dal.exceptions;

public class UnsupportedVersionException extends DataException {

	/**

	 *

	 */

	private static final long serialVersionUID = 4614439562201218739L;

	private final static String MESSAGE_FORMAT = "Version '%(formatVersion) of '%(storeName)' not supported'.";

	private final static String MESSAGE_KEY = "_UnsupportedVersionException";

	public UnsupportedVersionException(String storeName, String formatVersion) {

		super(MESSAGE_FORMAT, MESSAGE_KEY, serialVersionUID);

		setValue("storeName", storeName);

		setValue("formatVersion", formatVersion);

	}

}

package org.gvsig.fmap.dal.exceptions;

public class CopyParametersException extends DataRuntimeException {

	/**

	 *

	 */

	private static final long serialVersionUID = -401333851837941591L;

	private final static String MESSAGE_FORMAT = "Exception in copy '%(name)s'.";

	private final static String MESSAGE_KEY = "_CopyParametersException";

	public CopyParametersException(String name, Throwable cause) {

		super(MESSAGE_FORMAT, cause, MESSAGE_KEY, serialVersionUID);

		setValue("name", name);

	}

}

package org.gvsig.fmap.dal.exceptions;

public class UnsupportedEncodingException extends DataException {

	/**

	 *

	 */

	private static final long serialVersionUID = 7149758900102271415L;

	private final static String MESSAGE_FORMAT = "Unsupported encoding Exception.";

	private final static String MESSAGE_KEY = "_UnsupportedEncodingException";

	public UnsupportedEncodingException(Throwable cause) {

		super(MESSAGE_FORMAT, cause, MESSAGE_KEY, serialVersionUID);

	}

}

/* gvSIG. Geographic Information System of the Valencian Government

*

* Copyright (C) 2007-2008 Infrastructures and Transports Department

* of the Valencian Government (CIT)

*

* This program is free software; you can redistribute it and/or

* modify it under the terms of the GNU General Public License

* as published by the Free Software Foundation; either version 2

* of the License, or (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program; if not, write to the Free Software

* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

* MA  02110-1301, USA.

*

*/

/*

* AUTHORS (In addition to CIT):

* 2008 {{Company}}   {{Task}}

*/

package org.gvsig.fmap.dal.exceptions;

public class DataEvaluatorRuntimeException extends DataRuntimeException {

	/**

	 *

	 */

	private static final long serialVersionUID = 957625345447753115L;

	private final static String MESSAGE_FORMAT = "Evaluator exception.";

	private final static String MESSAGE_KEY = "_DataEvaluatorRuntimeException";

	public DataEvaluatorRuntimeException(Throwable cause) {

		super(MESSAGE_FORMAT, cause, MESSAGE_KEY, serialVersionUID);

	}

}

package org.gvsig.fmap.dal.exceptions;

public class InitializeException extends DataException {

	/**

	 *

	 */

	private static final long serialVersionUID = -3054877505579218816L;

	private final static String MESSAGE_FORMAT = "Exception intializing '%(resource)'.";

	private final static String MESSAGE_KEY = "_InitializeException";

	public InitializeException(String resource, Throwable cause) {

		super(MESSAGE_FORMAT, cause, MESSAGE_KEY, serialVersionUID);

		setValue("resource", resource);

	}

	public InitializeException(Throwable cause) {

		super(MESSAGE_FORMAT, cause, MESSAGE_KEY, serialVersionUID);

		setValue("resource", "{unknow}");

	}

	protected InitializeException(String messageFormat, Throwable cause,

			String messageKey, long code) {