oracle.spatial.hadoop.vector.util

Class JsonUtils

java.lang.Object

oracle.spatial.hadoop.vector.util.JsonUtils

public class JsonUtils
extends java.lang.Object

Provides some useful JSON-related functions.

Author:

hsaucedo

Constructor Summary

Constructors

Constructor and Description
JsonUtils()

Method Summary

Modifier and Type	Method and Description
static void	addSRIDToGeoJSON(ObjectMapper om, JsonNode json, int srid)
static java.lang.String	addSRIDToGeoJSON(java.lang.String json, int srid) Returns a GeoJSON string made from the given json string and the given SRID
static java.lang.String	createHierarchyCountRecord(java.lang.String id, long result) Generates a count result in JSON format.
static int	getDimensions(JsonNode geomElem)
static JsonNode	getNode(JsonNode rootNode, java.lang.String[] nodePath) Searches a JSON node given a root node and the path of the searched node.
static JsonNode	getNode(JsonNode rootNode, java.lang.String[][] nodePaths) Searches a JSON node given a root node and group of paths where the searched node could be.
static java.lang.String	getTextValue(JsonNode node) Gets a text value of a JSON node containing either, text or numbers
static <V> V	loadJsonAsObject(Path jsonPath, java.lang.Class<? extends V> jsonClass, Configuration conf)
static JGeometry	readGeomCollection(JsonNode geomElem, int dimensions, int srid) Reads a geometry collection from a geoJSON node
static JGeometry	readGeometry(JsonNode geomElem, int srid)
static JGeometry	readGeometry(JsonNode geomElem, int dimensions, int srid) Reads a JGeometry from a geoJSON node in the form: {"type":<geometry-type>", "coordinates":[c1,c2,....cn]}
static JGeometry	readGeometry(java.lang.String json) Reads a JGeometry from a geoJSON string in the form: {"type":<geometry-type>", "crs": { "type": "name", "properties": {"name": "EPSG:SRID"}}"coordinates":[c1,c2,....cn]}
static JGeometry	readGeometry(java.lang.String json, int srid) Reads a JGeometry from a geoJSON string in the form: {"type":<geometry-type>", "coordinates":[c1,c2,....cn]}
static JGeometry	readGeometry(java.lang.String json, int dimensions, int srid) Reads a JGeometry from a geoJSON string in the form: {"type":<geometry-type>", "coordinates":[c1,c2,....cn]}
static JGeometry	readLine(JsonNode geomElem, int dimensions, int srid) Reads a line geometry collection from a geoJSON node
static JGeometry	readMultiLineString(JsonNode geomElem, int dimensions, int srid) Reads a MultiLineString from a geoJSON node
static JGeometry	readMultiPoint(JsonNode geomElem, int dimensions, int srid) Reads a MultiPoint element from a geoJSON node
static JGeometry	readMultiPolygon(JsonNode geomElem, int dimensions, int srid) Reads a multi-polygon geometry collection from a geoJSON node
static JGeometry	readPoint(JsonNode geomElem, int dimensions, int srid) Reads a point geometry collection from a geoJSON node
static JGeometry	readPolygon(JsonNode geomElem, int dimensions, int srid) Reads a polygon geometry collection from a geoJSON node

Methods inherited from class java.lang.Object

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

Constructor Detail

JsonUtils

public JsonUtils()

Method Detail

addSRIDToGeoJSON

public static void addSRIDToGeoJSON(ObjectMapper om,
                                    JsonNode json,
                                    int srid)

addSRIDToGeoJSON

public static java.lang.String addSRIDToGeoJSON(java.lang.String json,
                                                int srid)

Returns a GeoJSON string made from the given json string and the given SRID

Parameters:

json - a geometry in JSON format. The string must only contain geoJSON content.

srid - SRID

Returns:

new GeoJSON string with the SRID information

createHierarchyCountRecord

public static java.lang.String createHierarchyCountRecord(java.lang.String id,
                                                          long result)

Generates a count result in JSON format.

Parameters:

id - an id

result - the count result

Returns:

a JSON count record

getDimensions

public static int getDimensions(JsonNode geomElem)

getNode

public static JsonNode getNode(JsonNode rootNode,
                               java.lang.String[] nodePath)

Searches a JSON node given a root node and the path of the searched node.

Parameters:

rootNode - the JSON node from where the search starts

nodePath - the path to the searched node. Each array entry is the name of a JSON node.

Returns:

a JSON node or null if nothing was found

getNode

public static JsonNode getNode(JsonNode rootNode,
                               java.lang.String[][] nodePaths)

Searches a JSON node given a root node and group of paths where the searched node could be. The search ends at the first path the node is found.

Parameters:

rootNode - the JSON node from where the search starts

nodePaths - a two dimensional array. First dimension elements are JSON paths, there can be one or more paths. Elements of each path are names of JSON nodes.

Returns:

a JSON node or null if nothing was found

getTextValue

public static java.lang.String getTextValue(JsonNode node)

Gets a text value of a JSON node containing either, text or numbers

Parameters:

node - a JSON node

Returns:

the JSON node value as text

loadJsonAsObject

public static <V> V loadJsonAsObject(Path jsonPath,
                                     java.lang.Class<? extends V> jsonClass,
                                     Configuration conf)
                              throws java.io.IOException

Throws:

java.io.IOException

readGeomCollection

public static JGeometry readGeomCollection(JsonNode geomElem,
                                           int dimensions,
                                           int srid)

Reads a geometry collection from a geoJSON node

Parameters:

geomElem - a JSON node with the geometry content

dimensions - the geometry dimensions

srid - the resulting geometry SRID

Returns:

a JGeometry instance with type = JGeometry.GTYPE_COLLECTION

readGeometry

public static JGeometry readGeometry(JsonNode geomElem,
                                     int srid)

readGeometry

public static JGeometry readGeometry(JsonNode geomElem,
                                     int dimensions,
                                     int srid)

Reads a JGeometry from a geoJSON node in the form: {"type":<geometry-type>", "coordinates":[c1,c2,....cn]}

Parameters:

geomElem - a JSON node with the geometry content

dimensions - the geometry dimensions

srid - the resulting geometry SRID

Returns:

a JGeometry instance

readGeometry

public static JGeometry readGeometry(java.lang.String json)

Reads a JGeometry from a geoJSON string in the form: {"type":<geometry-type>", "crs": { "type": "name", "properties": {"name": "EPSG:SRID"}}"coordinates":[c1,c2,....cn]}

Parameters:

json - a geometry in JSON format. The string must only contain geoJSON content.

Returns:

a JGeometry instance

readGeometry

public static JGeometry readGeometry(java.lang.String json,
                                     int srid)

Reads a JGeometry from a geoJSON string in the form: {"type":<geometry-type>", "coordinates":[c1,c2,....cn]}

Parameters:

json - a geometry in JSON format. The string must only contain geoJSON content.

srid - the resulting geometry SRID

Returns:

a JGeometry instance

readGeometry

public static JGeometry readGeometry(java.lang.String json,
                                     int dimensions,
                                     int srid)

Reads a JGeometry from a geoJSON string in the form: {"type":<geometry-type>", "coordinates":[c1,c2,....cn]}

Parameters:

json - a geometry in JSON format. The string must only contain geoJSON content.

dimensions - the geometry dimensions

srid - the resulting geometry SRID

Returns:

a JGeometry instance

readLine

public static JGeometry readLine(JsonNode geomElem,
                                 int dimensions,
                                 int srid)

Reads a line geometry collection from a geoJSON node

Parameters:

geomElem - a JSON node with the geometry content

dimensions - the geometry dimensions

srid - the resulting geometry SRID

Returns:

a JGeometry instance with type = JGeometry.GTYPE_CURVE

readMultiLineString

public static JGeometry readMultiLineString(JsonNode geomElem,
                                            int dimensions,
                                            int srid)

Reads a MultiLineString from a geoJSON node

Parameters:

geomElem - a JSON node with the geometry content

dimensions - the geometry dimensions

srid - the resulting geometry SRID

Returns:

a JGeometry instance with type = JGeometry.GTYPE_MULTICURVE

readMultiPoint

public static JGeometry readMultiPoint(JsonNode geomElem,
                                       int dimensions,
                                       int srid)

Reads a MultiPoint element from a geoJSON node

Parameters:

geomElem - a JSON node with the geometry content

dimensions - the geometry dimensions

srid - the resulting geometry SRID

Returns:

a JGeometry instance with type = JGeometry.GTYPE_MULTIPOINT

readMultiPolygon

public static JGeometry readMultiPolygon(JsonNode geomElem,
                                         int dimensions,
                                         int srid)

Reads a multi-polygon geometry collection from a geoJSON node

Parameters:

geomElem - a JSON node with the geometry content

dimensions - the geometry dimensions

srid - the resulting geometry SRID

Returns:

a JGeometry instance with type = JGeometry.GTYPE_MULTIPOLYGON

readPoint

public static JGeometry readPoint(JsonNode geomElem,
                                  int dimensions,
                                  int srid)

Reads a point geometry collection from a geoJSON node

Parameters:

geomElem - a JSON node with the geometry content

dimensions - the geometry dimensions

srid - the resulting geometry SRID

Returns:

a JGeometry instance with type = JGeometry.GTYPE_POINT

readPolygon

public static JGeometry readPolygon(JsonNode geomElem,
                                    int dimensions,
                                    int srid)

Reads a polygon geometry collection from a geoJSON node

Parameters:

geomElem - a JSON node with the geometry content

dimensions - the geometry dimensions

srid - the resulting geometry SRID

Returns:

a JGeometry instance with type = JGeometry.GTYPE_POLYGON