org.wikimedia.eventutilities.core.json

Class JsonLoader

java.lang.Object

org.wikimedia.eventutilities.core.json.JsonLoader

public class JsonLoader
extends Object

Uses a ResourceLoader to load content at URIs and parse it into YAML or JSON. If the data fetched from a URI starts with a { or [ character, it will be assumed to be JSON and JsonParser will be used. Otherwise YAMLParser will be used. JSON data can contain certain unicode characters that YAML cannot, so it is best to use JsonParser when we can.

Constructor Summary

Constructors

Constructor and Description
JsonLoader(ResourceLoader resourceLoader)

Method Summary

Modifier and Type	Method and Description
String	asString(com.fasterxml.jackson.databind.JsonNode jsonNode) Convenience method to reuse our ObjectMapper to serialize a JsonNode to a JSON String.
<T> T	convertValue(com.fasterxml.jackson.databind.JsonNode jsonNode, Class<T> t) Convenience method to reuse our ObjectMapper to convert a JsonNode to a Java Class.
ResourceLoader	getResourceLoader() Returns the underlying ResourceLoader.
com.fasterxml.jackson.databind.JsonNode	load(URI uri) Given a schemaURI, this will request the JSON or YAML content at that URI and parse it into a JsonNode.
com.fasterxml.jackson.databind.JsonNode	parse(String data) Parses the JSON or YAML string into a JsonNode.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

JsonLoader

public JsonLoader(ResourceLoader resourceLoader)

Method Detail

load

public com.fasterxml.jackson.databind.JsonNode load(URI uri)
                                             throws JsonLoadingException

Given a schemaURI, this will request the JSON or YAML content at that URI and parse it into a JsonNode. $refs will be resolved. The compiled schema will be cached by schemaURI, and only looked up once per schemaURI.

Returns:

the jsonschema at schemaURI.

Throws:

JsonLoadingException

parse

public com.fasterxml.jackson.databind.JsonNode parse(String data)
                                              throws JsonLoadingException

Parses the JSON or YAML string into a JsonNode.

Parameters:

data - JSON or YAML string to parse into a JsonNode.

Throws:

JsonLoadingException

asString

public String asString(com.fasterxml.jackson.databind.JsonNode jsonNode)
                throws com.fasterxml.jackson.core.JsonProcessingException

Convenience method to reuse our ObjectMapper to serialize a JsonNode to a JSON String.

Throws:

com.fasterxml.jackson.core.JsonProcessingException

convertValue

public <T> T convertValue(com.fasterxml.jackson.databind.JsonNode jsonNode,
                          Class<T> t)

Convenience method to reuse our ObjectMapper to convert a JsonNode to a Java Class. See: ObjectMapper.convertValue(Object, Class)

getResourceLoader

public ResourceLoader getResourceLoader()

Returns the underlying ResourceLoader.

toString

public String toString()

Overrides:

toString in class Object