Application: gvSIG desktop

/**

 * gvSIG. Desktop Geographic Information System.

 *

 * Copyright (C) 2007-2013 gvSIG Association.

 *

 * 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 3

 * 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.

 *

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 */

package org.gvsig.fmap.geom;

import org.cresques.ProjectionLibrary;

import org.gvsig.fmap.geom.primitive.Envelope;

import org.gvsig.tools.ToolsLibrary;

import org.gvsig.tools.ToolsLocator;

import org.gvsig.tools.dataTypes.DataTypesManager;

import org.gvsig.tools.library.AbstractLibrary;

import org.gvsig.tools.library.LibraryException;

import org.gvsig.tools.locator.ReferenceNotRegisteredException;

/**

 * Registers the default implementation for {@link GeometryManager}.

 *

 * @author <a href="mailto:jpiera@gvsig.org">Jorge Piera</a>

 */

public class GeometryLibrary extends AbstractLibrary {

    public void doRegistration() {

        registerAsAPI(GeometryLibrary.class);

        require(ToolsLibrary.class);

        require(ProjectionLibrary.class);

    }

    protected void doInitialize() throws LibraryException {

    }

    protected void doPostInitialize() throws LibraryException {

        // Validate there is any implementation registered.

        if(! GeometryLocator.getInstance().exists(GeometryLocator.GEOMETRY_MANAGER_NAME)) {

            throw new ReferenceNotRegisteredException(

                GeometryLocator.GEOMETRY_MANAGER_NAME,

                GeometryLocator.getInstance());

        }

        DataTypesManager dataTypesManager = ToolsLocator.getDataTypesManager();

        dataTypesManager.addtype(DataTypes.GEOMETRY, "Geometry", "Geometry",

            Geometry.class, null);

        dataTypesManager.addtype(DataTypes.ENVELOPE, "Envelope", "Envelope",

            Envelope.class, null);

    }

}

/**

 * gvSIG. Desktop Geographic Information System.

 *

 * Copyright (C) 2007-2013 gvSIG Association.

 *

 * 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 3

 * 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.

 *

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 */

package org.gvsig.fmap.geom.operation;

import java.util.HashMap;

import java.util.Map;

import org.gvsig.tools.exception.BaseException;

/**

 * @author Jorge Piera Llodr? (jorge.piera@iver.es)

 */

public class GeometryOperationException extends BaseException {

	/**

	 * Generated serial version UID

	 */

	private static final long serialVersionUID = 8230919748601156772L;

	private static final String MESSAGE_KEY = "geometry_operation_exception";

	private static final String FORMAT_STRING =

		"Exception executing the operation with code %(operationCode) for the geometry with type %(geometryType).";

	private int geometryType = -1;

	private int operationCode = -1;

	/**

	 * Constructor with some context data for cases in which the root cause of

	 * <code>this</code> is internal (usually an unsatisfied logic rule).

	 * @param geometryType

	 * @param operationCode

	 */

	public GeometryOperationException(int geometryType, int operationCode){

		this(geometryType, operationCode, null);

	}

	/**

	 * Constructor to use when <code>this</code> is caused by another Exception

	 * but there is not further context data available.

	 * @param e

	 */

	public GeometryOperationException(Exception e) {

		this(-1, -1, e);

	}

	/**

	 * Main constructor that provides both context data and a cause Exception

	 * @param geometryType

	 * @param operationCode

	 * @param exp

	 */

	public GeometryOperationException(int geometryType, int operationCode, Exception e) {

		super(FORMAT_STRING, e, MESSAGE_KEY, serialVersionUID);

		this.geometryType = geometryType;

		this.operationCode = operationCode;

	}

	protected Map values() {

		HashMap map = new HashMap();

		map.put("geometryType", String.valueOf(geometryType));

		map.put("operationCode", String.valueOf(operationCode));

		return map;

	}

}

/**

 * gvSIG. Desktop Geographic Information System.

 *

 * Copyright (C) 2007-2013 gvSIG Association.

 *

 * 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 3

 * 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.

 *

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 */

package org.gvsig.fmap.geom.operation;

import org.gvsig.fmap.geom.Geometry;

import org.gvsig.fmap.geom.GeometryLocator;

/**

 * Every geometry operation that is registered dynamically must extend this class.<br>

 *

 * The following example shows how to implement and register a custom operation:

 *  

 * <pre>

 * public class MyOperation extends GeometryOperation {

 * 

 *   // Check GeometryManager for alternative methods to register an operation  

 *   public static final int CODE = 

 *     GeometryManager.getInstance()

 *        .registerGeometryOperation("MyOperation", new MyOperation(), geomType);

 *   

 *   public Object invoke(Geometry geom, GeometryOperationContext ctx) throws GeometryOperationException {

 *        // Operation logic goes here

 *   }     

 *   

 *   public int getOperationIndex() {

 *      return CODE;

 *   }

 *   

 * }

 * </pre>

 *

 * @author jiyarza

 *

 */

public abstract class GeometryOperation {

	// Constants for well-known operations to avoid dependency between geometry model and

	// operations.

	public static final String OPERATION_INTERSECTS_NAME = "intersects";

	public static final String OPERATION_CONTAINS_NAME = "contains";

	public static int OPERATION_INTERSECTS_CODE = Integer.MIN_VALUE;

