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
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
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface org.xml.sax.ContentHandler
declaration
-
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:
-
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:
-