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.aggregate;

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

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

/**

 * <p>

 * This interface is equivalent to the GM_Curve specified in 

 * <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=26012">ISO 19107</a>.

 * MultiCurve is an aggregate class containing only instances of {@link OrientableCurve}.  

 * The association role "element" shall be the set of {@link OrientableCurve}'s contained in 

 * this MultiCurve.

 * </p>

 * @see <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=26012">ISO 19107</a>

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

 */

public interface MultiCurve extends MultiPrimitive{

	/**

	 * Adds a new curve to the  multi curve

	 * @param curve

	 * The curve to add

	 */

	void addCurve(Curve curve);

	/**

	 * Gets the curve that is on a concrete position

	 * inside the multi curve 

	 * @param index

	 * The position

	 * @return

	 * The selected curve

	 */

	Curve getCurveAt(int index);

}

/*

 * To change this license header, choose License Headers in Project Properties.

 * To change this template file, choose Tools | Templates

 * and open the template in the editor.

 */

package org.gvsig.fmap.geom.aggregate;

import org.gvsig.fmap.geom.GeometryException;

/**

 *

 * @author jjdelcerro

 */

public interface MultiLine extends MultiCurve {

}

/*

 * To change this license header, choose License Headers in Project Properties.

 * To change this template file, choose Tools | Templates

 * and open the template in the editor.

 */

package org.gvsig.fmap.geom.aggregate;

import org.gvsig.fmap.geom.Geometry;

import org.gvsig.fmap.geom.GeometryException;

/**

 *

 * @author jjdelcerro

 */

public interface MultiPolygon extends MultiSurface {

}

/**

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

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

/**

 * <p>

 * This interface is equivalent to the GM_MultiPrimitive specified in 

 * <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=26012">ISO 19107</a>.

 * MultiPrimitive is the root class for all primitive aggregates. 

 * The association role "element" shall be the set of {@link Primitive}'s contained 

 * in this MultiPrimitive.

 * </p>

 * @see <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=26012">ISO 19107</a>

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

 */

public interface MultiPrimitive extends Aggregate {

	/**

	 * Adds a new primitive to the primitive

	 * @param primitive

	 * The primitive to add

	 */

	void addPrimitive(Primitive primitive);

	public void ensureCapacity(int capacity);

}

/**

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

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

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

/**

 * <p>

 * This interface is equivalent to the GM_MultiSurface specified in 

 * <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=26012">ISO 19107</a>.

 * MultiSurface is an aggregate class containing only instances of {@link OrientableSurface}. 

 * The association role "element" shall be the set of {@link OrientableSurface}'s 

 * contained in this GMultiSurface.

 * </p>

 * @see <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=26012">ISO 19107</a>

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

 */

public interface MultiSurface extends MultiPrimitive{

	/**

	 * Adds a new surface to the  multi surface

	 * @param surface

	 * The surface to add

	 */

	void addSurface(Surface surface);

	/**

	 * Gets the surface that is on a concrete position

	 * inside the multi surface 

	 * @param index

	 * The position

	 * @return

	 * The selected surface

	 */

	Surface getSurfaceAt(int index);

}

/**

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

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

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

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

/**

 * <p>

 * This interface is equivalent to the GM_MultiPoint specified in 

 * <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=26012">ISO 19107</a>.

 * MultiPoint is an aggregate class containing only points. 

 * The association role "element" shall be the set of {@link Point}'s contained in 

 * this MultiPoint.

 * </p>

 * @see <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=26012">ISO 19107</a>

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

 */

public interface MultiPoint extends MultiPrimitive {

	/**

	 * Adds a new point to the multipoint

	 * @param point

	 * The point to add

	 */

	void addPoint(Point point);

	/**

	 * Gets the point that is on a concrete position

	 * inside the multi point 

	 * @param index

	 * The position

	 * @return

	 * The selected point

	 */

	Point getPointAt(int index);

}