	public static int OPERATION_CONTAINS_CODE = Integer.MIN_VALUE;

	/**

	 * Invokes this operation given the geometry and context 

	 * @param geom Geometry to which apply this operation

	 * @param ctx Parameter container

	 * @return Place-holder object that may contain any specific return value. 

	 * @throws GeometryOperationException The implementation is responsible to throw this exception when needed.

	 */

	public abstract Object invoke(Geometry geom, GeometryOperationContext ctx) throws GeometryOperationException;

	/**

	 * Returns the constant value that identifies this operation and that was obtained upon registering it. 

	 * @return operation unique index 

	 */

	public abstract int getOperationIndex();

}

/**

 * gvSIG. Desktop Geographic Information System.

 *

 * Copyright (C) 2007-2013 gvSIG Association.

 *

 * 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 3

 * 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.

 *

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 */

package org.gvsig.fmap.geom.operation;

import java.util.HashMap;

import java.util.Map;

/**

 * This class is a default parameter container for geometry operation.<br>

 * 

 * Normally every GeometryOperation will extend this class and identify

 * its parameters publicly with getters/setters

 *

 * For those operations that need high performance, parameters should be declared as class 

 * members instead of using the setAttribute/getAttribute mechanism. This way you avoid a hash

 * and a cast operation.

 * 

 * @author jyarza

 *

 */

public class GeometryOperationContext {

	private Map ctx = new HashMap();

	/**

	 * Returns an attribute given its name.

	 * If it does not exist returns <code>null</code>

	 * @param name

	 * @return attribute

	 */

	public Object getAttribute(String name) {

		return ctx.get(name.toLowerCase());

	}

	/**

	 * Sets an attribute

	 * @param name

	 * @param value

	 */

	public GeometryOperationContext setAttribute(String name, Object value) {

		ctx.put(name.toLowerCase(), value);

		return this;

	}

}

/**

 * gvSIG. Desktop Geographic Information System.

 *

 * Copyright (C) 2007-2013 gvSIG Association.

 *

 * 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 3

 * 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.

 *

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 */

package org.gvsig.fmap.geom.operation;

import java.util.HashMap;

import java.util.Map;

import org.gvsig.fmap.geom.type.GeometryType;

import org.gvsig.tools.exception.BaseException;

public class GeometryOperationNotSupportedException extends BaseException {

	/**

	 * Generated UID

	 */

	private static final long serialVersionUID = -8394502194572892834L;

	/**

	 * Constants specific to this BaseException subclass

	 */

	private static final String MESSAGE_KEY = "Operation_opCode_is_not_registered_for_geomTypeName_type";

	private static final String FORMAT_STRING = "Operation %(opCode)s is not registered for '%(geomTypeName)s' type.";

	private String geomTypeName = null;

	private int opCode = -1;

	/**

	 * Constructor with the operation code of a common operation.

	 * @param opCode

	 */	

	public GeometryOperationNotSupportedException(int opCode) {

		this(opCode, null);

	}

	/**

	 * Constructor with the operation code related to a geometry type

	 * @param opCode

	 * @param geomType

	 */

	public GeometryOperationNotSupportedException(int opCode, GeometryType geomType) {

		this(opCode, geomType, null);

	}

	/**

	 * Constructor to use when <code>this</code> is caused by another Exception 

	 * but there is not further context data available.

	 * @param e

	 */

	public GeometryOperationNotSupportedException(Exception e) {

		this(-1, null, e);

	}

	/**

	 * Main constructor

	 * @param opCode

	 * @param geomType

	 * @param e

	 */

	public GeometryOperationNotSupportedException(int opCode, GeometryType geomType, Exception e) {

		messageKey = MESSAGE_KEY;

		formatString = FORMAT_STRING;

		code = serialVersionUID;

		if (e != null) {

			initCause(e);

		}

		if (geomType != null) {

			geomTypeName = geomType.getName();

		} else {

			geomTypeName = "ANY";

		}

		this.opCode = opCode;

	}

	protected Map values() {

		HashMap map = new HashMap();

		map.put("opCode", Integer.toString(opCode));

		map.put("geomTypeName", geomTypeName);

		return map;

	}

}

/**

 * gvSIG. Desktop Geographic Information System.

 *

 * Copyright (C) 2007-2013 gvSIG Association.

 *

 * 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 3

 * 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.

 *

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 */

package org.gvsig.fmap.geom;

import java.util.Iterator;

import java.util.List;

import org.gvsig.fmap.geom.primitive.Envelope;

import org.gvsig.tools.service.Service;

import org.gvsig.tools.visitor.Visitor;

public 	interface SpatialIndex extends Service {

        public SpatialIndexFactory getFactory();

        public void open();

        public void close();

	public void query(Envelope envelope, Visitor visitor);

	public void query(Geometry geom, Visitor visitor);

	public Iterator query(Envelope envelope, long limit);

	public Iterator query(Envelope envelope);

	public Iterator query(Geometry geom, long limit);

	public Iterator query(Geometry geom);

       	public Iterator queryNearest(Envelope envelope, long limit);

        public Iterator queryNearest(Envelope envelope);

	public Iterator queryNearest(Geometry geom, long limit);

	public Iterator queryNearest(Geometry geom);

