org.deegree.gml.geometry
Class GML3GeometryReader

java.lang.Object
  org.deegree.gml.geometry.GML3GeometryReader

All Implemented Interfaces:

GMLGeometryReader

public class GML3GeometryReader
extends java.lang.Object
implements GMLGeometryReader

Parser for geometry and geometry-related constructs from the GML 3 specification series (3.0 / 3.1 / 3.2). TODO: check correctness for GML 3.0 / 3.2

Supports the following geometry elements:

• Point
• LineString
• Curve
• OrientableCurve
• CompositeCurve
• LinearRing
• Ring
• Polygon
• Surface
• CompositeSurface
• OrientableSurface
• PolyhedralSurface
• Surface
• Tin
• TriangulatedSurface
• Solid
• CompositeSolid
• GeometricComplex
• MultiPoint
• MultiLineString
• MultiCurve
• MultiPolygon
• MultiSurface
• MultiGeometry

Additionally, the parsing of Envelope elements is supported, @see parseEnvelope(XMLStreamReaderWrapper) and (XMLStreamReaderWrapper).

Currently unsupported are the elements from the _ImplicitGeometry substitution group, i.e. Grid and RectifiedGrid):

Version:

$Revision:$, $Date:$

Author:

Markus Schneider , last edited by: $Author:$

Field Summary

protected GeometryFactory	geomFac
protected java.lang.String	gmlNs Namespace for the parsed GML elements, either CommonNamespaces.GMLNS or CommonNamespaces.GML3_2_NS.
protected GMLVersion	version

Constructor Summary

GML3GeometryReader(GMLVersion version, GeometryFactory geomFac, GMLDocumentIdContext idContext, int defaultCoordDim)
Creates a new GML3GeometryReader instance.

Method Summary