/**

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

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

/**

 * <p>

 * This interface is equivalent to the GM_MultiSolid specified in 

 * <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=26012">ISO 19107</a>.

 * MultiSolid is an aggregate class containing only solids. The association role "element" 

 * shall be the set of {@link Solid}'s contained in this MultiSolid.

 * </p>

 * @see <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=26012">ISO 19107</a>

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

 */

public interface MultiSolid extends MultiPrimitive{

	/**

	 * Adds a new solid to the  multi solid

	 * @param solid

	 * The solid to add

	 */

	void addSolid(Solid solid);

	/**

	 * Gets the solid that is on a concrete position

	 * inside the multi solid 

	 * @param index

	 * The position

	 * @return

	 * The selected solid

	 */

	Solid getSolidAt(int index);

}

/**

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

import org.gvsig.fmap.geom.Geometry;

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.Primitive;

/**

 * <p>

 * This interface is equivalent to the GM_Aggregate specified in 

 * <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=26012">ISO 19107</a>.

 * The aggregates gather geometric objects. Since they will often use orientation 

 * modification, the curve reference and surface references do not go directly to 

 * the {@link Curve} and {@link Surface}, but are directed to {@link OrientableCurve} 

 * and {@link OrientableSurface}.

 * </p>

 * <p>

 * Most geometric objects are contained in features, and cannot be held in 

 * collections that are strong aggregations. For this reason, the collections 

 * described on this package are all weak aggregations, and shall use 

 * references to include geometric objects. 

 * </p> 

 * @see <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=26012">ISO 19107</a>

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

 */

public interface Aggregate extends Geometry{	

	/**

	 * Returns the number of {@link Primitive}'s that composes

	 * this multi geometry.

	 * @return the number of {@link Primitive}'s that composes

	 * this multi geometry.

	 */

	public int getPrimitivesNumber();

	/**

	 * Returns one of the {@link Primitive}'s that is in

	 * a concrete position.

	 * @param i

	 * Geometry position.

	 * @return

	 * A simple geometry.

	 */

	public Primitive getPrimitiveAt(int i);

        /**

         * Returns a Primitive that is the union of all the geometries of the Aggregate.

         * 

         * @return the union of all aggregteds

         * 

         */

        Geometry union() throws GeometryOperationException, GeometryOperationNotSupportedException;

        /**

         * Returns a Primitive that is the intersection of all the geometries of the Aggregate.

         * 

         * @return the union of all aggregteds

         * 

         */

        Geometry intersection() throws GeometryOperationException, GeometryOperationNotSupportedException;

}

/**

 * 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.gvsig.tools.exception.BaseException;

/**

 * Parent exception for the geometry library.

 * 

 * @author 2009- <a href="cordinyana@gvsig.org">C?sar Ordi?ana</a> - gvSIG team

 */

public class GeometryException extends BaseException {

	private static final long serialVersionUID = -8382242322162454758L;

	/**

	 * @see BaseException#BaseException(String, String, long).

	 */

	protected GeometryException(String message, String key, long code) {

		super(message, key, code);

	}

	/**

	 * @see BaseException#BaseException(String, Throwable, String, long)

	 */

	protected GeometryException(String message, Throwable cause, String key,

			long code) {

		super(message, cause, key, code);

	}

	public GeometryException(Throwable cause) {

		super(

			"Error managing geometries", 

			cause, 

			"_Error_managing_geometries", 

			serialVersionUID

		);

	}

}

/**

 * 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.gvsig.tools.dynobject.DynObject;

import org.gvsig.tools.service.Service;

import org.gvsig.tools.service.ServiceException;

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

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

public interface SpatialIndexFactory extends ServiceFactory {

    public String getName();

    Service create(DynObject parameters, ServiceManager serviceManager)

			throws ServiceException;

    public DynObject createParameters();

    public boolean isNearestQuerySupported();

    public boolean canUseToleranzeInNearestQuery();

    public boolean canLimitResults();

    public int getDataTypeSupported();

    public boolean isInMemory();

    public boolean allowNullData();

}

/**

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

import java.awt.geom.Point2D;

import org.cresques.cts.IProjection;

/**

 * 

 * This exception is thrown when the reprojection library is unable to

 * reproject and we need to notify that there was a problem

 * (so far, the reproject method in Geometry API does not

 * throw a standard exception)

 * 

 * @author jldominguez

 *

 */