        public Iterator queryAll();

        public List queryAsList(Envelope envelope);

	public List queryAsList(Geometry geom);

	public List queryAllAsList();

	public void insert(Envelope envelope, Object data);

	public void insert(Geometry geom, Object data);

        public void insert(Geometry geom);

	public boolean remove(Envelope envelope, Object data);

	public boolean remove(Geometry geom, Object data);

        public boolean remove(Geometry geom);

        public void removeAll();

        public long size();

        public void flush();

}

/**

 * gvSIG. Desktop Geographic Information System.

 *

 * Copyright (C) 2007-2013 gvSIG Association.

 *

 * 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 3

 * 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.

 *

 * For any additional information, do not hesitate to contact us

 * at info AT gvsig.com, or visit our website www.gvsig.com.

 */

package org.gvsig.fmap.geom;

import java.awt.geom.PathIterator;

import java.util.List;

import org.gvsig.fmap.geom.aggregate.MultiCurve;

import org.gvsig.fmap.geom.aggregate.MultiLine;

import org.gvsig.fmap.geom.aggregate.MultiPoint;

import org.gvsig.fmap.geom.aggregate.MultiPolygon;

import org.gvsig.fmap.geom.aggregate.MultiPrimitive;

import org.gvsig.fmap.geom.aggregate.MultiSurface;

import org.gvsig.fmap.geom.exception.CreateEnvelopeException;

import org.gvsig.fmap.geom.exception.CreateGeometryException;

import org.gvsig.fmap.geom.operation.GeometryOperation;

import org.gvsig.fmap.geom.operation.GeometryOperationContext;

import org.gvsig.fmap.geom.operation.GeometryOperationException;

import org.gvsig.fmap.geom.operation.GeometryOperationNotSupportedException;

import org.gvsig.fmap.geom.primitive.Curve;

import org.gvsig.fmap.geom.primitive.Envelope;

import org.gvsig.fmap.geom.primitive.GeneralPathX;

import org.gvsig.fmap.geom.primitive.IGeneralPathX;

import org.gvsig.fmap.geom.primitive.Line;

import org.gvsig.fmap.geom.primitive.NullGeometry;

import org.gvsig.fmap.geom.primitive.OrientablePrimitive;

import org.gvsig.fmap.geom.primitive.Point;

import org.gvsig.fmap.geom.primitive.Polygon;

import org.gvsig.fmap.geom.primitive.Surface;

import org.gvsig.fmap.geom.type.GeometryType;

import org.gvsig.fmap.geom.type.GeometryTypeNotSupportedException;

import org.gvsig.fmap.geom.type.GeometryTypeNotValidException;

import org.gvsig.tools.dynobject.DynObject;

import org.gvsig.tools.service.Manager;

import org.gvsig.tools.service.ServiceException;

import org.gvsig.tools.service.spi.ServiceManager;

/**

 * This singleton provides a centralized access to gvSIG's Geometry Model.

 * Its responsibilities are:<br>

 * 

 * <ul>

 * <li>Offering a set of convenient methods for registering and retrieving

 * geometry types.

 * <li>Offering a set of convenient methods for registering and retrieving

 * geometry operations associated to one or more geometry types.

 * <li>Offering a set of convenient methods for registering and retrieving new

 * geometries.

 * </ul>

 * 

 * @author jiyarza

 * @author <a href="mailto:jpiera@gvsig.org">Jorge Piera</a>

 */

public interface GeometryManager extends Manager, ServiceManager {

    public interface OPERATIONS {

        public final static String FROMWKT = "FromWKT";

        public final static String FROMWKB = "FromWKB";

    }

    /**

     * <p>

     * Registers a GeometryOperation associated to a GeometryType. Returns an

     * unique index that is used later to identify and invoke the operation.

     * </p>

     * <p>

     * By convention this index should be in a final and static variable in the

     * class that implements the operation. The value of this variable must be

     * set using the method

     * {@link GeometryManager#getGeometryOperationCode(String)}:<BR>

     * 

     * <pre>

     * 

     * public class MyOperation extends GeometryOperation {

     * 

     *     public static final int CODE = GeometryLocator.getGeometryManager()

     *         .getGeometryOperationCode("MyOperation");

     * }

     * </pre>

     * 

     * </p>

     * 

     * @param geomOpName

     *            Operation's unique name

     * @param geomOp

     *            Specific GeometryOperation's instance implementing this

     *            operation

     * @param geomType

     *            GeometryType instance to which this operation should be

     *            associated

     * @return Index assigned to this operation. This index is used later to

     *         access the operation.

     * 

     */

    public int registerGeometryOperation(String geomOpName,

        GeometryOperation geomOp, GeometryType geomType);

    /**

     * <p>

     * Registers a GeometryOperation that is common for all GeometryType

     * (registered yet or not). Returns an unique index that is used later to

     * identify and invoke the operation.

     * </p>

     * <p>

     * By convention this index should be in a final and static variable in the

     * class that implements the operation. The value of this variable must be

     * set using the method

     * {@link GeometryManager#getGeometryOperationCode(String)}:<BR>

     * 

     * <pre>

     * 

     * public class MyOperation extends GeometryOperation {

     * 

     *     public static final int CODE = GeometryLocator.getGeometryManager()

     *         .getGeometryOperationCode("MyOperation");

     * }

     * </pre>

     * 

     * </p>

     * 

     * @param geomOpName

     *            Operation's unique name

     * @param geomOp

     *            Specific GeometryOperation's instance implementing this

     *            operation

     * @return Index assigned to this operation. This index is used later to

     *         access the operation.

     */

