Application: gvSIG desktop

/* 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.data.index;

import org.apache.log4j.Logger;

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

import org.gvsig.tools.extensionPoint.ExtensionPoint;

import org.gvsig.tools.extensionPoint.ExtensionPointsSingleton;

/**

 * Abstract factory for registering and retrieving available indexing engines. 

 * You can force the use of a specific implementation by passing its key, or you can use the default

 * implementation for a given data type by specifying the {@link AttributeDescriptor} of the column 

 * to be indexed.

 * 

 * @author jyarza

 *

 */

public abstract class IndexFactory {

	private static Logger logger = Logger.getLogger(IndexFactory.class);

	/**

	 * Convenience constants to identify sets of implemented factories classified by supported data types. 

	 * Using these from a client is not permitted as implementations are optional and not visible.

	 */

	public interface Factories {

		public interface GEOMETRY {

			public static final String GT2_QUADTREE = "QuadTreeGt2Factory";

			public static final String JSI_RTREE = "RTreeJsiFactory";

			public static final String JTS_QUADTREE = "QuadTreeJtsFactory";

			public static final String SPATIALINDEX_RTREE = "RTreeSptLibFactory";

			public static final String DEFAULT = GT2_QUADTREE;

		}

		public interface DATE {

			// added as example

		}

		public interface INTEGER {

			// added as example			

		}

	}

	// Register extension point, all available factory implementations will hang off here.

	public static final String EXTENSION_POINT_NAME =  "IndexFactory";

	private static ExtensionPoint ep = new ExtensionPoint(EXTENSION_POINT_NAME, "Index Factory");

	static {		

		ExtensionPointsSingleton.getInstance().put(ep);

	}

	/**

	 * Returns the default index factory registered for the given data type.

	 * @param col

	 * @return

	 * @throws InstantiationException

	 * @throws IllegalAccessException

	 */

	public static IndexFactory getDefaultFactory(FeatureAttributeDescriptor col) throws InstantiationException, IllegalAccessException {

		int type = col.getDataType();

		if (type == FeatureAttributeDescriptor.GEOMETRY) {

			return getFactory(Factories.GEOMETRY.DEFAULT);

		} else {

			throw new UnsupportedOperationException(type + " indexes are not supported.");

		}

	}

	/**

	 * Returns a specific index factory by key. 

	 * The argument implType must be one of the constants defined in {@link IndexFactory.Factories}

	 * @param implType

	 * @return

	 * @throws InstantiationException

	 * @throws IllegalAccessException

	 */

	public static IndexFactory getFactory(String key) throws InstantiationException, IllegalAccessException {

		if (!ep.containsKey(key)) {

			throw new IllegalArgumentException(key + " is not a valid factory.");

		}

		return (IndexFactory) ep.create(key);

	}

	/**

	 * Registers an index factory.

	 * @param key Name by which the factory will be identified

	 * @param description

	 * @param value

	 */

	protected static void registerFactory(String key, String description, Class value) {

		ep.put(key, description, value);

		logger.debug(key + " registered.");

	}

	/**

	 * Creates and returns a new index using default parameters.

	 * @return

	 * @throws IndexException

	 */

	public Index createIndex() throws IndexException {

		return createIndex(null);

	}

	/**

	 * Creates and returns a new index using the given parameters.

	 * @param params

	 * @return

	 * @throws IndexException

	 */

	public abstract Index createIndex(IndexParameters params) throws IndexException;

}

/* 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.data.index;

import java.util.HashMap;

import java.util.Iterator;

import java.util.Map;

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

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

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

/**

 * This class provides access to a FeatureStore local indexes.

 * This class holds the correspondence (FeatureType, columName) -> Index

 * TODO there is not persistence and works only in memory

 * @author jyarza

 */

public class IndexRegistry {

	private Map featureTypes = new HashMap();

	/**

	 * Creates an empty IndexRegistry for the given FeatureStore

	 * 

	 * @param store

	 *            FeatureStore to whom this IndexRegistry belongs

	 * @throws DataException

	 */

	public IndexRegistry(FeatureStore store) throws DataException {

		Iterator it = store.getFeatureTypes().iterator();

		while (it.hasNext()) {

			FeatureType type = (FeatureType) it.next();

			featureTypes.put(type, new HashMap());

		}

	}

	/**

	 * Returns an Index given the FeatureType and the name of the column.

	 * If the column has no index then this method returns <code>null</code>.

	 * @param fType FeatureType to which belongs the index

	 * @param colName name of the column

	 * @return if the index exists then this method returns the index, otherwise it returns null.

	 */

	public Index getIndex(FeatureType fType, String colName) {

		Map indexes = (Map) featureTypes.get(fType);

		if (indexes != null) {

			return (Index) (featureTypes.get(fType));

		}

		return null;

	}

	/**

	 * Adds an index to the registry, given its FeatureType and column name

	 * @param fType

	 * @param colName

	 * @param index

	 */

	public void addIndex(FeatureType fType, String colName, Index index) {

		Map indexes = (Map) featureTypes.get(fType);

		if (indexes == null) {

			// A new feature type has been added to the FeatureStore since this IndexStore was created

			indexes = new HashMap();

			featureTypes.put(fType, indexes);

		}

		indexes.put(colName, index);

	}

	/**

	 * Returns true if this registry contains an index for the given FeatureType and column name, otherwise

	 * it returns false.

	 * @param fType

	 * @param colName

	 * @return <code>true</code> if the index exists, <code>false</code> if it does not.

	 */

	public boolean contains(FeatureType fType, String colName) {

		Map map = (Map) featureTypes.get(fType);

		return map == null ? false : map.containsKey(colName);

	}

}

/* 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.data.index;

import java.util.HashMap;

import java.util.Map;

import org.gvsig.tools.exception.BaseException;

/**

 * 

 * @author azabala

 * @author vcaballero

 * @author jiyarza

 */

public class IndexException extends BaseException {

	private static final long serialVersionUID = 932690269454242645L;	

	private static final String MESSAGE_KEY = "index_exception";

	private static final String FORMAT_STRING = 

		"Index Exception.";	

	/**

	 * Main constructor that provides a cause Exception

	 * @param e

	 */

	public IndexException(Exception e) {

		super(FORMAT_STRING, e, MESSAGE_KEY, serialVersionUID);

	}

	protected Map values() {

		HashMap map = new HashMap();

		return map;

	}

}

/* 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.data.index;

import java.io.File;

/**

 * FIXME This specification is due to change

 * 

 * -open()

 * -close()

 * -delete()

 * -getFile()

 * 

 * @author azabala

 * @author jyarza

 */

public interface PersistentIndex {

	/**

	 * Makes persistent all changes in the index

	 */

	public void flush() throws IndexException;	

	public void flush(File f) throws IndexException;

	/**

	 * Checks if the persistent store of this index exists

	 * @return

	 */

	public boolean exists();

	/**

	 * Loads an index from a file

	 * @throws IndexException

	 */

	public void load() throws IndexException;

	public void load(File f) throws IndexException;

	/**

	 * Frees resources of persistent data store

	 * (closes files, etc)

	 *

	 */

	public void close();

	/**

	 * Obtains the index File

	 * @return

	 */

	public File getFile();	

}