de.k3b.geo.io.gpx

Class GpxReaderBase

java.lang.Object

org.xml.sax.helpers.DefaultHandler

de.k3b.geo.io.gpx.GpxReaderBase

All Implemented Interfaces:

org.xml.sax.ContentHandler, org.xml.sax.DTDHandler, org.xml.sax.EntityResolver, org.xml.sax.ErrorHandler

Direct Known Subclasses:

GpxReader

public class GpxReaderBase
extends org.xml.sax.helpers.DefaultHandler

A parser for xml-geo formats.

   GpxReaderBase parser = new GpxReaderBase(new IGeoInfoHandler() {
        public boolean onGeoInfo(IGeoPointInfo geo) {
          System.out.print(String.format("got lat=%f lon=%f\n", geo.getLatitude(),geo.getLongitude()));
          return true;
        }
     });

   parser.parse(new InputSource(new FileReader( "test.gpx")));

Supported formats:

• gpx-1.0 and gpx-1.1 files
• kml-2.2 files used by google
• wikimedia that is used by web-apis of wikipedia and wikivoyage
• poi files, k3b-s internal xml format

This parser is not acurate: it might pick elements from wrong namespaces.

Note: if you change/add features to this xml parser please also update regression test-data and prog at

• …\LocationMapViewer\k3b-geoHelper\src\test\resources\de\k3b\geo\io\regressionTests*.*
• …\LocationMapViewer\k3b-geoHelper\src\test\java\de.k3b.geo.io.GeoPointDtoRegressionTests.java

Created by k3b on 20.01.2015.

Field Summary

Fields

Modifier and Type	Field and Description
protected GeoPointDto	currentGeoPoint If not null geo-parsing parsing is active
protected GeoPointDto	mReuse If not null this instance is cleared and then reused for every new gpx found
protected IGeoInfoHandler	onGotNewWaypoint Callback to process every point received

Constructor Summary

Constructors

Constructor and Description
GpxReaderBase(IGeoInfoHandler onGotNewWaypoint) Creates a new parser.
GpxReaderBase(IGeoInfoHandler onGotNewWaypoint, GeoPointDto reuse) Creates a new parser.

Method Summary

Modifier and Type	Method and Description
void	characters(char[] chars, int start, int length) Java sax api implementation: Collect value while between start-element and end-element
protected GeoUri	createGeoUriParser(int modes)
void	endElement(java.lang.String uri, java.lang.String localName, java.lang.String qName) Java sax api implementation: Element value and attribut inspection/processig
protected java.lang.Double	getLatOrLong(java.lang.String strLatOrLong)
protected GeoPointDto	newInstance() Factory method: Returns an instance of an empty GeoPointDto
protected GeoPointDto	newInstance(org.xml.sax.Attributes attributes) Returns an instance of GeoPointDto and tries to data from the xml-attributes
void	parse(org.xml.sax.InputSource in) Processes gpx/kml/poi/xml data and calls [@link IGeoInfoHandler#onGeoInfo} for every IGeoPointInfo found.
void	startElement(java.lang.String uri, java.lang.String localName, java.lang.String qName, org.xml.sax.Attributes attributes) Java sax api implementation: Element name inspection/processig

Methods inherited from class org.xml.sax.helpers.DefaultHandler

endDocument, endPrefixMapping, error, fatalError, ignorableWhitespace, notationDecl, processingInstruction, resolveEntity, setDocumentLocator, skippedEntity, startDocument, startPrefixMapping, unparsedEntityDecl, warning

Methods inherited from class java.lang.Object

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

Field Detail

onGotNewWaypoint

protected IGeoInfoHandler onGotNewWaypoint

Callback to process every point received

mReuse

protected final GeoPointDto mReuse

If not null this instance is cleared and then reused for every new gpx found

currentGeoPoint

protected GeoPointDto currentGeoPoint

If not null geo-parsing parsing is active

Constructor Detail

GpxReaderBase

public GpxReaderBase(IGeoInfoHandler onGotNewWaypoint)

Creates a new parser.

Parameters:

onGotNewWaypoint - callback to process every point received

GpxReaderBase

public GpxReaderBase(IGeoInfoHandler onGotNewWaypoint,
                     GeoPointDto reuse)

Creates a new parser.

Parameters:

onGotNewWaypoint - callback to process every point received

reuse - if not null this instance is cleared and then reused for every new gpx found. This way the reader can load different implementations of IGeoPointInfo

Method Detail

parse

public void parse(org.xml.sax.InputSource in)
           throws java.io.IOException

Processes gpx/kml/poi/xml data and calls [@link IGeoInfoHandler#onGeoInfo} for every IGeoPointInfo found.

Throws:

java.io.IOException

newInstance

protected GeoPointDto newInstance()

Factory method: Returns an instance of an empty GeoPointDto

newInstance

protected GeoPointDto newInstance(org.xml.sax.Attributes attributes)

Returns an instance of GeoPointDto and tries to data from the xml-attributes

createGeoUriParser

protected GeoUri createGeoUriParser(int modes)

startElement

public void startElement(java.lang.String uri,
                         java.lang.String localName,
                         java.lang.String qName,
                         org.xml.sax.Attributes attributes)
                  throws org.xml.sax.SAXException

Java sax api implementation: Element name inspection/processig

Specified by:

startElement in interface org.xml.sax.ContentHandler

Overrides:

startElement in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

endElement

public void endElement(java.lang.String uri,
                       java.lang.String localName,
                       java.lang.String qName)
                throws org.xml.sax.SAXException

Java sax api implementation: Element value and attribut inspection/processig

Specified by:

endElement in interface org.xml.sax.ContentHandler

Overrides:

endElement in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException

getLatOrLong

protected java.lang.Double getLatOrLong(java.lang.String strLatOrLong)

characters

public void characters(char[] chars,
                       int start,
                       int length)
                throws org.xml.sax.SAXException

Java sax api implementation: Collect value while between start-element and end-element

Specified by:

characters in interface org.xml.sax.ContentHandler

Overrides:

characters in class org.xml.sax.helpers.DefaultHandler

Throws:

org.xml.sax.SAXException