    public int registerGeometryOperation(String geomOpName,

        GeometryOperation geomOp);

    /**

     * <p>

     * Registers a GeometryOperation associated to a GeometryType, that has been

     * specified using the type code and the subtype code. Returns an unique

     * index that is used later to identify and invoke the operation.

     * </p>

     * <p>

     * By convention this index should be in a final and static variable in the

     * class that implements the operation. The value of this variable must be

     * set using the method

     * {@link GeometryManager#getGeometryOperationCode(String)}:<BR>

     * 

     * <pre>

     * 

     * public class MyOperation extends GeometryOperation {

     * 

     *     public static final int CODE = GeometryLocator.getGeometryManager()

     *         .getGeometryOperationCode("MyOperation");

     * }

     * </pre>

     * 

     * </p>

     * <p>

     * This method is only used if you have not a reference to the GeometryType

     * associated to the geometry class. If you have such reference then it is

     * slightly faster to use the method that receives the GeometryType.<br>

     * </p>

     * 

     * @param geomOpName

     *            Operation's unique name

     * @param geomOp

     *            Specific GeometryOperation's instance implementing this

     *            operation

     * @param type

     *            Type of geometry. Must be a value defined in

     *            {@link Geometry.TYPES}

     * @param subType

     *            SubType of geometry. Must be a value defined in

     *            {@link Geometry.SUBTYPES}

     * @return Index assigned to this operation. This index is used later to

     *         access the operation.

     * @throws GeometryTypeNotSupportedException

     *             Returns this exception if there is not a registered geometry

     *             with

     *             these type and subtype

     * @throws GeometryTypeNotValidException

     *             Returns if the type and subtype are not valid

     */

    public int registerGeometryOperation(String geomOpName,

        GeometryOperation geomOp, int type, int subType)

        throws GeometryTypeNotSupportedException, GeometryTypeNotValidException;

    /**

     * <p>

     * Registers a GeometryOperation associated to all the geometries with a

     * concrete type. Returns an unique index that is used later to identify and

     * invoke the operation.<br>

     * </p>

     * <p>

     * By convention this index should be in a final and static variable in the

     * class that implements the operation. The value of this variable must be

     * set using the method

     * {@link GeometryManager#getGeometryOperationCode(String)}:<BR>

     * 

     * <pre>

     * 

     * public class MyOperation extends GeometryOperation {

     * 

     *     public static final int CODE = GeometryLocator.getGeometryManager()

     *         .getGeometryOperationCode("MyOperation");

     * }

     * </pre>

     * 

     * </p>

     * 

     * @param geomOpName

     *            Operation's unique name

     * @param geomOp

     *            Specific GeometryOperation's instance implementing this

     *            operation

     * @param type

     *            Type of geometry. Must be a value defined in

     *            {@link Geometry.TYPES}

     * @return Index assigned to this operation. This index is used later to

     *         access the operation.

     */

    public int registerGeometryOperation(String geomOpName,

        GeometryOperation geomOp, int type);

    /**

     * <p>

     * Registers a GeometryOperation associated to all the geometries which

     * super type matches with a concrete type. Returns an unique index that 

     * is used later to identify and invoke the operation.<br>

     * </p>

     * <p>

     * By convention this index should be in a final and static variable in the

     * class that implements the operation. The value of this variable must be

     * set using the method

     * {@link GeometryManager#getGeometryOperationCode(String)}:<BR>

     * 

     * <pre>

     * 

     * public class MyOperation extends GeometryOperation {

     * 

     *     public static final int CODE = GeometryLocator.getGeometryManager()

     *         .getGeometryOperationCode("MyOperation");

     * }

     * </pre>

     * 

     * </p>

     * 

     * @param geomOpName

     *            Operation's unique name

     * @param geomOp

     *            Specific GeometryOperation's instance implementing this

     *            operation

     * @param superType

     *            super type of geometries that is used to register

     *            the operation. Must be a value defined in

     *            {@link Geometry.TYPES}

     * @return Index assigned to this operation. This index is used later to

     *         access the operation.

     */

    public int registerGeometryOperationBySuperType(String geomOpName,

        GeometryOperation geomOp, int superType);

    /**

     * <p>

     * Registers a GeometryOperation associated to all the geometries which

     * super subType matches with a concrete subType. Returns an unique index that 

     * is used later to identify and invoke the operation.<br>

     * </p>

     * <p>

     * By convention this index should be in a final and static variable in the

     * class that implements the operation. The value of this variable must be

     * set using the method

     * {@link GeometryManager#getGeometryOperationCode(String)}:<BR>

     * 

     * <pre>

     * 

     * public class MyOperation extends GeometryOperation {

     * 

     *     public static final int CODE = GeometryLocator.getGeometryManager()

     *         .getGeometryOperationCode("MyOperation");

     * }

     * </pre>

     * 

     * </p>

     * 

     * @param geomOpName

     *            Operation's unique name

     * @param geomOp

     *            Specific GeometryOperation's instance implementing this

     *            operation

     * @param superSubType

     *            super subType of geometries that is used to register

     *            the operation. Must be a value defined in

     *            {@link Geometry.SUBTYPES}

     * @return Index assigned to this operation. This index is used later to

     *         access the operation.

     */

