Package org.locationtech.jts.io.gml2
Class GMLHandler
java.lang.Object
org.xml.sax.helpers.DefaultHandler
org.locationtech.jts.io.gml2.GMLHandler
- All Implemented Interfaces:
ContentHandler
,DTDHandler
,EntityResolver
,ErrorHandler
A SAX
DefaultHandler
which builds Geometry
s
from GML2-formatted geometries.
An XML parser can delegate SAX events to this handler
to parse and building Geometrys.
This handler currently ignores both namespaces and prefixes. Hints:
- If your parent handler is a DefaultHandler register the parent handler to receive the errors and locator calls.
- Use
GeometryStrategies.findStrategy(String, String)
to help check for applicability
- Author:
- David Zwiers, Vivid Solutions.
- See Also:
-
Constructor Summary
ConstructorsConstructorDescriptionGMLHandler
(GeometryFactory gf, ErrorHandler delegate) Creates a new handler. -
Method Summary
Modifier and TypeMethodDescriptionvoid
characters
(char[] ch, int start, int length) void
endElement
(String uri, String localName, String qName) void
void
protected Locator
Gets the geometry parsed by this handler.void
ignorableWhitespace
(char[] ch, int start, int length) boolean
Tests whether this handler has completed parsing a geometry.void
setDocumentLocator
(Locator locator) void
startElement
(String uri, String localName, String qName, Attributes attributes) void
Methods inherited from class org.xml.sax.helpers.DefaultHandler
endDocument, endPrefixMapping, notationDecl, processingInstruction, resolveEntity, skippedEntity, startDocument, startPrefixMapping, unparsedEntityDecl
-
Constructor Details
-
GMLHandler
Creates a new handler. Allows the user to specify a delegate object for error / warning messages. If the delegate also implements ContentHandler then the document Locator will be passed on.- Parameters:
gf
- Geometry Factorydelegate
- Nullable- See Also:
-
-
Method Details
-
isGeometryComplete
public boolean isGeometryComplete()Tests whether this handler has completed parsing a geometry. If this is the case,getGeometry()
can be called to get the value of the parsed geometry.- Returns:
- if the parsing of the geometry is complete
-
getGeometry
Gets the geometry parsed by this handler. This method should only be called AFTER the parser has completed execution- Returns:
- the parsed Geometry, or a GeometryCollection if more than one geometry was parsed
- Throws:
IllegalStateException
- if called before the parse is complete
-
characters
- Specified by:
characters
in interfaceContentHandler
- Overrides:
characters
in classDefaultHandler
- Throws:
SAXException
- See Also:
-
ignorableWhitespace
- Specified by:
ignorableWhitespace
in interfaceContentHandler
- Overrides:
ignorableWhitespace
in classDefaultHandler
- Throws:
SAXException
- See Also:
-
endElement
- Specified by:
endElement
in interfaceContentHandler
- Overrides:
endElement
in classDefaultHandler
- Throws:
SAXException
- See Also:
-
startElement
public void startElement(String uri, String localName, String qName, Attributes attributes) throws SAXException - Specified by:
startElement
in interfaceContentHandler
- Overrides:
startElement
in classDefaultHandler
- Throws:
SAXException
- See Also:
-
setDocumentLocator
- Specified by:
setDocumentLocator
in interfaceContentHandler
- Overrides:
setDocumentLocator
in classDefaultHandler
- See Also:
-
getDocumentLocator
-
fatalError
- Specified by:
fatalError
in interfaceErrorHandler
- Overrides:
fatalError
in classDefaultHandler
- Throws:
SAXException
- See Also:
-
error
- Specified by:
error
in interfaceErrorHandler
- Overrides:
error
in classDefaultHandler
- Throws:
SAXException
- See Also:
-
warning
- Specified by:
warning
in interfaceErrorHandler
- Overrides:
warning
in classDefaultHandler
- Throws:
SAXException
- See Also:
-