public class ReprojectionRuntimeException extends RuntimeException {

    public ReprojectionRuntimeException(

        IProjection from_p, IProjection to_p,

        Point2D from_point, Throwable cause) {

        super("Error while reprojecting point " + from_point.toString()

            + " (" + from_p.getAbrev() + " to " + to_p.getAbrev() + ")",

            cause);

    }

}

/**

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

import org.gvsig.fmap.geom.Geometry;

import org.gvsig.fmap.geom.GeometryException;

/**

 * Exception thrown when there is an error creating a new {@link Geometry}.

 * 

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

 */

public class CreateGeometryException extends GeometryException {

	private static final long serialVersionUID = -9092927920296656571L;

	private final static String MESSAGE_FORMAT = "Exception creating the geometry with " +

			"type '%(type)' and subType '%(subType)'.";

	private final static String MESSAGE_KEY = "_CreateGeometryException";

	public CreateGeometryException(int type, int subType, Throwable cause){

		super(MESSAGE_FORMAT, cause, MESSAGE_KEY, serialVersionUID);

		setValue("type", new Integer(type));

		setValue("subType", new Integer(subType));

	}

}

/**

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

import org.gvsig.tools.exception.BaseException;

/**

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

 */

public class CreateEnvelopeException extends BaseException{

	private static final long serialVersionUID = -8080549653325427654L;

	private final static String MESSAGE_FORMAT = "Exception creating the envelope with " +

			"subType '%(subType)'.";

	private final static String MESSAGE_KEY = "_CreateEnvelopeException";

	public CreateEnvelopeException(int subType, Throwable cause){

		super(MESSAGE_FORMAT, cause, MESSAGE_KEY, serialVersionUID);

		setValue("subType", new Integer(subType));

	}

}

/**

 * 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.gvsig.tools.locator.AbstractLocator;

import org.gvsig.tools.locator.Locator;

import org.gvsig.tools.locator.LocatorException;

/**

 * This Locator provides the entry point for the gvSIG 

 * {@link GeometryManager}. 

 * @see {@link Locator}

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

 */

public class GeometryLocator extends AbstractLocator {

	private static final String LOCATOR_NAME = "GeometryLocator";

	/**

	 * GeometryManager name used by the locator to access the instance

	 */

	public static final String GEOMETRY_MANAGER_NAME = "GeometryManager";

	private static final String GEOMETRY_MANAGER_DESCRIPTION = "GeometryManager of gvSIG";

	/**

	 * Unique instance.

	 */

	private static final GeometryLocator instance = new GeometryLocator();

	/**

	 * Return the singleton instance.

	 *

	 * @return the singleton instance

	 */

	public static GeometryLocator getInstance() {

		return instance;

	}

	/* (non-Javadoc)

	 * @see org.gvsig.tools.locator.Locator#getLocatorName()

	 */

	public String getLocatorName() {

		return LOCATOR_NAME;

	}

	/**

	 * Return a reference to {@link GeometryManager}.

	 *

	 * @return a reference to GeometryManager

	 * @throws LocatorException

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

	 *             instantiated

	 * @see Locator#get(String)

	 */

	public static GeometryManager getGeometryManager() throws LocatorException {

		return (GeometryManager) getInstance().get(GEOMETRY_MANAGER_NAME);

	}

	/**

	 * Registers the Class implementing the {@link GeometryManager} interface.

	 *

	 * @param clazz

	 *            implementing the GeometryManager interface

	 */

	public static void registerGeometryManager(Class clazz) {

		getInstance().register(GEOMETRY_MANAGER_NAME, GEOMETRY_MANAGER_DESCRIPTION,

				clazz);

	}

}

/**

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

        // Validate there is any implementation registered.

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

            throw new ReferenceNotRegisteredException(

                GeometryLocator.GEOMETRY_MANAGER_NAME,

                GeometryLocator.getInstance());

        }

    }

    protected void doPostInitialize() throws LibraryException {

        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;