    public int registerGeometryOperationBySuperSubType(String geomOpName,

        GeometryOperation geomOp, int superSubType);

    /**

     * <p>

     * Registers a GeometryOperation associated to all the geometries with a

     * concrete subtype. Returns an unique index that is used later to identify

     * and invoke the operation.<br>

     * </p>

     * <p>

     * By convention this index should be in a final and static variable in the

     * class that implements the operation. The value of this variable must be

     * set using the method

     * {@link GeometryManager#getGeometryOperationCode(String)}:<BR>

     * 

     * <pre>

     * 

     * public class MyOperation extends GeometryOperation {

     * 

     *     public static final int CODE = GeometryLocator.getGeometryManager()

     *         .getGeometryOperationCode("MyOperation");

     * }

     * </pre>

     * 

     * </p>

     * 

     * @param geomOpName

     *            Operation's unique name

     * @param geomOp

     *            Specific GeometryOperation's instance implementing this

     *            operation

     * @param subType

     *            SubType of geometry. Must be a value defined in

     *            {@link Geometry.SUBTYPES}

     * @return Index assigned to this operation. This index is used later to

     *         access the operation.

     */

    public int registerGeometryOperationBySubtype(String geomOpName,

        GeometryOperation geomOp, int subType);

    /**

     * <p>

     * Registers a GeometryType instance. 

     * </p>

     * 

     * @param geometryType

     *            A {@link GeometryType} instance to create {@link Geometry} objects

     */

    public void registerGeometryType(GeometryType geometryType);

    /**

     * <p>

     * Registers a Geometry implementation class with a predefined geometry type

     * and returns the associated GeometryType instance. Available predefined

     * types are defined in {@link Geometry.TYPES} and the subtypes are defined

     * in {@link Geometry.SUBTYPES}.

     * </p>

     * <p>

     * How to register a geometry class with a predefined type:

     * 

     * <pre>

     * 

     * GeometryType geomType = GeometryLocator.getGeometryManager()

     *     .registerBasicGeometryType(Point2D.class, "Point2D", Geometry.TYPES.POINT,

     *         Geometry.SYBTYPES.GEOM2D);

     * </pre>

     * 

     * </p>

     * 

     * @param geomClass

     *            Geometry subclass. It must not be null and must implement

     *            Geometry, otherwise an exception

     *            is raised.

     * @param name

     *            Symbolic name for the geometry type, it can be null. If it is

     *            null then the symbolic name

     *            will be the simple class name.

     * @param type

     *            Type of geometry. Must be a value defined in

     *            {@link Geometry.TYPES}

     * @param subType

     *            SubType of geometry. Must be a value defined in

     *            {@link Geometry.SUBTYPES}

     * @return Instance of GeometryType associated to the Geometry

     *         implementation class

     *         geomClass

     * @throws IllegalArgumentException

     *             If geomClass is null or does not implement Geometry

     */

    public GeometryType registerGeometryType(Class geomClass, String name,

        int type, int subType);

    /**

     * <p>

     * Registers a Geometry implementation class with a predefined geometry type

     * and returns the associated GeometryType instance. Available predefined

     * types are defined in {@link Geometry.TYPES} and the subtypes are defined

     * in {@link Geometry.SUBTYPES}.    

     * </p>

     * <p>

     * It adds also the super type and the super subType of the geometry, that

     * can be used to check if the type (or the subtype) inherits of other 

     * type (or subType)

     * </p>

     * <p>

     * How to register a geometry class with a predefined type:

     * 

     * <pre>

     * 

     * GeometryType geomType = GeometryLocator.getGeometryManager()

     *     .registerBasicGeometryType(Arc3D.class, "Arc3D", Geometry.TYPES.ARC,

     *         Geometry.SYBTYPES.GEOM3D, Geometry.TYPES.CURVE, Geometry.SYBTYPES.GEOM2D);

     * </pre>

     * 

     * </p>

     * 

     * @param geomClass

     *            Geometry subclass. It must not be null and must implement

     *            Geometry, otherwise an exception

     *            is raised.

     * @param name

     *            Symbolic name for the geometry type, it can be null. If it is

     *            null then the symbolic name

     *            will be the simple class name.

     * @param type

     *            Type of geometry. Must be a value defined in

     *            {@link Geometry.TYPES}

     * @param subType

     *            SubType of geometry. Must be a value defined in

     *            {@link Geometry.SUBTYPES}

     * @param superType

     *              Super type of a geometry. Must be a value defined in

     *            {@link Geometry.TYPES}

     * @param superSubType

     *             Super subType of a geometry. Must be a value defined in

     *            {@link Geometry.SUBTYPES}

     * @return Instance of GeometryType associated to the Geometry

     *         implementation class

     *         geomClass

     * @throws IllegalArgumentException

     *             If geomClass is null or does not implement Geometry

     */

    public GeometryType registerGeometryType(Class geomClass, String name,

        int type, int subType, int superType, int superSubType);

