org.geotools.data.geojson

Class GeoJSONReader

Object

GeoJSONReader

All Implemented Interfaces:

AutoCloseable

public class GeoJSONReader
extends Object
implements AutoCloseable

Utility class to provide a reader for GeoJSON streams

Author:

ian

Field Summary

Fields

Modifier and Type	Field and Description
static String	GEOMETRY_NAME GEOMETRY_NAME

Constructor Summary

Constructors

Constructor and Description
GeoJSONReader(InputStream is) Builds a GeoJSON parser from a GeoJSON document, provided as an InputStream
GeoJSONReader(String json) Builds a GeoJSON parser from a GeoJSON document, provided as a string
GeoJSONReader(URL url) Builds a GeoJSON parser from a GeoJSON source, located at the specified URL.

Method Summary

Modifier and Type	Method and Description
void	close()
SimpleFeature	getFeature() Parses and returns a single feature from the source
SimpleFeatureCollection	getFeatures() Parses all features in the source and returns them as an in-memory feature collection with a stable FeatureType.
SimpleFeatureIterator	getIterator() Returns a FeatureIterator streaming over the provided source.
FeatureType	getSchema() Returns the current feature type, with the structure discovered so far while parsing features (parse them all in order to get a final, stable feature type):
boolean	isConnected() Returns true if the source is still connected, false otherwise.
boolean	isGuessingDates() Returns true if the parser is trying to convert string formatted as dates into java.util.Date, false otherwise.
boolean	isSchemaChanged()
static SimpleFeature	parseFeature(String json) Pares and returns a single feature out of a GeoJSON document
static SimpleFeatureCollection	parseFeatureCollection(String jsonString) Parses and returns a feature collection from a GeoJSON
static Geometry	parseGeometry(String input) Parses and returns a single geometry
void	setGuessingDates(boolean guessingDates) Enables/Disables guessing strings formatted as dates into java.util.Date.
void	setSchema(SimpleFeatureType schema)
void	setSchemaChanged(boolean schemaChanged)

Methods inherited from class Object

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

Field Detail

GEOMETRY_NAME

public static final String GEOMETRY_NAME

GEOMETRY_NAME

See Also:

Constant Field Values

Constructor Detail

GeoJSONReader

public GeoJSONReader(URL url)
              throws IOException

Builds a GeoJSON parser from a GeoJSON source, located at the specified URL.

Parameters:

url -

Throws:

IOException

GeoJSONReader

public GeoJSONReader(InputStream is)
              throws IOException

Builds a GeoJSON parser from a GeoJSON document, provided as an InputStream

Throws:

IOException

GeoJSONReader

public GeoJSONReader(String json)
              throws IOException

Builds a GeoJSON parser from a GeoJSON document, provided as a string

Throws:

IOException

Method Detail

isGuessingDates

public boolean isGuessingDates()

Returns true if the parser is trying to convert string formatted as dates into java.util.Date, false otherwise. Defaults to true.

setGuessingDates

public void setGuessingDates(boolean guessingDates)

Enables/Disables guessing strings formatted as dates into java.util.Date.

isConnected

public boolean isConnected()

Returns true if the source is still connected, false otherwise.

Returns:

parseFeature

public static SimpleFeature parseFeature(String json)
                                  throws JsonParseException,
                                         IOException

Pares and returns a single feature out of a GeoJSON document

Throws:

JsonParseException

IOException

parseFeatureCollection

public static SimpleFeatureCollection parseFeatureCollection(String jsonString)

Parses and returns a feature collection from a GeoJSON

parseGeometry

public static Geometry parseGeometry(String input)

Parses and returns a single geometry

getFeature

public SimpleFeature getFeature()
                         throws IOException

Parses and returns a single feature from the source

Throws:

IOException

getFeatures

public SimpleFeatureCollection getFeatures()
                                    throws IOException

Parses all features in the source and returns them as an in-memory feature collection with a stable FeatureType. In order to stream use getIterator() instead.

Returns:

Throws:

IOException

getIterator

public SimpleFeatureIterator getIterator()
                                  throws IOException

Returns a FeatureIterator streaming over the provided source. The feature type may evolve feature by feature, discovering new attributes that were not previosly encountered.

Returns:

Throws:

IOException

getSchema

public FeatureType getSchema()
                      throws IOException

Returns the current feature type, with the structure discovered so far while parsing features (parse them all in order to get a final, stable feature type):

Returns:

Throws:

IOException

setSchema

public void setSchema(SimpleFeatureType schema)

Parameters:

schema - the schema to set

isSchemaChanged

public boolean isSchemaChanged()

Returns:

the schemaChanged

setSchemaChanged

public void setSchemaChanged(boolean schemaChanged)

Parameters:

schemaChanged - the schemaChanged to set

close

public void close()
           throws IOException

Specified by:

close in interface AutoCloseable

Throws:

IOException