/ - Diff - gvSIG data provider for GPE - gvSIG

Revision 979

     <?xml version="1.0" encoding="ISO-8859-1"?>
     <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     	<modelVersion>4.0.0</modelVersion>
     	<artifactId>org.gvsig.gpe.lib</artifactId>
     	<packaging>pom</packaging>
     	<name>org.gvsig.gpe.lib</name>
     	<description>Generic Persistence Engine library</description>
     	<parent>
     		<groupId>org.gvsig</groupId>
     		<artifactId>org.gvsig.gpe</artifactId>
     		<version>2.1.91</version>
     	</parent>
     	<modules>
     		<module>org.gvsig.gpe.lib.api</module>
     		<module>org.gvsig.gpe.lib.spi</module>
     		<module>org.gvsig.gpe.lib.impl</module>
     	</modules>
     </project>

     /* gvSIG. Geographic Information System of the Valencian Government
+    *
     * Copyright (C) 2007-2008 Infrastructures and Transports Department
     * of the Valencian Government (CIT)
+    *
     * This program is free software; you can redistribute it and/or
     * modify it under the terms of the GNU General Public License
     * as published by the Free Software Foundation; either version 2
     * of the License, or (at your option) any later version.
+    *
     * This program is distributed in the hope that it will be useful,
     * but WITHOUT ANY WARRANTY; without even the implied warranty of
     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     * GNU General Public License for more details.
+    *
     * You should have received a copy of the GNU General Public License
     * along with this program; if not, write to the Free Software
     * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
     * MA  02110-1301, USA.
+    *
     */
     /*
     * AUTHORS (In addition to CIT):
     * 2009 {Iver T.I.}   {Task}
     */
     package org.gvsig.gpe.lib.api;
     import java.io.File;
     import java.net.URI;
     import java.util.Iterator;
     import org.gvsig.gpe.lib.api.exceptions.ParserCreationException;
     import org.gvsig.gpe.lib.api.exceptions.WriterHandlerCreationException;
     import org.gvsig.gpe.lib.api.parser.IGPEContentHandler;
     import org.gvsig.gpe.lib.api.parser.IGPEContentHandlerInmGeom;
     import org.gvsig.gpe.lib.api.parser.IGPEErrorHandler;
     import org.gvsig.gpe.lib.api.writer.IGPEWriterHandler;
     /**
      * @author <a href="mailto:jpiera@gvsig.org">Jorge Piera</a>
      */
     public interface GPEManager {
         /**
          * Return true if exists a driver that can open the file
          * @param uri
          * File to open
          * @return
          * true if the driver exists
          */
         public boolean accept(URI uri);
         /**
     	 * Method to parse a file. It cannot to throw
     	 * any exception and it cannot to return any value.
     	 * In a future it could be implemented like a independent
     	 * thread
     	 * @param contents
     	 * Application ContentHandler
     	 * @param errors
     	 * Application ErrorsHandler
     	 * @param uri
     	 * File to open
     	 * @throws ParserCreationException
     	 * @throws Exception
     	 */
     	public void parse(IGPEContentHandler contents, IGPEErrorHandler errors, URI uri) throws ParserCreationException;
     	/**
     	 * Method to parse a file. It cannot to throw
     	 * any exception and it cannot to return any value.
     	 * In a future it could be implemented like a independent
     	 * thread
     	 * @param contents
     	 * Application ContentHandler
     	 * @param errors
     	 * Application ErrorsHandler
     	 * @param file
     	 * File to open
     	 * @throws ParserCreationException
     	 * @throws Exception
     	 */
     	public void parse(IGPEContentHandler contents, IGPEErrorHandler errors, File file) throws ParserCreationException;
     	 /**
     	 * Method to parse a file. It cannot to throw
     	 * any exception and it cannot to return any value.
     	 * In a future it could be implemented like a independent
     	 * thread
     	 * @param contents
     	 * Application ContentHandler
     	 * @param errors
     	 * Application ErrorsHandler
     	 * @param uri
     	 * File to open
     	 * @throws ParserCreationException
     	 * @throws Exception
     	 */
     	public void parse(IGPEContentHandlerInmGeom contents, IGPEErrorHandler errors, URI uri) throws ParserCreationException;
     	/**
     	 * Method to parse a file. It cannot to throw
     	 * any exception and it cannot to return any value.
     	 * In a future it could be implemented like a independent
     	 * thread
     	 * @param contents
     	 * Application ContentHandler
     	 * @param errors
     	 * Application ErrorsHandler
     	 * @param file
     	 * File to open
     	 * @throws ParserCreationException
     	 * @throws Exception
     	 */
     	public void parse(IGPEContentHandlerInmGeom contents, IGPEErrorHandler errors, File file) throws ParserCreationException;
     	/**
     	 * Create a new content writer from a name
     	 * @param name
     	 * GPEWriterHandler name
     	 * GPEParser name
     	 * @param contenHandler
     	 * Application contenHandler usett to throw the parsing events
     	 * @param errorHandler
     	 * Application errror handler used to put errors and warnings
     	 * @throws GPEWriterHandlerCreationException
     	 */
     	public IGPEWriterHandler createWriter(String name) throws WriterHandlerCreationException;
     	/**
     	 * Create a new writer from a class name. This method can be used
     	 * if the class name is known but, the common method to get a writer
     	 * is using the mime type.     *
     	 * @param prefferredImplClassName
     	 * The name of the class that implements {@link GPEWriterHandler}
     	 * @return
     	 * A writer for a concrete format.
     	 * @throws WriterHandlerCreationException
     	 * If it is not possible to create a writer
     	 */
     	public IGPEWriterHandler createWriterByClass(String prefferredImplClassName) throws WriterHandlerCreationException;
     	/**
     	 * Create a new writer from a mime type. Each writer has a method
     	 * named {@link GPEWriterHandler#getFormat()} that returns the mimetype
     	 * that the writer can write. One writer only supports one mimetype.
     	 * <p>
     	 * This method retrieve all the writers and returns the first
     	 * one that is able to write the mimetype. If there are more
     	 * writer that can write the format will not be used.
     	 * </p>
     	 * @param mimeType
     	 * The mimetype of the file to write
     	 * @return
     	 * A writer that can write the mimetype.
     	 * @throws WriterHandlerCreationException
     	 * If it is not possible to create a writer
     	 * @see
     	 * <a href="http://www.iana.org/assignments/media-types/">http://www.iana.org/assignments/media-types/</a>
     	 */
     	public IGPEWriterHandler createWriterByMimeType(String mimeType) throws WriterHandlerCreationException;
     	/**
     	 * Returns an iterator with the name of all the properties that
     	 * has been established.
     	 */
     	public Iterator getKeys();
     	/**
     	 * Gets a String property
     	 * @param key
     	 * Property name
     	 * @return
     	 */
     	public String getStringProperty(String key);
     	/**
     	 * Gets a int property
     	 * @param key
     	 * Property name
     	 * @return
     	 * The int property or -1
     	 */
     	public int getIntPropertyProperty(String key);
     	/**
     	 * Gets a boolean property. If the property doesn't exist
     	 * it returns false.
     	 * @param key
     	 * Property name
     	 * @return
     	 * The boolean property or false
     	 */
     	public boolean getBooleanProperty(String key);
     	/**
     	 * Gets a property
     	 * @param key
     	 * Property name
     	 * @return
     	 */
     	public Object getProperty(String key);
     	/**
     	 * Sets a property
     	 * @param key
     	 * @param value
     	 */
     	public void setProperty(String key, Object value);
     	public String getDefaultProjection(File file) throws ParserCreationException;
+    }

     /* gvSIG. Geographic Information System of the Valencian Government
+    *
     * Copyright (C) 2007-2008 Infrastructures and Transports Department
     * of the Valencian Government (CIT)
+    *
     * This program is free software; you can redistribute it and/or
     * modify it under the terms of the GNU General Public License
     * as published by the Free Software Foundation; either version 2
     * of the License, or (at your option) any later version.
+    *
     * This program is distributed in the hope that it will be useful,
     * but WITHOUT ANY WARRANTY; without even the implied warranty of
     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     * GNU General Public License for more details.
+    *
     * You should have received a copy of the GNU General Public License
     * along with this program; if not, write to the Free Software
     * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
     * MA  02110-1301, USA.
+    *
     */
     /*
     * AUTHORS (In addition to CIT):
     * 2008 Iver T.I.  {{Task}}
     */
     package org.gvsig.gpe.lib.api;
     /**
      * This class contains the generic properties for all the
      * GPE parsers and writers.
      */
     public class GPEProperties {
     	public static final String DECIMAL_DIGITS = "decimalDigits";
+    }

     package org.gvsig.gpe.lib.api.parser;
     /* gvSIG. Sistema de Informaci?n Geogr?fica de la Generalitat Valenciana
+     *
      * Copyright (C) 2004 IVER T.I. and Generalitat Valenciana.
+     *
      * This program is free software; you can redistribute it and/or
      * modify it under the terms of the GNU General Public License
      * as published by the Free Software Foundation; either version 2
      * of the License, or (at your option) any later version.
+     *
      * This program is distributed in the hope that it will be useful,
      * but WITHOUT ANY WARRANTY; without even the implied warranty of
      * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      * GNU General Public License for more details.
+     *
      * You should have received a copy of the GNU General Public License
      * along with this program; if not, write to the Free Software
      * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307,USA.
+     *
      * For more information, contact:
+     *
      *  Generalitat Valenciana
      *   Conselleria d'Infraestructures i Transport
      *   Av. Blasco Ib??ez, 50
      *   46010 VALENCIA
      *   SPAIN
+     *
      *      +34 963862235
      *   gvsig@gva.es
      *      www.gvsig.gva.es
+     *
      *    or
+     *
      *   IVER T.I. S.A
      *   Salamanca 50
      *   46005 Valencia
      *   Spain
+     *
      *   +34 963163400
      *   dac@iver.es
      */
     /* CVS MESSAGES:
+     *
      * $Id$
      * $Log$
+     *
      */
     /**
      * @author Jorge Piera LLodr? (jorge.piera@iver.es)
      */
     public interface IGPEContentHandlerSFP0 {
     	/**
     	 * This method indicates that the parser has found a curve.
     	 * @param id
     	 * curve identifier
     	 * @param coords
     	 * A coordinates iterator
     	 * @param srs
     	 * Spatial reference system
     	 * @return
     	 * Consumer application object that represents a lineString
     	 */
     	public Object startCurve(String id, ICoordinateIterator coords, String srs);
     	/**
     	 * This method indicates that the parser has found a curve.
     	 * @param id
     	 * curve identifier
     	 * @param srs
     	 * Spatial reference system
     	 * @return
     	 * Consumer application object that represents a lineString
     	 */
     	public Object startCurve(String id, String srs);
     	/**
          * It is thrown when the Curve has been completely parsed.
     	 * @param Curve
     	 * Consumer application object that represents a Curve
     	 */
     	public void endCurve(Object Curve);
     	/**
     	 * It adds a segment to a curve.
     	 * @param segment
     	 * The segment to add
     	 * @param curve
     	 * The curve
     	 */
     	public void addSegmentToCurve(Object segment, Object curve);
     	/**
     	 * This method indicates that the parser has found a multiCurve.
     	 * @param id
     	 * MultyCurve identifier
     	 * @param srs
     	 * Spatial reference system
     	 * @return
     	 * Consumer application object that represents a multiCurve
     	 */
     	public Object startMultiCurve(String id, String srs);
     	public Object startMultiCurve(String id, String srs, int dimension);
     	/**
     	 * It is thrown when the multiCurve has been completely parsed
     	 * @param multiCurve
     	 * Consumer application object that represents a multiCurve
     	 */
     	public void endMultiCurve(Object multiCurve);
     	/**
     	 * It is thrown to add a curve to one multiCurve.
     	 * @param curve
          * Consumer application object that represents a curve
     	 * @param multiCurve
     	 * Consumer application object that represents a multiCurve
     	 */
     	public void addCurveToMultiCurve(Object curve, Object multiCurve);
+    }

     package org.gvsig.gpe.lib.api.parser;
     import java.io.IOException;
     import org.gvsig.xmlpull.lib.api.stream.IQName;
     /* gvSIG. Sistema de Informaci?n Geogr?fica de la Generalitat Valenciana
+    *
     * Copyright (C) 2004 IVER T.I. and Generalitat Valenciana.
+    *
     * This program is free software; you can redistribute it and/or
     * modify it under the terms of the GNU General Public License
     * as published by the Free Software Foundation; either version 2
     * of the License, or (at your option) any later version.
+    *
     * This program is distributed in the hope that it will be useful,
     * but WITHOUT ANY WARRANTY; without even the implied warranty of
     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     * GNU General Public License for more details.
+    *
     * You should have received a copy of the GNU General Public License
     * along with this program; if not, write to the Free Software
     * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307,USA.
+    *
     * For more information, contact:
+    *
     *  Generalitat Valenciana
     *   Conselleria d'Infraestructures i Transport
     *   Av. Blasco Ib??ez, 50
     *   46010 VALENCIA
     *   SPAIN
+    *
     *      +34 963862235
     *   gvsig@gva.es
     *      www.gvsig.gva.es
+    *
     *    or
+    *
     *   IVER T.I. S.A
     *   Salamanca 50
     *   46005 Valencia
     *   Spain
+    *
     *   +34 963163400
     *   dac@iver.es
     */
     /* CVS MESSAGES:
+    *
     * $Id$
     * $Log$
+    *
     */
     /**
     * @author Carlos S?nchez Peri??n
     */
     public interface IAttributesIterator {
     	/**
         * Returns whether there are more attributes in this sequence
+        *
         * @return
         * @throws IOException
         */
        public boolean hasNext() throws IOException;
        /**
         * Returns the dimension of the attributes list. Consumer code should use it to
         * pass a buffer with the correct lenght.
+        *
         * @return
         */
        public int getNumAttributes();
        /**
         * Value of next attribute
         */
        public Object nextAttribute() throws IOException;
        /**
         * @return the name of the next attribute
         */
        public IQName nextAttributeName();
        /**
         * Initializes the iterator
         */
        public void initialize();
+    }

     package org.gvsig.gpe.lib.api.parser;
     /* gvSIG. Sistema de Informacin Geogrfica de la Generalitat Valenciana
+    *
     * Copyright (C) 2004 IVER T.I. and Generalitat Valenciana.
+    *
     * This program is free software; you can redistribute it and/or
     * modify it under the terms of the GNU General Public License
     * as published by the Free Software Foundation; either version 2
     * of the License, or (at your option) any later version.
+    *
     * This program is distributed in the hope that it will be useful,
     * but WITHOUT ANY WARRANTY; without even the implied warranty of
     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     * GNU General Public License for more details.
+    *
     * You should have received a copy of the GNU General Public License
     * along with this program; if not, write to the Free Software
     * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307,USA.
+    *
     * For more information, contact:
+    *
     *  Generalitat Valenciana
     *   Conselleria d'Infraestructures i Transport
     *   Av. Blasco Ibez, 50
     *   46010 VALENCIA
     *   SPAIN
+    *
     *      +34 963862235
     *   gvsig@gva.es
     *      www.gvsig.gva.es
+    *
     *    or
+    *
     *   IVER T.I. S.A
     *   Salamanca 50
     *   46005 Valencia
     *   Spain
+    *
     *   +34 963163400
     *   dac@iver.es
     */
     /* CVS MESSAGES:
+    *
     * $Id: IGPEContentHandler.java 202 2007-11-27 12:00:11Z jpiera $
     * $Log$
     * Revision 1.18  2007/06/20 09:35:37  jorpiell
     * Add the javadoc comments
+    *
     * Revision 1.17  2007/06/19 10:34:51  jorpiell
     * Add some comments and creates a warning when an operation is not supported
+    *
+    *
     */
     /**
      * This interface defines the "contract" between the consumer
      * application and libGPE. It has methods that will be invoke
      * by the parser every time that an event happens
      * @author Jorge Piera Llodr (jorge.piera@iver.es)
      * @author Carlos Snchez Perin (sanchez_carper@gva.es)
      */
     public interface IGPEContentHandlerInmGeom extends IGPEContentHandlerSFP0{
     	/**
     	 * This method is thrown when the parser find a new
     	 * bounding box.
     	 * @param id
     	 * Bounding box identifier
     	 * @param coords
     	 * A coordinates iterator
     	 * @param srs
     	 * Spatial reference system
     	 * @return
     	 * The consumer application object that represents
     	 *  a bounding box
     	 */
     	public Object startBbox(String id, ICoordinateIterator coords, String srs);
     	/**
     	 * This method indicates that the parser thas finished to
     	 * parse the bounding box.
     	 * @param bbox
     	 * The consumer application object that represents a
     	 * bounding box
     	 */
     	public void endBbox(Object bbox);
     	/**
     	 * It is thrown every time that a new layer is detected.
     	 * @param id
     	 * Layer identifier
     	 * @param namespace
     	 * XML namespace
     	 * @param name
     	 * Layer name
     	 * @param description
     	 * Layer description
     	 * @param srs
     	 * Layer spatial reference system
     	 * @param attributes
     	 * Layer attributes
     	 * @param parentLayer
     	 * Layer that contains it
     	 * @param bBox
     	 * Layer bounding box
     	 * @return
     	 * The consumer application object that represents a layer
     	 */
     	public Object startLayer(String id,  String namespace, String name, String description,
     			String srs, IAttributesIterator attributes, Object parentLayer, Object bBox);
     	/**
     	 * It is thrown when a layer has been finished to parse.
     	 * @param layer
     	 * The consumer application object that represents a layer
     	 */
     	public void endLayer(Object layer);
     	/**
     	 * It adds a name to one layer that has been previously
     	 * created using the startLayer method.
     	 * @param name
     	 * Layer name
     	 * @param layer
     	 * The consumer application object that represents a layer
     	 */
     	public void addNameToLayer(String name, Object layer);
     	/**
     	 * It adds the description to one layer that has been previously
     	 * created using the startLayer method.
     	 * @param description
     	 * Layer description
     	 * @param layer
     	 * The consumer application object that represents a layer
     	 */
     	public void addDescriptionToLayer(String description, Object layer);
     	/**
     	 * It adds a spatial reference system to one layer that
     	 * has been previously created using the startLayer method.
     	 * @param srs
     	 * Spatial reference system
     	 * @param layer
     	 * The consumer application object that represents a layer
     	 */
     	public void addSrsToLayer(String srs, Object Layer);
     	/**
     	 * It establish the relationship parent-child between two layers
     	 * that have been previously created using the startLayer method.
     	 * @param parent
     	 * The consumer application object that represents the parent layer
     	 * @param layer
     	 * The consumer application object that represents the child layer
     	 */
     	public void addParentLayerToLayer(Object parent, Object layer);
     	/**
     	 * It adds a bounding box to one layer that  has been previously
     	 * created using the startLayer method.
     	 * @param bbox
     	 * Layer bounding box
     	 * @param layer
     	 * The consumer application object that represents a layer
     	 */
     	public void addBboxToLayer(Object bbox, Object layer);
     	/**
     	 * It is thrown when the parser has found a new feature.
     	 * @param id
     	 * Feature identifier
     	 * @param name
     	 * Feature name
     	 * @param namespace
     	 * XML namespace
     	 * @param attributes
     	 * Feature attributes
     	 * @param layer
     	 * Consumer application object that represents a layer
     	 * @return
     	 * Consumer application object that represents a feature
     	 */
     	public Object startFeature(String id, String namespace, String name, IAttributesIterator attributes, Object layer);
     	/**
     	 * This method is thrown when the parser has finished to
     	 * parse a feature.
     	 * @param feature
     	 * Consumer application object that represents a feature
     	 */
     	public void endFeature(Object feature);
     	/**
     	 * This method adds a name to one layer that has been
     	 * previously created using the startFeature method.
     	 * @param name
     	 * Feature name
     	 * @param feature
          * Consumer application object that represents a feature
     	 */
     	public void addNameToFeature(String name, Object feature);
     	/**
     	 * This method adds a feature to one layer that has been
     	 * previously created using the startLayer method.
     	 * @param feature
     	 * Consumer application object that represents a feature
     	 * @param layer
     	 * Consumer application object that represents a layer
     	 */
     	public void addFeatureToLayer(Object feature, Object layer);
     	/**
     	 * It is thrown when the parser has found a new element
     	 * @param namespace
     	 * XML namespace
     	 * @param name
     	 * Element name
     	 * @param value
     	 * Element value
     	 * @param attributes
     	 * Element attributes
     	 * @param parentElement
     	 * The parent of this element (if exists)
     	 * @return
     	 * Consumer application object that represents an element
     	 */
     	public Object startElement(String namespace, String name, Object value,
     			IAttributesIterator attributes, Object parentElement);
     	/**
     	 * This method is thrown when the parser find the end
     	 * of an element.
     	 * @param element
     	 * Consumer application object that represents an element
     	 */
     	public void endElement(Object element);
     	/**
     	 * It is thrown to establish a relationship parent-child
     	 * between two elements.
     	 * @param parent
     	 * Consumer application object that represents the parent element
     	 * @param element
     	 * Consumer application object that represents the child element
     	 */
     	public void addParentElementToElement(Object parent, Object element);
     	/**
     	 * This method adds an element to one feature that has been
     	 * previously created using the startFeature method
     	 * @param element
     	 * Consumer application object that represents an element
     	 * @param feature
     	 * Consumer application object that represents the feature
     	 */
     	public void addElementToFeature(Object element, Object feature);
     	/**
     	 * This method indicates that the parser has found a point.
     	 * @param id
     	 * Point identifier
     	 * @param coords
     	 * A coordinates iterator
     	 * @param srs
     	 * Spatial reference system
     	 * @return
     	 * Consumer application object that represents a point
     	 */
     	public Object startPoint(String id, ICoordinateIterator coords, String srs);
     	/**
     	 * It is thrown when the point has been completely parsed.
     	 * @param point
     	 * Consumer application object that represents a point
     	 */
     	public void endPoint(Object point);
     	/**
     	 * This method indicates that the parser has found a lineString.
     	 * @param id
     	 * LineString identifier
     	 * @param coords
     	 * A coordinates iterator
     	 * @param srs
     	 * Spatial reference system
     	 * @return
     	 * Consumer application object that represents a lineString
     	 */
     	public Object startLineString( String id, ICoordinateIterator coords, String srs);
     	/**
          * It is thrown when the lineString has been completely parsed.
     	 * @param lineString
     	 * Consumer application object that represents a lineString
     	 */
     	public void endLineString(Object lineString);
     	/**
     	 * This method indicates that the parser has found a linearRing.
     	 * @param id
     	 * LinearRing identifier
     	 * @param coords
     	 * A coordinates iterator
     	 * @param srs
     	 * Spatial reference system
     	 * @return
     	 * Consumer application object that represents a linarRing
     	 */
     	public Object startLinearRing(String id, ICoordinateIterator coords, String srs);
     	/**
     	 * It is thrown when the linearRing has been completely parsed.
     	 * @param linearRing
     	 * Consumer application object that represents a linearRing
     	 */
     	public void endLinearRing(Object linearRing);
     	/**
     	 * This method indicates that the parser has found a polygon.
     	 * @param id
     	 * Polygon identifier
     	 * @param coords
     	 * A coordinates iterator
     	 * @param srs
     	 * Spatial reference system
     	 * @return
     	 * Consumer application object that represents a polygon
     	 */
     	public Object startPolygon(String id, ICoordinateIterator coords, String srs);
     	/**
     	 * It is thrown when the polygon has been completely parsed.
     	 * @param polygon
     	 * Consumer application object that represents a polygon
     	 * As a polygon can have holes, when instantiating an inmutable polygon is needed to know the outerBoundary and the holes, the instantiating takes place here
     	 */
     	public Object endPolygon(Object polygon);
     	/**
     	 * This method associates a innerPolygon with its polygon
     	 * @param innerPolygon
          * Consumer application object that represents a innerPolygon
     	 * @param Polygon
     	 * Consumer application object that represents a polygon
     	 */
     	public void addInnerPolygonToPolygon(Object innerPolygon, Object Polygon);
     	/**
     	 * This method indicates that the parser has found a InnerPolygon.
     	 * @param id
     	 * InnerPolygon identifier
     	 * @param coords
     	 * A coordinates iterator
     	 * @param srs
     	 * Spatial reference system
     	 * @return
     	 * Consumer application object that represents a innerPolygon
     	 */
     	public Object startInnerPolygon(String id, ICoordinateIterator coords, String srs);
     	/**
     	 * It is thrown when the innerPolygon has been completely parsed.
     	 * @param innerPolygon
     	 * Consumer application object that represents a innerPolygon
     	 */
     	public void endInnerPolygon(Object innerPolygon);
     	/**
     	 * This method indicates that the parser has found a multipoint.
     	 * @param id
     	 * MultiPoint identifier
     	 * @param srs
     	 * Spatial reference system
     	 * @return
     	 * Consumer application object that represents a multiPoint
     	 */
     	public Object startMultiPoint(String id, String srs);
         public Object startMultiPoint(String id, String srs, int dimension);
     	/**
     	 * It is thrown when the multiPoint has been completely parsed
     	 * @param multiPoint
     	 * Consumer application object that represents a multiPoint
     	 */
     	public Object endMultiPoint(Object multiPoint);
     	/**
     	 * It is thrown to add a point to one multiPoint.
     	 * @param point
          * Consumer application object that represents a point
     	 * @param multiPoint
     	 * Consumer application object that represents a multiPoint
     	 */
     	public void addPointToMultiPoint(Object point,Object multiPoint);
     	/**
     	 * This method indicates that the parser has found a multiLineString.
     	 * @param id
     	 * MultiLineString identifier
     	 * @param srs
     	 * Spatial reference system
     	 * @return
     	 * Consumer application object that represents a multiLineString
     	 */
     	public Object startMultiLineString(String id, String srs);
         public Object startMultiLineString(String id, String srs, int dimension);
     	/**
     	 * It is thrown when the multiLineString has been completely parsed
     	 * @param multiLineString
     	 * Consumer application object that represents a multiLineString
     	 */
     	public Object endMultiLineString(Object multiLineString);
     	/**
     	 * It is thrown to add a lineString to one lineString.
     	 * @param lineString
          * Consumer application object that represents a lineString
     	 * @param multiLineString
     	 * Consumer application object that represents a multiLineString
     	 */
     	public void addLineStringToMultiLineString(Object lineString,Object multiLineString);
     	/**
     	 * This method indicates that the parser has found a multiPolygon.
     	 * @param id
     	 * MultiPolygon identifier
     	 * @param srs
     	 * Spatial reference system
     	 * @return
     	 * Consumer application object that represents a multiPolygon
     	 */
     	public Object startMultiPolygon(String id, String srs);
         public Object startMultiPolygon(String id, String srs, int dimension);
     	/**
     	 * It is thrown when the multiPolygon has been completely parsed
     	 * @param multiPolygon
     	 * Consumer application object that represents a multiPolygon
     	 */
     	public Object endMultiPolygon(Object multiPolygon);
     	/**
     	 * It is thrown to add a polygon to one multiPolygon.
     	 * @param polygon
          * Consumer application object that represents a polygon
     	 * @param multiPolygon
     	 * Consumer application object that represents a multiPolygon
     	 */
     	public void addPolygonToMultiPolygon(Object polygon,Object multiPolygon);
     	/**
     	 * This method indicates that the parser has found a multiGeometry.
     	 * @param id
     	 * MultiGeometry identifier
     	 * @param srs
     	 * Spatial reference system
     	 * @return
     	 * Consumer application object that represents a multiGeometry
     	 */
     	public Object startMultiGeometry(String id, String srs);
     	/**
     	 * It is thrown when the multiGeometry has been completely parsed
     	 * @param multiGeometry
     	 * Consumer application object that represents a multiGeometry
     	 */
     	public Object endMultiGeometry(Object multiGeometry);
     	/**
     	 * It is thrown to add a geometry to one multiGeometry.
     	 * @param geometry
          * Consumer application object that represents a geometry
     	 * @param multiGeometry
     	 * Consumer application object that represents a multiGeometry
     	 */
     	public void addGeometryToMultiGeometry(Object geometry,Object multiGeometry);
     	/**
     	 * This method adds a bounding box to a feature.
     	 * @param bbox
     	 * Consumer application object that represents a bounding
     	 * box
     	 * @param feature
     	 * Consumer application object that represents a feature
     	 */
     	public void addBboxToFeature(Object bbox, Object feature);
     	/**
     	 * This method adds a geometry to a feature.
     	 * @param geometry
     	 * Consumer application object that represents a geometry
     	 * @param feature
     	 * Consumer application object that represents a feature
     	 */
     	public void addGeometryToFeature(Object geometry, Object feature);
     	/**
     	 * It is thrown when the parser has found a new metadata tag
     	 * @param type
     	 * String with the type of metadata, if is a description or any else
     	 * @param data
     	 * String with the value of the data.
     	 * @param attributes
     	 * Object to pass the Atributtes
     	 * @return
     	 * Consumer application object that represents metadata
     	 */
     	public Object startMetadata(String type, String data, IAttributesIterator attributes);
     	/**
     	 * This method adds metadata to feature.
     	 * @param metadata
     	 * Consumer application object that represents metadata
     	 * @param feature
     	 * Consumer application object that represents a feature
     	 */
     	public void addMetadataToFeature(Object metadata, Object feature);
     	/**
     	 * This method adds metadata to complex metadata.
     	 * @param metadata
     	 * Consumer application object that represents metadata
     	 * @param parent
     	 * Consumer application object that represents the complex metadata
     	 */
     	public void addMetadataToMetadata(Object metadata, Object parent);
     	/**
     	 * This method is thrown when the parser find the end of the metadata
     	 * of an element.
     	 * @param metadata
     	 * Consumer application object that represents metadata
     	 */
     	public void endMetadata(Object metadata);
     	/**
     	 * This method is thrown when the parser find the end of and element time tag
     	 * @param time
     	 * Consumer application object that represents time
     	 */
     	public void endTime(Object time);
     	/**
     	 * It is thrown when the parser has found a new time tag tag
     	 * @param type
     	 * String with the type of time, if is a description or any else
     	 * @param data
     	 * String with the value of the data.
     	 * @return
     	 * Consumer application object that represents time
     	 */
     	public Object startTime(String name, String description, String type, String time, Object previous, Object next);
     	public Object startTime(String type, String time);
     	/**
     	 * This method adds time to feature.
     	 * @param time
     	 * Consumer application object that represents time
     	 * @param feature
     	 * Consumer application object that represents a feature
     	 */
     	public void addTimeToFeature(Object time, Object feature);
+    }

     package org.gvsig.gpe.lib.api.parser;
     import java.io.IOException;
     /**
      * An iterator over the current geometry being parsed intended to be given to the consumer
      * {@link IGPEContentHandler}.
      * <p>
      * This provides an abstraction for specific format parsers to optimize as needed without imposing a
      * coordinate structure to the consumer application which may be inefficient for its geometry model.
      * </p>
      * <p>
      * Basically, using this interface allows for the following optimizations:
      * <ul>
      * <li>Avoid unneeded coordinate parsing where not necessary
      * <li>Allows to serve geometry sequences of arbitrary dimensions
      * <li>Avoids unnecessary copy of large coordinate buffers from different arrays of doubles,
      * letting the consumer iterate over the coordinates and build its geometries more efficiently
      * </ul>
      * </p>
+     *
      * @author Gabriel Roldan (TOPP)
      * @version $Id: ICoordinateIterator.java 19589 2008-03-12 14:14:54Z groldan $
      */
     public interface ICoordinateIterator {
         /**
          * Returns whether there are more coordinates in this sequence
+         *
          * @return
          * @throws IOException
          */
         public boolean hasNext() throws IOException;
         /**
          * Returns the dimension of the coordinate tuple being served. Consumer code should use it to
          * pass a buffer with the correct lenght to {@link #next(double[])}
+         *
          * @return
          */
         public int getDimension();
         /**
          * @param buffer where to store the parsed coordinates. The buffer lenght shall be >=
          *            {@link #getDimension()}
          * @throws IOException
          */
         public void next(double[] buffer) throws IOException;
+    }

     package org.gvsig.gpe.lib.api.parser;
     /* gvSIG. Sistema de Informaci?n Geogr?fica de la Generalitat Valenciana
+     *
      * Copyright (C) 2004 IVER T.I. and Generalitat Valenciana.
+     *
      * This program is free software; you can redistribute it and/or
      * modify it under the terms of the GNU General Public License
      * as published by the Free Software Foundation; either version 2
      * of the License, or (at your option) any later version.
+     *
      * This program is distributed in the hope that it will be useful,
      * but WITHOUT ANY WARRANTY; without even the implied warranty of
      * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      * GNU General Public License for more details.
+     *
      * You should have received a copy of the GNU General Public License
      * along with this program; if not, write to the Free Software
      * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307,USA.
+     *
      * For more information, contact:
+     *
      *  Generalitat Valenciana
      *   Conselleria d'Infraestructures i Transport
      *   Av. Blasco Ib??ez, 50
      *   46010 VALENCIA
      *   SPAIN
+     *
      *      +34 963862235
      *   gvsig@gva.es
      *      www.gvsig.gva.es
+     *
      *    or
+     *
      *   IVER T.I. S.A
      *   Salamanca 50
      *   46005 Valencia
      *   Spain
+     *
      *   +34 963163400
      *   dac@iver.es
      */
     /* CVS MESSAGES:
+     *
      * $Id: IGPEErrorHandler.java 153 2007-06-20 09:35:37Z jorpiell $
      * $Log$
      * Revision 1.4  2007/06/20 09:35:37  jorpiell
      * Add the javadoc comments
+     *
      * Revision 1.3  2007/04/19 07:23:20  jorpiell
      * Add the add methods to teh contenhandler and change the register mode
+     *
      * Revision 1.2  2007/04/12 17:06:42  jorpiell
      * First GML writing tests
+     *
      * Revision 1.1  2007/04/11 08:46:21  csanchez
      * Actualizacion protoripo libGPE
+     *
+     *
      */
     /**
      * This interface defines the GPE error handler. It has methods
      * to register the errors and the warnings that can happen
      * wherear a parser is reading or writing a file.
      * @author Jorge Piera Llodr? (jorge.piera@iver.es)
      * @author Carlos S?nchez Peri??n (sanchez_carper@gva.es)
      */
     public interface IGPEErrorHandler {
     	/**
     	 * This method is invoked when a parser has found
     	 * an error that has to stop the reading or the writing
     	 * process
     	 * @param e
     	 * The detected exception
     	 */
     	public void addError(Throwable e);
     	public int getErrorsSize();
     	public Throwable getErrorAt(int i);
     	/**
     	 * This method is invoke when a parser has detected a
     	 * error, but it is able to manage it by itself
     	 * @param e
     	 * The detected exception
     	 */
     	public void addWarning(Throwable e);
     	public int getWarningsSize();
     	public Throwable getWarningAt(int i);
+    }

     package org.gvsig.gpe.lib.api.parser;
     /* gvSIG. Sistema de Informaci?n Geogr?fica de la Generalitat Valenciana
+    *
     * Copyright (C) 2004 IVER T.I. and Generalitat Valenciana.
+    *
     * This program is free software; you can redistribute it and/or
     * modify it under the terms of the GNU General Public License
     * as published by the Free Software Foundation; either version 2
     * of the License, or (at your option) any later version.
+    *
     * This program is distributed in the hope that it will be useful,
     * but WITHOUT ANY WARRANTY; without even the implied warranty of
     * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     * GNU General Public License for more details.
+    *
     * You should have received a copy of the GNU General Public License
     * along with this program; if not, write to the Free Software
     * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307,USA.
+    *
     * For more information, contact:
+    *
     *  Generalitat Valenciana
     *   Conselleria d'Infraestructures i Transport
     *   Av. Blasco Ib??ez, 50
     *   46010 VALENCIA
     *   SPAIN
+    *
     *      +34 963862235
     *   gvsig@gva.es
     *      www.gvsig.gva.es
+    *
     *    or
+    *
     *   IVER T.I. S.A
     *   Salamanca 50
     *   46005 Valencia
     *   Spain
+    *
     *   +34 963163400
     *   dac@iver.es
     */
     /* CVS MESSAGES:
+    *
     * $Id: IGPEContentHandler.java 202 2007-11-27 12:00:11Z jpiera $
     * $Log$
     * Revision 1.18  2007/06/20 09:35:37  jorpiell
     * Add the javadoc comments
+    *
     * Revision 1.17  2007/06/19 10:34:51  jorpiell
     * Add some comments and creates a warning when an operation is not supported
+    *
+    *
     */
     /**
      * This interface defines the "contract" between the consumer
      * application and libGPE. It has methods that will be invoke
      * by the parser every time that an event happens
      * @author Jorge Piera Llodr? (jorge.piera@iver.es)
      * @author Carlos S?nchez Peri??n (sanchez_carper@gva.es)
      */
     public interface IGPEContentHandler extends IGPEContentHandlerSFP0{
     	/**
     	 * This method is thrown when the parser find a new
     	 * bounding box.
     	 * @param id
     	 * Bounding box identifier
     	 * @param coords
     	 * A coordinates iterator
     	 * @param srs
     	 * Spatial reference system
     	 * @return
     	 * The consumer application object that represents
     	 *  a bounding box
     	 */
     	public Object startBbox(String id, ICoordinateIterator coords, String srs);
     	/**
     	 * This method indicates that the parser thas finished to
     	 * parse the bounding box.
     	 * @param bbox
     	 * The consumer application object that represents a
     	 * bounding box
     	 */
     	public void endBbox(Object bbox);
     	/**
     	 * It is thrown every time that a new layer is detected.
     	 * @param id
     	 * Layer identifier
     	 * @param namespace
     	 * XML namespace
     	 * @param name
     	 * Layer name
     	 * @param description
     	 * Layer description
     	 * @param srs
     	 * Layer spatial reference system
     	 * @param attributes
     	 * Layer attributes
     	 * @param parentLayer
     	 * Layer that contains it
     	 * @param bBox
     	 * Layer bounding box
     	 * @return
     	 * The consumer application object that represents a layer
     	 */
     	public Object startLayer(String id,  String namespace, String name, String description,
     			String srs, IAttributesIterator attributes, Object parentLayer, Object bBox);
     	/**
     	 * It is thrown when a layer has been finished to parse.
     	 * @param layer
     	 * The consumer application object that represents a layer
     	 */
     	public void endLayer(Object layer);
     	/**
     	 * It adds a name to one layer that has been previously
     	 * created using the startLayer method.
     	 * @param name
     	 * Layer name
     	 * @param layer
     	 * The consumer application object that represents a layer
     	 */
     	public void addNameToLayer(String name, Object layer);
     	/**
     	 * It adds the description to one layer that has been previously
     	 * created using the startLayer method.
     	 * @param description
     	 * Layer description
     	 * @param layer
     	 * The consumer application object that represents a layer
     	 */
     	public void addDescriptionToLayer(String description, Object layer);
     	/**
     	 * It adds a spatial reference system to one layer that
     	 * has been previously created using the startLayer method.
     	 * @param srs
     	 * Spatial reference system
     	 * @param layer
     	 * The consumer application object that represents a layer
     	 */
     	public void addSrsToLayer(String srs, Object Layer);
     	/**
     	 * It establish the relationship parent-child between two layers
     	 * that have been previously created using the startLayer method.
     	 * @param parent
     	 * The consumer application object that represents the parent layer
     	 * @param layer
     	 * The consumer application object that represents the child layer
     	 */
     	public void addParentLayerToLayer(Object parent, Object layer);
     	/**
     	 * It adds a bounding box to one layer that  has been previously
     	 * created using the startLayer method.
     	 * @param bbox
     	 * Layer bounding box
     	 * @param layer
     	 * The consumer application object that represents a layer
     	 */
     	public void addBboxToLayer(Object bbox, Object layer);
     	/**
     	 * It is thrown when the parser has found a new feature.
     	 * @param id
     	 * Feature identifier
     	 * @param name
     	 * Feature name
     	 * @param namespace
     	 * XML namespace
     	 * @param attributes
     	 * Feature attributes
     	 * @param layer
     	 * Consumer application object that represents a layer
     	 * @return
     	 * Consumer application object that represents a feature
     	 */
     	public Object startFeature(String id, String namespace, String name, IAttributesIterator attributes, Object layer);
     	/**
     	 * This method is thrown when the parser has finished to
     	 * parse a feature.
     	 * @param feature
     	 * Consumer application object that represents a feature
     	 */
     	public void endFeature(Object feature);
     	/**
     	 * This method adds a name to one layer that has been
     	 * previously created using the startFeature method.
     	 * @param name
     	 * Feature name
     	 * @param feature
          * Consumer application object that represents a feature
     	 */
     	public void addNameToFeature(String name, Object feature);
     	/**
     	 * This method adds a feature to one layer that has been
     	 * previously created using the startLayer method.
     	 * @param feature
     	 * Consumer application object that represents a feature
     	 * @param layer
     	 * Consumer application object that represents a layer
     	 */

... This diff was truncated because it exceeds the maximum size that can be displayed.

Also available in: Unified diff

Application: gvSIG desktop » gvSIG data provider for GPE

Revision 979