    /**

     * <p>

     * Registers a Geometry implementation class with a predefined geometry type

     * and returns the associated GeometryType instance. Available predefined

     * types are defined in {@link Geometry.TYPES} and the subtypes are defined

     * in {@link Geometry.SUBTYPES}.    

     * </p>

     * <p>

     * It adds also the super type of the geometry, that can be used to 

     * check if the type inherits of other type.

     * </p>

     * <p>

     * How to register a geometry class with a predefined type:

     * 

     * <pre>

     * 

     * GeometryType geomType = GeometryLocator.getGeometryManager()

     *     .registerBasicGeometryType(Arc3D.class, "Arc3D", Geometry.TYPES.ARC,

     *         Geometry.SYBTYPES.GEOM3D, Geometry.TYPES.CURVE);

     * </pre>

     * 

     * </p>

     * 

     * @param geomClass

     *            Geometry subclass. It must not be null and must implement

     *            Geometry, otherwise an exception

     *            is raised.

     * @param name

     *            Symbolic name for the geometry type, it can be null. If it is

     *            null then the symbolic name

     *            will be the simple class name.

     * @param type

     *            Type of geometry. Must be a value defined in

     *            {@link Geometry.TYPES}

     * @param subType

     *            SubType of geometry. Must be a value defined in

     *            {@link Geometry.SUBTYPES}

     * @param superType

     *              Super type of a geometry. Must be a value defined in

     *            {@link Geometry.TYPES}   

     * @return Instance of GeometryType associated to the Geometry

     *         implementation class

     *         geomClass

     * @throws IllegalArgumentException

     *             If geomClass is null or does not implement Geometry

     */

    public GeometryType registerGeometryType(Class geomClass, String name,

        int type, int subType, int superType);

    /**

     * <p>

     * Registers a Geometry implementation class with a predefined geometry type

     * and returns the associated GeometryType instance. Available predefined

     * types are defined in {@link Geometry.TYPES} and the subtypes are defined

     * in {@link Geometry.SUBTYPES}.    

     * </p>

     * <p>

     * It adds also the super types and the super subTypes of the geometry, that

     * can be used to check if the type (or the subtype) inherits of other 

     * types (or subTypes)

     * </p>

     * <p>

     * How to register a geometry class with a predefined type:

     * 

     * <pre>

     * 

     * GeometryType geomType = GeometryLocator.getGeometryManager()

     *     .registerBasicGeometryType(Circle3DM.class, "Circle3DM", Geometry.TYPES.CIRCLE,

     *         Geometry.SYBTYPES.GEOM3DM,

     *         new int[]{Geometry.TYPES.CURVE, Geometry.TYPES.GEOMETRY},

     *         new int[]{Geometry.SYBTYPES.GEOM2D, Geometry.SYBTYPES.GEOM3D});

     * </pre>

     * 

     * </p>

     * 

     * @param geomClass

     *            Geometry subclass. It must not be null and must implement

     *            Geometry, otherwise an exception

     *            is raised.

     * @param name

     *            Symbolic name for the geometry type, it can be null. If it is

     *            null then the symbolic name

     *            will be the simple class name.

     * @param type

     *            Type of geometry. Must be a value defined in

     *            {@link Geometry.TYPES}

     * @param subType

     *            SubType of geometry. Must be a value defined in

     *            {@link Geometry.SUBTYPES}

     * @param superTypes

     *              List of the super types of a geometry. Must be a value defined in

     *            {@link Geometry.TYPES}

     * @param superSubTypes

     *             List of the super subType of a geometry. Must be a value defined in

     *            {@link Geometry.SUBTYPES}

     * @return Instance of GeometryType associated to the Geometry

     *         implementation class

     *         geomClass

     * @throws IllegalArgumentException

     *             If geomClass is null or does not implement Geometry

     */

    public GeometryType registerGeometryType(Class geomClass, String name,

        int type, int subType, int[] superTypes, int superSubTypes[]);

    /**

     * <p>

     * Registers a Geometry implementation class with a predefined geometry type

     * and returns the associated GeometryType instance. Available predefined

     * types are defined in {@link Geometry.TYPES} and the subtypes are defined

     * in {@link Geometry.SUBTYPES}.    

     * </p>

     * <p>

     * It adds also the super types and the super subTypes of the geometry, that

     * can be used to check if the type inherits of other types.

     * </p>

     * <p>

     * How to register a geometry class with a predefined type:

     * 

     * <pre>

     * 

     * GeometryType geomType = GeometryLocator.getGeometryManager()

     *     .registerBasicGeometryType(Circle2D.class, "Circle2DM", Geometry.TYPES.CIRCLE,

     *         Geometry.SYBTYPES.GEOM2D,

     *         new int[]{Geometry.TYPES.CURVE, Geometry.TYPES.SURFACE});        

     * </pre>

     * 

     * </p>

     * 

     * @param geomClass

     *            Geometry subclass. It must not be null and must implement

     *            Geometry, otherwise an exception

     *            is raised.

     * @param name

     *            Symbolic name for the geometry type, it can be null. If it is

     *            null then the symbolic name

     *            will be the simple class name.

     * @param type

     *            Type of geometry. Must be a value defined in

     *            {@link Geometry.TYPES}

     * @param subType

     *            SubType of geometry. Must be a value defined in

     *            {@link Geometry.SUBTYPES}

     * @param superTypes

     *              List of the super types of a geometry. Must be a value defined in

     *            {@link Geometry.TYPES}

     * @return Instance of GeometryType associated to the Geometry

     *         implementation class

     *         geomClass

     * @throws IllegalArgumentException

     *             If geomClass is null or does not implement Geometry

     */