protected CRS	determineActiveCRS(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Determines the active CRS using the value of the srsName attribute of the current geometry element.
protected int	determineCoordDimensions(XMLStreamReaderWrapper xmlStream, int defaultCoordDimensions) Applies a simple heuristic to determine the number of coordinate dimensions.
GMLDocumentIdContext	getDocumentIdContext() Returns the GMLDocumentIdContext that keeps track of objects, identifieres and references.
boolean	isGeometryElement(javax.xml.namespace.QName elName) Returns whether the given element name denotes a GML 3.1.1 geometry element (a concrete element substitutable for "gml:_Geometry").
boolean	isGeometryElement(javax.xml.stream.XMLStreamReader reader)
boolean	isGeometryOrEnvelopeElement(javax.xml.namespace.QName elName) Returns whether the given element name denotes a GML 3.1.1 geometry (a concrete element substitutable for "gml:_Geometry") or envelope element.
boolean	isGeometryOrEnvelopeElement(javax.xml.stream.XMLStreamReader reader)
Geometry	parse(XMLStreamReaderWrapper xmlStream) Returns the object representation for the given gml:_Geometry element event that the cursor of the associated XMLStreamReader points at.
Geometry	parse(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation for the given gml:_Geometry element event that the cursor of the associated XMLStreamReader points at.
Curve	parseAbstractCurve(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation for the given gml:_Curve element event that the cursor of the associated XMLStreamReader points at.
Geometry	parseAbstractGeometricComplex(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation for the given gml:_Geometry event that represents a geometric complex (either gml:CompositeCurve, gml:CompositeSolid, gml:CompositeSurface or gml:GeometricComplex), that the cursor of the given XMLStreamReader points at.
Ring	parseAbstractRing(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a (<gml:_Ring>) element.
Solid	parseAbstractSolid(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a gml:_Solid element.
Surface	parseAbstractSurface(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a (<gml:_Surface>) element.
protected Angle	parseAngleType(XMLStreamReaderWrapper xmlStream)
CompositeCurve	parseCompositeCurve(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a gml:CompositeCurve element.
CompositeSolid	parseCompositeSolid(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a gml:CompositeSolid element.
CompositeSurface	parseCompositeSurface(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a gml:CompositeSurface element.
protected java.util.List<Point>	parseCoordinates(XMLStreamReaderWrapper xmlStream, CRS crs)
protected double[]	parseCoordType(XMLStreamReaderWrapper xmlStream)
Curve	parseCurve(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a gml:Curve element.
Curve	parseCurveProperty(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of an element with type gml:CurvePropertyType (such as gml:curveProperty).
protected Point	parseDirectPositionType(XMLStreamReaderWrapper xmlStream, CRS defaultCRS)
protected double[]	parseDoubleList(XMLStreamReaderWrapper xmlStream)
Envelope	parseEnvelope(XMLStreamReaderWrapper xmlStream) Returns the object representation of a gml:Envelope element.
Envelope	parseEnvelope(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a gml:Envelope element.
MultiGeometry<? extends Geometry>	parseGeometricAggregate(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation for the given gml:_GeometricAggregate element event that the cursor of the given XMLStreamReader points at.
CompositeGeometry<GeometricPrimitive>	parseGeometricComplex(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a gml:GeometricComplex element.
GeometricPrimitive	parseGeometricPrimitive(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation for the given gml:_GeometricPrimitive element event that the cursor of the associated XMLStreamReader points at.
GeometricPrimitive	parseGeometricPrimitiveProperty(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of an element with type gml:GeometricPrimitivePropertyType (such as gml:element).
Geometry	parseGeometryOrEnvelope(XMLStreamReaderWrapper xmlStream) Returns the object representation for the given gml:_Geometry/gml:Envelope element event that the cursor of the associated XMLStreamReader points at.
Geometry	parseGeometryOrEnvelope(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation for the given gml:_Geometry/gml:Envelope element event that the cursor of the associated XMLStreamReader points at.
Geometry	parseGeometryProperty(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of an element with type gml:GeometryPropertyType (such as gml:geometryMember).
Geometry	parseImplicitGeometry(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation for the given gml:_ImplicitGeometry element event that the cursor of the associated XMLStreamReader points at.
protected Length	parseLengthType(XMLStreamReaderWrapper xmlStream)
LinearRing	parseLinearRing(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a gml:LinearRing element.
LineString	parseLineString(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a gml:LineString element.
LineString	parseLineStringProperty(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of an element with type gml:LineStringPropertyType (such as gml:lineStringProperty).
protected Measure	parseMeasureType(XMLStreamReaderWrapper xmlStream)
MultiCurve	parseMultiCurve(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a gml:MultiCurve element.
MultiGeometry<Geometry>	parseMultiGeometry(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a gml:MultiGeometry element.
MultiLineString	parseMultiLineString(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a gml:MultiLineString element.
MultiPoint	parseMultiPoint(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a gml:MultiPoint element.
MultiPolygon	parseMultiPolygon(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a gml:MultiPolygon element.
MultiSolid	parseMultiSolid(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a gml:MultiSolid element.
MultiSurface	parseMultiSurface(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a gml:MultiSurface element.
OrientableCurve	parseOrientableCurve(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a gml:OrientableCurve element.
OrientableSurface	parseOrientableSurface(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a gml:OrientableSurface element.
protected boolean	parseOrientation(XMLStreamReaderWrapper xmlStream) Parses the orientation attribute from element that the associated XMLStreamReader points to.
Point	parsePoint(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a (<gml:Point>) element.
Point	parsePointProperty(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of an element with type gml:PointPropertyType (such as gml:pointProperty).
Polygon	parsePolygon(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a (<gml:Polygon>) element.
Polygon	parsePolygonProperty(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of an element with type gml:PolygonPropertyType (such as gml:polygonProperty).
PolyhedralSurface	parsePolyhedralSurface(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a (<gml:PolyhedralSurface>) element.
protected java.util.List<Point>	parsePosList(XMLStreamReaderWrapper xmlStream, CRS crs)
Ring	parseRing(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a gml:Ring element.
Solid	parseSolid(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a (<gml:Solid>) element.
Solid	parseSolidProperty(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of an element with type gml:SolidPropertyType (such as gml:solidProperty).
Surface	parseSurface(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a (<gml:Surface>) element.
Surface	parseSurfaceProperty(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of an element with type gml:SurfacePropertyType (such as gml:surfaceProperty).
Tin	parseTin(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a (<gml:Tin>) element.
TriangulatedSurface	parseTriangulatedSurface(XMLStreamReaderWrapper xmlStream, CRS defaultCRS) Returns the object representation of a (<gml:TriangulatedSurface>) element.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

version

protected final GMLVersion version

gmlNs

protected final java.lang.String gmlNs

Namespace for the parsed GML elements, either CommonNamespaces.GMLNS or CommonNamespaces.GML3_2_NS.

geomFac

protected final GeometryFactory geomFac

Constructor Detail

GML3GeometryReader

public GML3GeometryReader(GMLVersion version,
                          GeometryFactory geomFac,
                          GMLDocumentIdContext idContext,
                          int defaultCoordDim)

Creates a new GML3GeometryReader instance.

Parameters:

version - either GMLVersion.GML_30, GMLVersion.GML_31 or GMLVersion.GML_32

geomFac - geometry factory to be used for creating geometry objects, can be null

idContext - id context for keeping track of objects and references, can be null

Method Detail

getDocumentIdContext

public GMLDocumentIdContext getDocumentIdContext()

Returns the GMLDocumentIdContext that keeps track of objects, identifieres and references.

Returns:

the GMLDocumentIdContext, never null

isGeometryElement

public boolean isGeometryElement(javax.xml.stream.XMLStreamReader reader)

Specified by:

isGeometryElement in interface GMLGeometryReader

Returns:

true if stream's event is an XMLStreamConstants.START_ELEMENT && the current element's name is a known geometry.

isGeometryOrEnvelopeElement

public boolean isGeometryOrEnvelopeElement(javax.xml.stream.XMLStreamReader reader)

Specified by:

isGeometryOrEnvelopeElement in interface GMLGeometryReader

Returns:

true if stream's event is an XMLStreamConstants.START_ELEMENT && the current element's name is an envelope.

isGeometryElement

public boolean isGeometryElement(javax.xml.namespace.QName elName)

Returns whether the given element name denotes a GML 3.1.1 geometry element (a concrete element substitutable for "gml:_Geometry").

Parameters:

elName - qualified element name to check

Returns:

true, if the element is a GML 3.1.1 geometry element, false otherwise

isGeometryOrEnvelopeElement

public boolean isGeometryOrEnvelopeElement(javax.xml.namespace.QName elName)

Returns whether the given element name denotes a GML 3.1.1 geometry (a concrete element substitutable for "gml:_Geometry") or envelope element.

Parameters:

elName - qualified element name to check

Returns:

true, if the element is a GML 3.1.1 geometry or a GML 3.1.1 envelope element, false otherwise

parse

public Geometry parse(XMLStreamReaderWrapper xmlStream)
               throws XMLParsingException,
                      javax.xml.stream.XMLStreamException,
                      UnknownCRSException

Returns the object representation for the given gml:_Geometry element event that the cursor of the associated XMLStreamReader points at.

• Precondition: cursor must point at the START_ELEMENT event (<gml:_Geometry>)
• Postcondition: cursor points at the corresponding END_ELEMENT event (</gml:_Geometry>)

GML 3.1.1 specifies the following elements to be directly substitutable for gml:_Geometry:

• _GeometricPrimitive
• _Ring
• _GeometricAggregate
• GeometricComplex
• _ImplicitGeometry

Specified by:

parse in interface GMLGeometryReader

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:_Geometry>), points at the corresponding END_ELEMENT event (</gml:_Geometry>) afterwards

Returns:

corresponding Geometry object

Throws:

XMLParsingException - if the element is not a valid "gml:_Geometry" element

javax.xml.stream.XMLStreamException

UnknownCRSException

parse

public Geometry parse(XMLStreamReaderWrapper xmlStream,
                      CRS defaultCRS)
               throws XMLParsingException,
                      javax.xml.stream.XMLStreamException,
                      UnknownCRSException

Returns the object representation for the given gml:_Geometry element event that the cursor of the associated XMLStreamReader points at.

• Precondition: cursor must point at the START_ELEMENT event (<gml:_Geometry>)
• Postcondition: cursor points at the corresponding END_ELEMENT event (</gml:_Geometry>)

GML 3.1.1 specifies the following elements to be directly substitutable for gml:_Geometry:

• _GeometricPrimitive
• _Ring
• _GeometricAggregate
• GeometricComplex
• _ImplicitGeometry

Specified by:

parse in interface GMLGeometryReader

Parameters:

xmlStream - cursor must point at the jec event (<gml:_Geometry>), points at the corresponding END_ELEMENT event (</gml:_Geometry>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the geometry element has no own srsName attribute

Returns:

corresponding Geometry object

Throws:

XMLParsingException - if the element is not a valid "gml:_Geometry" element

javax.xml.stream.XMLStreamException

UnknownCRSException

parseGeometryOrEnvelope

public Geometry parseGeometryOrEnvelope(XMLStreamReaderWrapper xmlStream)
                                 throws XMLParsingException,
                                        javax.xml.stream.XMLStreamException,
                                        UnknownCRSException

Returns the object representation for the given gml:_Geometry/gml:Envelope element event that the cursor of the associated XMLStreamReader points at.

• Precondition: cursor must point at the START_ELEMENT event (<gml:_Geometry> or <gml:Envelope>)
• Postcondition: cursor points at the corresponding END_ELEMENT event (</gml:_Geometry> or <gml:Envelope>)

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:_Geometry> or <gml:Envelope>), points at the corresponding END_ELEMENT event (</gml:_Geometry> or <gml:Envelope>) afterwards

Returns:

corresponding Geometry object

Throws:

XMLParsingException - if the element is not a valid gml:_Geometry or gml:Envelope element

javax.xml.stream.XMLStreamException

UnknownCRSException

parseGeometryOrEnvelope

public Geometry parseGeometryOrEnvelope(XMLStreamReaderWrapper xmlStream,
                                        CRS defaultCRS)
                                 throws XMLParsingException,
                                        javax.xml.stream.XMLStreamException,
                                        UnknownCRSException

Returns the object representation for the given gml:_Geometry/gml:Envelope element event that the cursor of the associated XMLStreamReader points at.

• Precondition: cursor must point at the START_ELEMENT event (<gml:_Geometry> or <gml:Envelope>)
• Postcondition: cursor points at the corresponding END_ELEMENT event (</gml:_Geometry> or <gml:Envelope>)

Specified by:

parseGeometryOrEnvelope in interface GMLGeometryReader

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:_Geometry> or <gml:Envelope>), points at the corresponding END_ELEMENT event (</gml:_Geometry> or <gml:Envelope>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the geometry element has no own srsName attribute

Returns:

corresponding Geometry object

Throws:

XMLParsingException - if the element is not a valid gml:_Geometry or gml:Envelope element

javax.xml.stream.XMLStreamException

UnknownCRSException

parseGeometricPrimitive

public GeometricPrimitive parseGeometricPrimitive(XMLStreamReaderWrapper xmlStream,
                                                  CRS defaultCRS)
                                           throws XMLParsingException,
                                                  javax.xml.stream.XMLStreamException,
                                                  UnknownCRSException

Returns the object representation for the given gml:_GeometricPrimitive element event that the cursor of the associated XMLStreamReader points at.

• Precondition: cursor must point at the START_ELEMENT event (<gml:_GeometricPrimitive>)
• Postcondition: cursor points at the corresponding END_ELEMENT event (</gml:_GeometricPrimitive>)

GML 3.1.1 specifies the following elements to be directly substitutable for gml:_GeometricPrimitive:

• Point
• _Curve
• _Surface
• _Solid

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:_GeometricPrimitive>), points at the corresponding END_ELEMENT event (</gml:_GeometricPrimitive>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the geometry element has no own srsName attribute

Returns:

corresponding GeometricPrimitive object

Throws:

XMLParsingException - if the element is not a valid gml:_GeometricPrimitive element

javax.xml.stream.XMLStreamException

UnknownCRSException

parseGeometricAggregate

public MultiGeometry<? extends Geometry> parseGeometricAggregate(XMLStreamReaderWrapper xmlStream,
                                                                 CRS defaultCRS)
                                                          throws XMLParsingException,
                                                                 javax.xml.stream.XMLStreamException,
                                                                 UnknownCRSException

Returns the object representation for the given gml:_GeometricAggregate element event that the cursor of the given XMLStreamReader points at.

• Precondition: cursor must point at the START_ELEMENT event (<gml:_GeometricAggregate>)
• Postcondition: cursor points at the corresponding END_ELEMENT event (</gml:_GeometricAggregate>)

GML 3.1.1 specifies the following concrete elements to be substitutable for gml:_GeometricAggregate:

• MultiCurve
• MultiGeometry
• MultiLineString
• MultiPoint
• MultiPolygon
• MultiSolid
• MultiSurface

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:_GeometricAggregate>), points at the corresponding END_ELEMENT event (</gml:_GeometricAggregate>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the geometry element has no own srsName attribute

Returns:

corresponding MultiGeometry object

Throws:

XMLParsingException - if the element is not a valid "gml:_GeometricAggregate" element

javax.xml.stream.XMLStreamException

UnknownCRSException

parseAbstractGeometricComplex

public Geometry parseAbstractGeometricComplex(XMLStreamReaderWrapper xmlStream,
                                              CRS defaultCRS)
                                       throws XMLParsingException,
                                              javax.xml.stream.XMLStreamException,
                                              UnknownCRSException

Returns the object representation for the given gml:_Geometry event that represents a geometric complex (either gml:CompositeCurve, gml:CompositeSolid, gml:CompositeSurface or gml:GeometricComplex), that the cursor of the given XMLStreamReader points at.

• Precondition: cursor must point at the START_ELEMENT event
• Postcondition: cursor points at the corresponding END_ELEMENT event

GML 3.1.1 specifies the following four concrete geometry elements with an geometry complex semantic:

• CompositeCurve
• CompositeSolid
• CompositeSurface
• GeometricComplex

NOTE: For technical reasons (XML Schema does not support multiple inheritance), there is no substitution group gml:_GeometricComplex defined in the GML schemas. However, it is described in the comments.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event, points at the corresponding END_ELEMENT event afterwards

defaultCRS - default crs for the geometry, this is only used if the geometry element has no own srsName attribute

Returns:

corresponding Geometry object

Throws:

XMLParsingException - if the element is not a valid "gml:_Geometry" element with geometric complex semantic

javax.xml.stream.XMLStreamException

UnknownCRSException

parseImplicitGeometry

public Geometry parseImplicitGeometry(XMLStreamReaderWrapper xmlStream,
                                      CRS defaultCRS)
                               throws XMLParsingException,
                                      javax.xml.stream.XMLStreamException

Returns the object representation for the given gml:_ImplicitGeometry element event that the cursor of the associated XMLStreamReader points at.

• Precondition: cursor must point at the START_ELEMENT event (<gml:_ImplicitGeometry>)
• Postcondition: cursor points at the corresponding END_ELEMENT event (</gml:_GeometricAggregate>)

GML 3.1.1 specifies the following two concrete elements to be substitutable for gml:_ImplicitGeometry:

• Grid
• RectifiedGrid

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:_ImplicitGeometry>), points at the corresponding END_ELEMENT event (</gml:_ImplicitGeometry>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the geometry element has no own srsName attribute

Returns:

corresponding Geometry object

Throws:

XMLParsingException - if the element is not a valid "gml:_ImplicitGeometry" element

javax.xml.stream.XMLStreamException

parseAbstractCurve

public Curve parseAbstractCurve(XMLStreamReaderWrapper xmlStream,
                                CRS defaultCRS)
                         throws XMLParsingException,
                                javax.xml.stream.XMLStreamException,
                                UnknownCRSException

Returns the object representation for the given gml:_Curve element event that the cursor of the associated XMLStreamReader points at.

GML 3.1.1 specifies the following elements to be substitutable for gml:_Curve:

• CompositeCurve
• Curve
• LineString
• OrientableCurve

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:_Curve>), points at the corresponding END_ELEMENT event (</gml:_Curve>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the geometry element has no own srsName attribute

Returns:

corresponding Curve object

Throws:

XMLParsingException - if the element is not a valid "gml:_Curve" element

javax.xml.stream.XMLStreamException

UnknownCRSException

parseAbstractRing

public Ring parseAbstractRing(XMLStreamReaderWrapper xmlStream,
                              CRS defaultCRS)
                       throws XMLParsingException,
                              javax.xml.stream.XMLStreamException,
                              UnknownCRSException

Returns the object representation of a (<gml:_Ring>) element. Consumes all corresponding events from the associated XMLStream.

GML 3.1.1 specifies the following elements to be substitutable for gml:_Ring:

• LinearRing
• Ring

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:_Ring>), points at the corresponding END_ELEMENT event (</gml:_Ring>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the geometry element has no own srsName attribute

Returns:

corresponding Ring object

Throws:

XMLParsingException - if the element is not a valid "gml:_Ring" element

javax.xml.stream.XMLStreamException

UnknownCRSException

parseAbstractSurface

public Surface parseAbstractSurface(XMLStreamReaderWrapper xmlStream,
                                    CRS defaultCRS)
                             throws XMLParsingException,
                                    javax.xml.stream.XMLStreamException,
                                    UnknownCRSException

Returns the object representation of a (<gml:_Surface>) element. Consumes all corresponding events from the associated XMLStream.

GML 3.1.1 specifies the following seven elements to be substitutable for gml:_Surface:

• Polygon
• CompositeSurface
• OrientableSurface
• PolyhedralSurface
• Surface
• Tin
• TriangulatedSurface

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:_Surface>), points at the corresponding END_ELEMENT event (</gml:_Surface>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the geometry element has no own srsName attribute

Returns:

corresponding Surface object

Throws:

XMLParsingException - if the element is not a valid "gml:_Surface" element

javax.xml.stream.XMLStreamException

UnknownCRSException

parseAbstractSolid

public Solid parseAbstractSolid(XMLStreamReaderWrapper xmlStream,
                                CRS defaultCRS)
                         throws XMLParsingException,
                                javax.xml.stream.XMLStreamException,
                                UnknownCRSException

Returns the object representation of a gml:_Solid element. Consumes all corresponding events from the associated XMLStream.

GML 3.1.1 specifies the following two elements to be substitutable for gml:_Solid elements:

• CompositeSolid
• Solid

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:_Solid>), points at the corresponding END_ELEMENT event (</gml:_Solid>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the geometry element has no own srsName attribute

Returns:

corresponding Solid object

Throws:

XMLParsingException - if the element is not a valid "gml:_Solid" element

javax.xml.stream.XMLStreamException

UnknownCRSException

parsePoint

public Point parsePoint(XMLStreamReaderWrapper xmlStream,
                        CRS defaultCRS)
                 throws XMLParsingException,
                        javax.xml.stream.XMLStreamException,
                        UnknownCRSException

Returns the object representation of a (<gml:Point>) element. Consumes all corresponding events from the associated XMLStream.

• Precondition: cursor must point at the START_ELEMENT event (<gml:Point>)
• Postcondition: cursor points at the next event after the END_ELEMENT (</gml:Point>)

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:Point>), points at the corresponding END_ELEMENT event (</gml:Point>) afterwards

defaultCRS - default CRS for the geometry, this is used if the "gml:Point" has no srsName attribute

Returns:

corresponding Point object

Throws:

XMLParsingException - if the element is not a valid gml:Point element

javax.xml.stream.XMLStreamException

UnknownCRSException

parseLineString

public LineString parseLineString(XMLStreamReaderWrapper xmlStream,
                                  CRS defaultCRS)
                           throws javax.xml.stream.XMLStreamException,
                                  XMLParsingException,
                                  UnknownCRSException

Returns the object representation of a gml:LineString element. Consumes all corresponding events from the given XMLStream.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:LineString>), points at the corresponding END_ELEMENT event (</gml:LineString>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the gml:LineString has no srsName attribute

Returns:

corresponding LineString object

Throws:

XMLParsingException - if the element is not a valid gml:LineString element

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseCurve

public Curve parseCurve(XMLStreamReaderWrapper xmlStream,
                        CRS defaultCRS)
                 throws javax.xml.stream.XMLStreamException,
                        XMLParsingException,
                        UnknownCRSException

Returns the object representation of a gml:Curve element. Consumes all corresponding events from the associated XMLStream.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:Curve>), points at the corresponding END_ELEMENT event (</gml:Curve>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the gml:Curve has no srsName attribute

Returns:

corresponding Curve object

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseOrientableCurve

public OrientableCurve parseOrientableCurve(XMLStreamReaderWrapper xmlStream,
                                            CRS defaultCRS)
                                     throws javax.xml.stream.XMLStreamException,
                                            UnknownCRSException

Returns the object representation of a gml:OrientableCurve element. Consumes all corresponding events from the associated XMLStream.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:OrientableCurve>), points at the corresponding END_ELEMENT event (</gml:OrientableCurve>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the gml:OrientableCurve has no srsName attribute

Returns:

corresponding OrientableCurve object

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseLinearRing

public LinearRing parseLinearRing(XMLStreamReaderWrapper xmlStream,
                                  CRS defaultCRS)
                           throws javax.xml.stream.XMLStreamException,
                                  XMLParsingException,
                                  UnknownCRSException

Returns the object representation of a gml:LinearRing element. Consumes all corresponding events from the associated XMLStream.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:LinearRing>), points at the corresponding END_ELEMENT event (</gml:LinearRing>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the gml:LinearRing element has no srsName attribute

Returns:

corresponding Ring object

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseRing

public Ring parseRing(XMLStreamReaderWrapper xmlStream,
                      CRS defaultCRS)
               throws javax.xml.stream.XMLStreamException,
                      UnknownCRSException

Returns the object representation of a gml:Ring element. Consumes all corresponding events from the given XMLStream.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:Ring>), points at the corresponding END_ELEMENT event (</gml:Ring>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the gml:Ring element has no srsName attribute

Returns:

corresponding Ring object

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parsePolygon

public Polygon parsePolygon(XMLStreamReaderWrapper xmlStream,
                            CRS defaultCRS)
                     throws javax.xml.stream.XMLStreamException,
                            XMLParsingException,
                            UnknownCRSException

Returns the object representation of a (<gml:Polygon>) element. Consumes all corresponding events from the given XMLStream.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:Polygon>), points at the corresponding END_ELEMENT event (</gml:Polygon>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the "gml:Polygon" has no srsName attribute

Returns:

corresponding Polygon object

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseSurface

public Surface parseSurface(XMLStreamReaderWrapper xmlStream,
                            CRS defaultCRS)
                     throws javax.xml.stream.XMLStreamException,
                            UnknownCRSException

Returns the object representation of a (<gml:Surface>) element. Consumes all corresponding events from the given XMLStream.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:Surface>), points at the corresponding END_ELEMENT event (</gml:Surface>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the "gml:Surface" has no srsName attribute

Returns:

corresponding Surface object

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parsePolyhedralSurface

public PolyhedralSurface parsePolyhedralSurface(XMLStreamReaderWrapper xmlStream,
                                                CRS defaultCRS)
                                         throws javax.xml.stream.XMLStreamException,
                                                UnknownCRSException

Returns the object representation of a (<gml:PolyhedralSurface>) element. Consumes all corresponding events from the given XMLStream.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:PolyhedralSurface>), points at the corresponding END_ELEMENT event (</gml:PolyhedralSurface>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the "gml:PolyhedralSurface" has no srsName attribute

Returns:

corresponding PolyhedralSurface object

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseTriangulatedSurface

public TriangulatedSurface parseTriangulatedSurface(XMLStreamReaderWrapper xmlStream,
                                                    CRS defaultCRS)
                                             throws javax.xml.stream.XMLStreamException,
                                                    UnknownCRSException

Returns the object representation of a (<gml:TriangulatedSurface>) element. Consumes all corresponding events from the given XMLStream.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:TriangulatedSurface>), points at the corresponding END_ELEMENT event (</gml:TriangulatedSurface>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the "gml:TriangulatedSurface" has no srsName attribute

Returns:

corresponding TriangulatedSurface object

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseTin

public Tin parseTin(XMLStreamReaderWrapper xmlStream,
                    CRS defaultCRS)
             throws javax.xml.stream.XMLStreamException,
                    XMLParsingException,
                    UnknownCRSException

Returns the object representation of a (<gml:Tin>) element. Consumes all corresponding events from the given XMLStream.

Note: GML 3.1.1 specifies both "gml:trianglePatches" and "gml:controlPoint" properties for "gml:Tin". This is apparently redundant, and consequently (?) GML 3.2.1 only allows the controlPoint property here. This method copes with this by only using the controlPoints for building the Tin object.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:Tin>), points at the corresponding END_ELEMENT event (</gml:Tin>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the "gml:Tin" has no srsName attribute

Returns:

corresponding Tin object

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseOrientableSurface

public OrientableSurface parseOrientableSurface(XMLStreamReaderWrapper xmlStream,
                                                CRS defaultCRS)
                                         throws javax.xml.stream.XMLStreamException,
                                                XMLParsingException,
                                                UnknownCRSException

Returns the object representation of a gml:OrientableSurface element. Consumes all corresponding events from the associated XMLStream.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:OrientableSurface>), points at the corresponding END_ELEMENT event (</gml:OrientableSurface>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the gml:OrientableSurface has no srsName attribute

Returns:

corresponding OrientableSurface object

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseSolid

public Solid parseSolid(XMLStreamReaderWrapper xmlStream,
                        CRS defaultCRS)
                 throws javax.xml.stream.XMLStreamException,
                        XMLParsingException,
                        UnknownCRSException

Returns the object representation of a (<gml:Solid>) element. Consumes all corresponding events from the given XMLStream.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:Solid>), points at the corresponding END_ELEMENT event (</gml:Solid>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the "gml:Solid" has no srsName attribute

Returns:

corresponding Solid object

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseCompositeCurve

public CompositeCurve parseCompositeCurve(XMLStreamReaderWrapper xmlStream,
                                          CRS defaultCRS)
                                   throws javax.xml.stream.XMLStreamException,
                                          UnknownCRSException

Returns the object representation of a gml:CompositeCurve element. Consumes all corresponding events from the associated XMLStream.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:CompositeCurve>), points at the corresponding END_ELEMENT event (</gml:CompositeCurve>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the gml:CompositeCurve has no srsName attribute

Returns:

corresponding CompositeCurve object

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseCompositeSurface

public CompositeSurface parseCompositeSurface(XMLStreamReaderWrapper xmlStream,
                                              CRS defaultCRS)
                                       throws javax.xml.stream.XMLStreamException,
                                              XMLParsingException,
                                              UnknownCRSException

Returns the object representation of a gml:CompositeSurface element. Consumes all corresponding events from the associated XMLStream.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:CompositeSurface>), points at the corresponding END_ELEMENT event (</gml:CompositeSurface>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the gml:CompositeSurface has no srsName attribute

Returns:

corresponding CompositeSurface object

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseCompositeSolid

public CompositeSolid parseCompositeSolid(XMLStreamReaderWrapper xmlStream,
                                          CRS defaultCRS)
                                   throws javax.xml.stream.XMLStreamException,
                                          XMLParsingException,
                                          UnknownCRSException

Returns the object representation of a gml:CompositeSolid element. Consumes all corresponding events from the associated XMLStream.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:CompositeSolid>), points at the corresponding END_ELEMENT event (</gml:CompositeSolid>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the gml:CompositeSolid has no srsName attribute

Returns:

corresponding CompositeSolid object

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseGeometricComplex

public CompositeGeometry<GeometricPrimitive> parseGeometricComplex(XMLStreamReaderWrapper xmlStream,
                                                                   CRS defaultCRS)
                                                            throws javax.xml.stream.XMLStreamException,
                                                                   XMLParsingException,
                                                                   UnknownCRSException

Returns the object representation of a gml:GeometricComplex element. Consumes all corresponding events from the associated XMLStream.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:GeometricComplex>), points at the corresponding END_ELEMENT event (</gml:GeometricComplex>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the gml:GeometricComplex has no srsName attribute

Returns:

corresponding CompositeGeometry object

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseMultiPoint

public MultiPoint parseMultiPoint(XMLStreamReaderWrapper xmlStream,
                                  CRS defaultCRS)
                           throws javax.xml.stream.XMLStreamException,
                                  XMLParsingException,
                                  UnknownCRSException

Returns the object representation of a gml:MultiPoint element. Consumes all corresponding events from the associated XMLStream.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:MultiPoint>), points at the corresponding END_ELEMENT event (</gml:MultiPoint>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the gml:MultiPoint has no srsName attribute

Returns:

corresponding MultiPoint object

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseMultiCurve

public MultiCurve parseMultiCurve(XMLStreamReaderWrapper xmlStream,
                                  CRS defaultCRS)
                           throws javax.xml.stream.XMLStreamException,
                                  XMLParsingException,
                                  UnknownCRSException

Returns the object representation of a gml:MultiCurve element. Consumes all corresponding events from the associated XMLStream.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:MultiCurve>), points at the corresponding END_ELEMENT event (</gml:MultiCurve>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the gml:MultiCurve has no srsName attribute

Returns:

corresponding MultiCurve object

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseMultiLineString

public MultiLineString parseMultiLineString(XMLStreamReaderWrapper xmlStream,
                                            CRS defaultCRS)
                                     throws javax.xml.stream.XMLStreamException,
                                            XMLParsingException,
                                            UnknownCRSException

Returns the object representation of a gml:MultiLineString element. Consumes all corresponding events from the associated XMLStream.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:MultiLineString>), points at the corresponding END_ELEMENT event (</gml:MultiLineString>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the gml:MultiLineString has no srsName attribute

Returns:

corresponding MultiLineString object

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseMultiSurface

public MultiSurface parseMultiSurface(XMLStreamReaderWrapper xmlStream,
                                      CRS defaultCRS)
                               throws javax.xml.stream.XMLStreamException,
                                      XMLParsingException,
                                      UnknownCRSException

Returns the object representation of a gml:MultiSurface element. Consumes all corresponding events from the associated XMLStream.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:MultiSurface>), points at the corresponding END_ELEMENT event (</gml:MultiSurface>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the gml:MultiSurface has no srsName attribute

Returns:

corresponding MultiSurface object

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseMultiPolygon

public MultiPolygon parseMultiPolygon(XMLStreamReaderWrapper xmlStream,
                                      CRS defaultCRS)
                               throws javax.xml.stream.XMLStreamException,
                                      XMLParsingException,
                                      UnknownCRSException

Returns the object representation of a gml:MultiPolygon element. Consumes all corresponding events from the associated XMLStream.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:MultiPolygon>), points at the corresponding END_ELEMENT event (</gml:MultiPolygon>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the gml:MultiPolygon has no srsName attribute

Returns:

corresponding MultiPolygon object

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseMultiSolid

public MultiSolid parseMultiSolid(XMLStreamReaderWrapper xmlStream,
                                  CRS defaultCRS)
                           throws javax.xml.stream.XMLStreamException,
                                  XMLParsingException,
                                  UnknownCRSException

Returns the object representation of a gml:MultiSolid element. Consumes all corresponding events from the associated XMLStream.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:MultiSolid>), points at the corresponding END_ELEMENT event (</gml:MultiSolid>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the gml:MultiSolid has no srsName attribute

Returns:

corresponding MultiSolid object

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseMultiGeometry

public MultiGeometry<Geometry> parseMultiGeometry(XMLStreamReaderWrapper xmlStream,
                                                  CRS defaultCRS)
                                           throws javax.xml.stream.XMLStreamException,
                                                  XMLParsingException,
                                                  UnknownCRSException

Returns the object representation of a gml:MultiGeometry element. Consumes all corresponding events from the associated XMLStream.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:MultiGeometry>), points at the corresponding END_ELEMENT event (</gml:MultiGeometry>) afterwards

defaultCRS - default CRS for the geometry, this is only used if the gml:MultiGeometry has no srsName attribute

Returns:

corresponding MultiGeometry object

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseEnvelope

public Envelope parseEnvelope(XMLStreamReaderWrapper xmlStream)
                       throws XMLParsingException,
                              javax.xml.stream.XMLStreamException

Returns the object representation of a gml:Envelope element. Consumes all corresponding events from the associated XMLStream.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:Envelope>), points at the corresponding END_ELEMENT event (</gml:Envelope>) afterwards

Returns:

corresponding Envelope object

Throws:

javax.xml.stream.XMLStreamException

XMLParsingException

parseEnvelope

public Envelope parseEnvelope(XMLStreamReaderWrapper xmlStream,
                              CRS defaultCRS)
                       throws XMLParsingException,
                              javax.xml.stream.XMLStreamException

Returns the object representation of a gml:Envelope element. Consumes all corresponding events from the associated XMLStream.

Specified by:

parseEnvelope in interface GMLGeometryReader

Parameters:

xmlStream - cursor must point at the START_ELEMENT event (<gml:Envelope>), points at the corresponding END_ELEMENT event (</gml:Envelope>) afterwards

defaultCRS - default CRS for the envelope, this is only used if the gml:Envelope has no srsName attribute itself

Returns:

corresponding Envelope object

Throws:

javax.xml.stream.XMLStreamException

XMLParsingException

parsePointProperty

public Point parsePointProperty(XMLStreamReaderWrapper xmlStream,
                                CRS defaultCRS)
                         throws javax.xml.stream.XMLStreamException,
                                XMLParsingException,
                                UnknownCRSException

Returns the object representation of an element with type gml:PointPropertyType (such as gml:pointProperty). Consumes all corresponding events from the given XMLStream.

The point value may be specified using an inline gml:Point element or using an xlink:href attribute. In the latter case, a PointReference object is returned.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event, points at the corresponding END_ELEMENT event afterwards

defaultCRS - default CRS for the geometry, this is used if the contained "gml:Point" has no srsName attribute

Returns:

corresponding Point object, this is a PointReference if the content is specified using xlink

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseLineStringProperty

public LineString parseLineStringProperty(XMLStreamReaderWrapper xmlStream,
                                          CRS defaultCRS)
                                   throws javax.xml.stream.XMLStreamException,
                                          XMLParsingException,
                                          UnknownCRSException

Returns the object representation of an element with type gml:LineStringPropertyType (such as gml:lineStringProperty). Consumes all corresponding events from the given XMLStream.

The LineString value may be specified using an inline gml:LineString element or using an xlink:href attribute. In the latter case, a LineStringReference object is returned.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event, points at the corresponding END_ELEMENT event afterwards

defaultCRS - default CRS for the geometry, this is used if the contained "gml:LineString" has no srsName attribute

Returns:

corresponding LineString object, this is a LineStringReference if the content is specified using xlink

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseCurveProperty

public Curve parseCurveProperty(XMLStreamReaderWrapper xmlStream,
                                CRS defaultCRS)
                         throws javax.xml.stream.XMLStreamException,
                                XMLParsingException,
                                UnknownCRSException

Returns the object representation of an element with type gml:CurvePropertyType (such as gml:curveProperty). Consumes all corresponding events from the given XMLStream.

The curve value may be specified using an inline gml:_Curve element or using an xlink:href attribute. In the latter case, a CurveReference object is returned.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event, points at the corresponding END_ELEMENT event afterwards

defaultCRS - default CRS for the geometry, this is used if the contained "gml:_Curve" has no srsName attribute

Returns:

corresponding Curve object, this is a CurveReference if the content is specified using xlink

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parsePolygonProperty

public Polygon parsePolygonProperty(XMLStreamReaderWrapper xmlStream,
                                    CRS defaultCRS)
                             throws javax.xml.stream.XMLStreamException,
                                    XMLParsingException,
                                    UnknownCRSException

Returns the object representation of an element with type gml:PolygonPropertyType (such as gml:polygonProperty). Consumes all corresponding events from the given XMLStream.

The polygon value may be specified using an inline gml:Polygon element or using an xlink:href attribute. In the latter case, a PolygonReference object is returned.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event, points at the corresponding END_ELEMENT event afterwards

defaultCRS - default CRS for the geometry, this is used if the contained "gml:Polygon" has no srsName attribute

Returns:

corresponding Polygon object, this is a PolygonReference if the content is specified using xlink

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseSurfaceProperty

public Surface parseSurfaceProperty(XMLStreamReaderWrapper xmlStream,
                                    CRS defaultCRS)
                             throws javax.xml.stream.XMLStreamException,
                                    XMLParsingException,
                                    UnknownCRSException

Returns the object representation of an element with type gml:SurfacePropertyType (such as gml:surfaceProperty). Consumes all corresponding events from the given XMLStream.

The curve value may be specified using an inline gml:_Surface element or using an xlink:href attribute. In the latter case, a SurfaceReference object is returned.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event, points at the corresponding END_ELEMENT event afterwards

defaultCRS - default CRS for the geometry, this is used if the contained "gml:_Surface" has no srsName attribute

Returns:

corresponding Surface object, this is a SurfaceReference if the content is specified using xlink

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseSolidProperty

public Solid parseSolidProperty(XMLStreamReaderWrapper xmlStream,
                                CRS defaultCRS)
                         throws javax.xml.stream.XMLStreamException,
                                XMLParsingException,
                                UnknownCRSException

Returns the object representation of an element with type gml:SolidPropertyType (such as gml:solidProperty). Consumes all corresponding events from the given XMLStream.

The solid value may be specified using an inline gml:Solid element or using an xlink:href attribute. In the latter case, a SolidReference object is returned.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event, points at the corresponding END_ELEMENT event afterwards

defaultCRS - default CRS for the geometry, this is used if the contained "gml:Solid" has no srsName attribute

Returns:

corresponding Solid object, this is a SolidReference if the content is specified using xlink

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseGeometricPrimitiveProperty

public GeometricPrimitive parseGeometricPrimitiveProperty(XMLStreamReaderWrapper xmlStream,
                                                          CRS defaultCRS)
                                                   throws javax.xml.stream.XMLStreamException,
                                                          XMLParsingException,
                                                          UnknownCRSException

Returns the object representation of an element with type gml:GeometricPrimitivePropertyType (such as gml:element). Consumes all corresponding events from the given XMLStream.

The solid value may be specified using an inline gml:_GeometricPrimitive element or using an xlink:href attribute. In the latter case, a GeometricPrimitiveReference object is returned.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event, points at the corresponding END_ELEMENT event afterwards

defaultCRS - default CRS for the geometry, this is used if the contained "gml:_GeometricPrimitive" has no srsName attribute

Returns:

corresponding GeometricPrimitive object, this is a GeometricPrimitiveReference if the content is specified using xlink

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseGeometryProperty

public Geometry parseGeometryProperty(XMLStreamReaderWrapper xmlStream,
                                      CRS defaultCRS)
                               throws javax.xml.stream.XMLStreamException,
                                      XMLParsingException,
                                      UnknownCRSException

Returns the object representation of an element with type gml:GeometryPropertyType (such as gml:geometryMember). Consumes all corresponding events from the given XMLStream.

The geometry value may be specified using an inline gml:_Geometry element or using an xlink:href attribute. In the latter case, a GeometryReference object is returned.

Parameters:

xmlStream - cursor must point at the START_ELEMENT event, points at the corresponding END_ELEMENT event afterwards

defaultCRS - default CRS for the geometry, this is used if the contained "gml:_Geometry" has no srsName attribute

Returns:

corresponding Geometry object, this is a GeometryReference if the content is specified using xlink

Throws:

javax.xml.stream.XMLStreamException

UnknownCRSException

XMLParsingException

parseDirectPositionType

protected Point parseDirectPositionType(XMLStreamReaderWrapper xmlStream,
                                        CRS defaultCRS)
                                 throws XMLParsingException,
                                        javax.xml.stream.XMLStreamException

Throws:

XMLParsingException

javax.xml.stream.XMLStreamException

parsePosList

protected java.util.List<Point> parsePosList(XMLStreamReaderWrapper xmlStream,
                                             CRS crs)
                                      throws XMLParsingException,
                                             javax.xml.stream.XMLStreamException

Throws:

XMLParsingException

javax.xml.stream.XMLStreamException

parseCoordinates

protected java.util.List<Point> parseCoordinates(XMLStreamReaderWrapper xmlStream,
                                                 CRS crs)
                                          throws XMLParsingException,
                                                 javax.xml.stream.XMLStreamException

Throws:

XMLParsingException

javax.xml.stream.XMLStreamException

parseCoordType

protected double[] parseCoordType(XMLStreamReaderWrapper xmlStream)
                           throws javax.xml.stream.XMLStreamException

Throws:

javax.xml.stream.XMLStreamException

parseLengthType

protected Length parseLengthType(XMLStreamReaderWrapper xmlStream)
                          throws javax.xml.stream.XMLStreamException

Throws:

javax.xml.stream.XMLStreamException

parseAngleType

protected Angle parseAngleType(XMLStreamReaderWrapper xmlStream)
                        throws javax.xml.stream.XMLStreamException

Throws:

javax.xml.stream.XMLStreamException

parseMeasureType

protected Measure parseMeasureType(XMLStreamReaderWrapper xmlStream)
                            throws javax.xml.stream.XMLStreamException

Throws:

javax.xml.stream.XMLStreamException

determineActiveCRS

protected CRS determineActiveCRS(XMLStreamReaderWrapper xmlStream,
                                 CRS defaultCRS)

Determines the active CRS using the value of the srsName attribute of the current geometry element.

Parameters:

defaultCRS - default CSR for the geometry, this is returned if the geometry element has no srsName attribute

Returns:

the applicable CRS, may be null

parseDoubleList

protected double[] parseDoubleList(XMLStreamReaderWrapper xmlStream)
                            throws XMLParsingException,
                                   javax.xml.stream.XMLStreamException

Throws:

XMLParsingException

javax.xml.stream.XMLStreamException

parseOrientation

protected boolean parseOrientation(XMLStreamReaderWrapper xmlStream)

Parses the orientation attribute from element that the associated XMLStreamReader points to.

Returns:

true, if the orientation is '+' or not present, false if the attribute is '-'

determineCoordDimensions

protected int determineCoordDimensions(XMLStreamReaderWrapper xmlStream,
                                       int defaultCoordDimensions)

Applies a simple heuristic to determine the number of coordinate dimensions.

Parameters:

defaultCoordDimensions - default coordinate dimensionality, this is returned if the element has no srsDimension attribute

Returns:

coordinate dimensionality