/ - Diff - Application: gvSIG desktop - gvSIG

tags/org.gvsig.desktop-2.0.20/org.gvsig.desktop.compat.cdc/org.gvsig.fmap.geometry/org.gvsig.fmap.geometry.api/src/main/resources/META-INF/services/org.gvsig.tools.library.Library
	1	org.gvsig.fmap.geom.GeometryLibrary

     /**
      * 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.handler;
     /**
      * Center handlers.
+     *
      * @author Vicente Caballero Navarro
      */
     public interface CenterHandler extends Handler {
+    }

     /**
      * 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.handler;
     /**
      * Cuadrant handlers.
+     *
      * @author Vicente Caballero Navarro
      */
     public interface CuadrantHandler extends Handler {
+    }

     /**
      * 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.handler;
     import java.awt.geom.Point2D;
     /**
      * This class expands the <code>Handler</code> interface adding support for selection, and
      *  identifying a handler of a geometry.
+     *
      * @see Handler
+     *
      * @author Vicente Caballero Navarro
      */
     public abstract class AbstractHandler implements Handler {
     	/**
     	 * Identifies each handler of a geometry.
     	 */
     	protected int index;
     	/**
     	 * Position of this handler.
+    	 *
     	 * @see #getPoint()
     	 * @see Handler#set(double, double)
     	 * @see Handler#move(double, double)
     	 */
     	protected Point2D point;
     	/**
     	 * True when the handler is selected.
+    	 *
     	 * @see #select
     	 * @see #isSelected()
     	 */
     	private boolean select=false;
     	/*
     	 * (non-Javadoc)
     	 * @see com.iver.cit.gvsig.fmap.core.Handler#getPoint()
     	 */
     	public Point2D getPoint() {
     		return point;
+    	}
     	/**
     	 * Sets the state of the handler. <code>True</code> if is selected, <code>false</code> if it's not.
+    	 *
     	 * @param b <code>true</code> if the handler is selected, <code>false</code>  otherwise
+    	 *
     	 * @see #isSelected()
     	 */
     	public void select(boolean b) {
     		select=b;
+    	}
     	/**
     	 * Returns the state of the handler. <code>True</code> if is selected, <code>false</code> if it's not.
+    	 *
     	 * @return <code>true</code> if the handler is selected,<code>false</code> otherwise
+    	 *
     	 * @see #select(boolean)
     	 */
     	public boolean isSelected(){
     		return select;
+    	}
     	/*
     	 * (non-Javadoc)
     	 * @see com.iver.cit.gvsig.fmap.core.Handler#equalsPoint(java.lang.Object)
     	 */
     	public boolean equalsPoint(Object obj) {
     		Point2D p1=this.getPoint();
     		Point2D p2=((Handler)obj).getPoint();
     		if (p1.getX()==p2.getX() && p1.getY()==p2.getY()) {
     			return true;
+    		}
     		return false;
+    	}
+    }

     /**
      * 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.handler;
     /**
      * Final handlers.
+     *
      * @author Vicente Caballero Navarro
      */
     public interface FinalHandler extends Handler {
+    }

     /**
      * 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.handler;
     import java.awt.geom.Point2D;
     /**
     * <p>In a <i>FMap</i> graphic layer, each geometry drawn has control points named <i>handlers</i>
     * that allow user to move, modify, set, ... that geometry.</p>
+    *
     * <p>Each geometry will have its own handlers, and each one can have different behavior
     * according its nature.</p>
+    *
     * <p>The <code>Handler</code> interface defines the least set of common methods for all
     * geometry handlers.</p>
     */
     public interface Handler {
     	/**
     	 * <p>Generic method of moving in 2D a handler of a geometry using two numbers that
     	 * represent the 2D coordinates.</p>
+    	 *
     	 * <p>Each handler of each geometry adapts this method to its own behavior in that
     	 * geometry, that implies that could not be implemented.</p>
+    	 *
     	 * @param x first dimension coordinate
     	 * @param y second dimension coordinate
+    	 *
     	 * @see #set(double, double)
     	 */
     	public void move(double x, double y);
     	/**
      	 * <p>Generic method of situating in 2D a handler of a geometry using two numbers
      	 * that represent the 2D coordinates.</p>
+    	 *
     	 * <p>Each handler of each geometry adapts this method to its own behavior in that
     	 * geometry, that implies that could not be implemented.</p>
+    	 *
     	 * @param x first dimension coordinate
     	 * @param y second dimension coordinate
+    	 *
     	 * @see #move(double, double)
     	 * @see #getPoint()
     	 */
     	public void set(double x, double y);
     	/**
      	 * <p>Generic method of getting the 2D point that represents a handler of a geometry.</p>
+    	 *
     	 * <p>Each handler of each geometry adapts this method to its own behavior in that
     	 * geometry, that implies that could not be implemented.</p>
+    	 *
     	 * @return point 2D that represents this handler of geometry
+    	 *
     	 * @see #set(double, double)
     	 * @see #move(double, double)
     	 */
     	public Point2D getPoint();
     	/**
     	 * <p>Returns <code>true</code> if the object is a <code>Handler</code> and has the
     	 *  same coordinates as this one.</p>
+    	 *
     	 * @param obj the reference object with which to compare
     	 * @return <code>true</code> if this object is the same as the <code>obj</code>
     	 * argument; <code>false</code> otherwise
+    	 *
     	 * @see #getPoint()
     	 */
     	public boolean equalsPoint(Object obj);
+    }

     /**
      * 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;
     /**
      * This interface defines a set of constants for all data types supported by the
      * DAL.
+     *
      * @author gvSIG Team
      * @version $Id$
+     *
      */
     public interface DataTypes extends org.gvsig.tools.dataTypes.DataTypes {
         /*
+    	 *
     	 */
         public static final int GEOMETRY = OBJECT + 2;
         public static final int ENVELOPE = OBJECT + 3;
+    }

     /**
      * 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.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;
     /**
      * <p>
      * DirectPosition object data types hold the coordinates for
      * a position within some coordinate reference system.
      * The coordinate reference system is described in
      * <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=41126">ISO 19111</a>.
      * </p>
      * @see <a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=26012">ISO 19107</a>
      * @see <a http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=41126">ISO 19111</a>
      * @author <a href="mailto:jpiera@gvsig.org">Jorge Piera</a>
      */
     public interface DirectPosition {
     	/**
     	 * Returns the length of coordinate. This is determined by
     	 * the reference system.
     	 * @return
     	 * The dimension
     	 */
     	public int getDimension();
     	/**
     	 * Returns the ordinate of the given dimension.
     	 * @param dimension
     	 * The dimension to retrieve
     	 * @return
     	 * The value of the ordinate
     	 */
     	public double getOrdinate(int dimension);
+    }

     /**
      * 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 {
+        }
         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.type;
     import org.gvsig.fmap.geom.Geometry;
     import org.gvsig.fmap.geom.exception.CreateGeometryException;
     import org.gvsig.fmap.geom.operation.GeometryOperation;
     /**
      * This class represents the type of a geometry. All the geometries
      * has to have a type that can be retrieved using the
      * {@link Geometry}{@link #getGeometryType()} method.
+     *
      * @author <a href="mailto:jpiera@gvsig.org">Jorge Piera</a>
      */
     public interface GeometryType {
     	/**
     	 * @return the name of the geometry type.
     	 */
     	public String getName();
     	/**
     	 * @return the type of the geometry. It is a constant value
     	 * that has to be one of the values in {@link Geometry.TYPES}
     	 * The type is an abstract representation of the object (Point, Curve...)
     	 * but it is not a concrete representation (Point2D, Point3D...).
     	 */
     	public int getType();
     	/**
     	 * @return the subtype of the geometry. It is a constant value
     	 * that has to be one of the values in {@link Geometry.SUBTYPES}.
     	 * The subtype represents a set of geometries with a
     	 * dimensional relationship (2D, 3D, 2DM...)
     	 */
     	public int getSubType();
     	/**
     	 * Check if a geometry type inherits of other type. E.g:
     	 * the super type of an arc could be a a curve, the super
     	 * type of a circle could be a surface...
     	 * @param geometryType
     	 * the value of the {@link Geometry.TYPES} to check if is
     	 * it super type
     	 * @return
     	 * <true> if the the parameter is a super type of this
     	 * geometry type
     	 */
     	public boolean isTypeOf(int geometryType);
     	/**
          * Check if a geometry subType inherits of other subType. E.g:
          * the super Subtype of a geometry 3D could be a geometry 2D,
          * because the 3D extends the behavior of a geometry 2D.
          * @param geometrySubType
          * the value of the {@link Geometry.SUBTYPES} to check if is
          * it super subType
          * @return
          * <true> if the the parameter is a super subType of this
          * geometry type
          */
     	public boolean isSubTypeOf(int geometrySubType);
         /**
          * Check if a geometry type inherits of other type. E.g:
          * the super type of an arc could be a a curve, the super
          * type of a circle could be a surface...
+         *
          * @param geometryType
          *            the geometry type to check if is it super type
          * @return
          *         if the the parameter is a super type of this
          *         geometry type
          */
         public boolean isTypeOf(GeometryType geometryType);
         /**
          * Check if a geometry subType inherits of other subType. E.g:
          * the super Subtype of a geometry 3D could be a geometry 2D,
          * because the 3D extends the behavior of a geometry 2D.
+         *
          * @param geometryType
          *            the geometry type to check if is it super subtype
          * @return
          *         if the the parameter is a super subType of this
          *         geometry type
          */
         public boolean isSubTypeOf(GeometryType geometryType);
     	/**
     	 * This method creates a {@link Geometry} with the type specified
     	 * by this class. The geometry is empty, and all the internal
     	 * attributes must be assigned to a value when the geometry has
     	 * been created.
+    	 *
     	 * @return
     	 * A empty geometry
     	 * @throws InstantiationException
     	 * This exception is maybe thrown when  the application is  trying
     	 * to instantiate the geometry
     	 * @throws IllegalAccessException
     	 * This exception is maybe thrown when  the application is  trying
     	 * to instantiate the geometry
     	 */
     	public Geometry create() throws CreateGeometryException;
     	/**
     	 * Registers an operation for this geometry type.
     	 * @param index
     	 * @param geomOp
     	 */
     	public void setGeometryOperation(int index, GeometryOperation geomOp);
     	/**
     	 * Get the operation for this geometry at a concrete position
     	 * @param index
     	 * The position of the operation
     	 * @return
     	 * A geometry operation
     	 */
     	public GeometryOperation getGeometryOperation(int index);
     	/**
     	 * @return the geometry as a String
     	 */
     	public String toString();
+    }

     /**
      * 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.type;
     import java.util.HashMap;
     import java.util.Map;
     import org.gvsig.fmap.geom.GeometryException;
     /**
      * @author <a href="mailto:jpiera@gvsig.org">Jorge Piera</a>
      */
     public class GeometryTypeNotValidException extends GeometryException {
     	private static final long serialVersionUID = 2588983103873322295L;
     	/**
     	 * Key to retrieve this exception's message
     	 */
     	private static final String MESSAGE_KEY = "geometry_type_not_valid_exception";
     	/**
     	 * This exception's message. Substitution fields follow the format %(fieldName) and
     	 * must be stored in the Map returned by the values() method.
     	 */
     	private static final String FORMAT_STRING =
     		"The geometry with type %(type) and subType %(subType) is not supported.";
     	/**
     	 * Class name of the geometry type. Should never be null in this exception
     	 */
     	private int type;
     	private int subType;
     	/**
     	 * Main constructor that provides both context data and a cause Exception
     	 * @param geomClass geometry class
     	 * @param e cause exception
     	 */
     	public GeometryTypeNotValidException(int type, int subType, Exception e) {
     		super(FORMAT_STRING, e, MESSAGE_KEY, serialVersionUID);
     		// messageKey = MESSAGE_KEY;
     		// formatString = FORMAT_STRING;
     		// code = serialVersionUID;
     		//
     		// if (e != null) {
     		// initCause(e);
     		// }
     		this.type = type;
     		this.subType = subType;
+    	}
     	/**
     	 * Main constructor that provides both context data and a cause Exception
     	 * @param geomClass geometry class
     	 * @param e cause exception
     	 */
     	public GeometryTypeNotValidException(int type, int subType) {
     		this(type, subType, null);
+    	}
     	protected Map values() {
     		HashMap map = new HashMap();
     		map.put("type", new Integer(type));
     		map.put("subType", new Integer(subType));
     		return map;
+    	}
+    }

tags/org.gvsig.desktop-2.0.20/org.gvsig.desktop.compat.cdc/org.gvsig.fmap.geometry/org.gvsig.fmap.geometry.api/src/main/java/org/gvsig/fmap/geom/type/AbstractGeometryType.java
	1	/**
	2	* gvSIG. Desktop Geographic Information System.
	3	*
	4	* Copyright (C) 2007-2013 gvSIG Association.

Application: gvSIG desktop

Revision 40899