    public GeometryType registerGeometryType(Class geomClass, String name,

        int type, int subType, int[] superTypes);

    /**

     * <p>

     * Registers a Geometry implementation class with a predefined geometry type

     * and returns the associated GeometryType instance. Available predefined

     * types are defined in {@link Geometry.TYPES} and the subtypes are defined

     * in {@link Geometry.SUBTYPES}.

     * </p>

     * <p>

     * In this case the symbolic name will be the geometry's simple class name

     * </p>

     * How to register a new geometry type:

     * 

     * <pre>

     * 

     * GeometryType geomType = GeometryLocator.getGeometryManager()

     *     .registerBasicGeometryType(Point2D.class, Geometry.TYPES.POINT,

     *         Geometry.SYBTYPES.GEOM2D);

     * </pre>

     * 

     * @param geomClass

     *            Geometry implementation class. It must not be null and must

     *            implement Geometry,

     *            otherwise an exception is thrown.

     * @param type

     *            Type of geometry. Must be a value defined in

     *            {@link Geometry.TYPES}

     * @param subType

     *            SubType of geometry. Must be a value defined in

     *            {@link Geometry.SUBTYPES}

     * @return Instance of GeometryType associated to the Geometry

     *         implementation class

     * @throws IllegalArgumentException

     *             If geomClass is null or does not implement Geometry

     */

    public GeometryType registerGeometryType(Class geomClass, int type,

        int subType);

    /**

     * <p>

     * Returns an instance of GeometryType given the Geometry type and the

     * subtype.

     * </p>

     * 

     * @param type

     *            Type of geometry. Must be a value defined in

     *            {@link Geometry.TYPES}

     * @param subType

     *            SubType of geometry. Must be a value defined in

     *            {@link Geometry.SUBTYPES}

     * @return Instance of GeometryType associated to the type and the subtype

     * @throws GeometryTypeNotSupportedException

     *             Returns this exception if there is not a registered geometry

     *             with

     *             these type and subtype

     * @throws GeometryTypeNotValidException

     *             Returns if the type and subtype are not valid

     */

    public GeometryType getGeometryType(int type, int subType)

        throws GeometryTypeNotSupportedException, GeometryTypeNotValidException;

    /**

     * <p>

     * This method creates a {@link Geometry} with the type specified by this

     * GeometryType. The geometry is empty, and all the internal attributes must

     * be assigned to a value when the geometry has been created.

     * </p>

     * <p>

     * This example creates a point2D and sets the coordinates to 1,1:

     * 

     * <pre>

     * Point point =

     *     (Point) GeometryLocator.getGeometryManager().create(GEOMETRY.TYPES.POINT,

     *         GEOMETRY.SUBTYPES.GEOM2D);

     * point.setX(1);

     * point.setY(1);

     * </pre>

     * 

     * </p>

     * 

     * @param geomType

     *            The geometry type

     * @return

     *         A instance of a geometry.

     * @throws CreateGeometryException

     *             This exception is thrown when the manager can not create

     *             the geometry.

     */

    public Geometry create(GeometryType geomType)

        throws CreateGeometryException;

    /**

     * <p>

     * Creates a Envelope with a concrete subtype. The envelope is empty and it

     * have to be filled with the corners once has been created.

     * </p>

     * 

     * @param subType

     *            SubType of envelope. Must be a value defined in

     *            {@link Geometry.SUBTYPES}

     * @return

     *         A Envelope

     * @throws CreateEnvelopeException

     *             If it is not possible to create the envelope.

     */

    public Envelope createEnvelope(int subType) throws CreateEnvelopeException;

    /**

     * <p>

     * Creates a Envelope with a concrete subtype. It sets the values for the

     * lower corner and the upper corner (in 2D) using the method parameters.

     * </p>

     * 

     * @param minX

     *            The minimum value for the X coordinate.

     * @param minY

     *            The minimum value for the Y coordinate.

     * @param maxX

     *            The maximum value for the X coordinate.

     * @param maxY

     *            The maximum value for the Y coordinate.

     * @param subType

     *            SubType of envelope. Must be a value defined in

     *            {@link Geometry.SUBTYPES}

     * @return

     * @throws CreateEnvelopeException

     */

    public Envelope createEnvelope(double minX, double minY, double maxX,

        double maxY, int subType) throws CreateEnvelopeException;

    /**

     * <p>

     * This method creates a {@link Geometry} with the type specified by this

     * name. If a geometry with this name doesn't exist, a

     * {@link IllegalArgumentException} is thrown. The geometry is empty, and

     * all the internal attributes must be assigned to a value when the geometry

     * has been created.

     * </p>

     * <p>

     * This example creates a point2D and sets the coordinates to 1,1: It

     * supposes that there is a Point2D class with name "Point2D".

     * </p>

     * 

     * <pre>

     * Point point = (Point) GeometryLocator.getGeometryManager().create("Point2D");

     * point.setX(1);

     * point.setY(1);

     * </pre>

     * 

     * @param name

     *            The name of the geometry type

     * @return

     *         A instance of a geometry.

     * @throws CreateGeometryException

     *             This exception is thrown when the manager can not create

     *             the geometry.

     */

    public Geometry create(String name) throws CreateGeometryException;

    /**

     * Create a geometry from a WKT definition.

     * 

     * This is a utility method to wrap the invocation to the operation

     * {@link OPERATIONS#FROMWKT}.

     * 

     * @param wkt

     *            geometry in Well-known text format

     * 

     * @return the geometry as a Geometry

     * 

     * @throws CreateGeometryException

     * @throws GeometryException

     */

    public Geometry createFrom(String wkt, String srs)

        throws CreateGeometryException, GeometryException;

    public Geometry createFrom(String wkt) throws CreateGeometryException,

        GeometryException;

    /**

     * Create a geometry from a WKB definition.

     * 

     * This is a utility method to wrap the invocation to the operation

     * {@link OPERATIONS#FROMWKB}.

     * 

     * @param wkb

     *            geometry in well-known binary format

     * 

     * @return the geometry as a Geometry

     * 

     * @throws CreateGeometryException

     * @throws GeometryException

     */

    public Geometry createFrom(byte[] wkb) throws CreateGeometryException,

        GeometryException;

    /**

     * <p>

     * This method creates a {@link Geometry} with a concrete type and subtype.

     * The geometry is empty, and all the internal attributes must be assigned

     * to a value when the geometry has been created.

     * </p>

     * <p>

     * This example creates a point2D and sets the coordinates to 1,1. It

     * supposes that there is a Point2D class with the id 1.

     * </p>

     * 

     * <pre>

     * Point point =

     *     (Point) GeometryLocator.getGeometryManager().create(Geometry.TYPES.POINT,

     *         Geometry.SYBTYPES.GEOM2D);

     * point.setX(1);

     * point.setY(1);

     * </pre>

     * 

     * @param type

     *            Type of geometry. Must be a value defined in

     *            {@link Geometry.TYPES}

     * @param subType

     *            SubType of geometry. Must be a value defined in

     *            {@link Geometry.SUBTYPES}

     * @return

     *         A instance of a geometry.

     * @throws CreateGeometryException

     *             This exception is thrown when the manager can not create

     *             the geometry.

     */

    public Geometry create(int type, int subType)

        throws CreateGeometryException;

    /**

     * <p>

     * It creates a null geometry with a concrete subtype.

     * <p>

     * 

     * @param subType

     *            SubType of geometry. Must be a value defined in

     *            {@link Geometry.SUBTYPES}

     * @return

     *         A NullGeometry

     * @throws CreateGeometryException

     *             This exception is thrown when the manager can not create

     *             the geometry.

     * @deprecated use null instead. This method can be removed in next revisions

     */

    public NullGeometry createNullGeometry(int subType)

        throws CreateGeometryException;

    /**

     * <p>

     * Create a new point with a concrete type and sets the value for the X and

     * the Y.

     * </p>

     * 

     * @param x

     *            The X coordinate

     * @param y

     *            The y coordinate

     * @param subType

     *            SubType of geometry. Must be a value defined in

     *            {@link Geometry.SUBTYPES}

     * @throws CreateGeometryException

     *             This exception is thrown when the manager can not create

     *             the geometry.

     * @return

     *         The Point

     */

    public Point createPoint(double x, double y, int subType)

        throws CreateGeometryException;

    /**

     * Create a new line with a concrete type. Use later addVertex to add

     * vertex to te line. 

     * 

     * @param subType SubType of geometry. Must be a value defined in {@link Geometry.SUBTYPES}

     * @return a line

     * @throws CreateGeometryException

     *             This exception is thrown when the manager can not create

     *             the geometry.

     */

    public Line createLine(int subType) throws CreateGeometryException;

    /**

     * @deprecated use createLine

     */

    public Curve createCurve(int subType) throws CreateGeometryException;

    /**

     * Create a new polygon with a concrete type.

     * Use later addVertex to add vertex to te polygon.

     * 

     * @param subType

     *            SubType of geometry. Must be a value defined in

     *            {@link Geometry.SUBTYPES}

     * @return

     *         A polygon

     * @throws CreateGeometryException

     *             This exception is thrown when the manager can not create

     *             the geometry.

     */

    public Polygon createPolygon(int subType)

        throws CreateGeometryException;

    /**

     * @deprecated use createPolygon

     */

    public Surface createSurface(int subType)

        throws CreateGeometryException;

    /**

     * Create a new multipoint with a concrete subtype.

     * Use addPrimitive to populate the multipoint.

     * 

     * @param subType

     *            SubType of geometry. Must be a value defined in

     *            {@link Geometry.SUBTYPES}

     * @return A multipoint

     * @throws CreateGeometryException

     *             This exception is thrown when the manager can not create the

     *             geometry.

     */

    public MultiPoint createMultiPoint(int subType)

        throws CreateGeometryException;

    /**

     * Create a new multicurve with a concrete subtype.

     * Use addPrimitive to populate the multicurve.

     * 

     * @param subType

     *            SubType of geometry. Must be a value defined in

     *            {@link Geometry.SUBTYPES}