argo

Class JsonParser

java.lang.Object

argo.JsonParser

public final class JsonParser
extends java.lang.Object

Provides operations to parse JSON.

Instances of this class are immutable, reusable, and thread-safe.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JsonParser.NodeInterningStrategy Strategies a JsonParser can use for object reuse when parsing a document without streaming.
static class	JsonParser.PositionTracking Settings a JsonParser can use for tracking parsing position for error reporting.
static class	JsonParser.PrevalidatedNumber Internal class

Constructor Summary

Constructors

Constructor and Description
JsonParser()

Method Summary

Modifier and Type	Method and Description
JsonParser	nodeInterning(JsonParser.NodeInterningStrategy nodeInterningStrategy) Returns a JsonParser with the given node interning strategy.
JsonNode	parse(java.io.Reader reader) Parses the character stream from the given Reader into a JsonNode object.
JsonNode	parse(java.lang.String json) Parses the given JSON String into a JsonNode object.
java.util.Iterator<JsonStreamElement>	parseStreaming(java.io.Reader reader) Parses the character stream from the given Reader into an Iterator of JsonStreamElements.
void	parseStreaming(java.io.Reader reader, JsonListener jsonListener) Parses the character stream from the given Reader into calls to the given JsonListener.
java.util.Iterator<JsonStreamElement>	parseStreaming(java.lang.String json) Parses the given JSON String into an Iterator of JsonStreamElements.
void	parseStreaming(java.lang.String json, JsonListener jsonListener) Parses the given JSON String into calls to the given JsonListener.
JsonParser	positionTracking(JsonParser.PositionTracking positionTracking) Returns a JsonParser with the given position tracking setting.

Methods inherited from class java.lang.Object

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

Constructor Detail

JsonParser

public JsonParser()

Method Detail

nodeInterning

public JsonParser nodeInterning(JsonParser.NodeInterningStrategy nodeInterningStrategy)

Returns a JsonParser with the given node interning strategy. Defaults to JsonParser.NodeInterningStrategy.INTERN_LEAF_NODES.

Parameters:

nodeInterningStrategy - the node interning strategy to use when parsing without streaming.

Returns:

a JsonParser with the given node interning strategy.

positionTracking

public JsonParser positionTracking(JsonParser.PositionTracking positionTracking)

Returns a JsonParser with the given position tracking setting. Defaults to JsonParser.PositionTracking.TRACK.

Parameters:

positionTracking - the position tracking setting to use.

Returns:

a JsonParser with the given position tracking setting.

parse

public JsonNode parse(java.io.Reader reader)
               throws InvalidSyntaxException,
                      java.io.IOException

Parses the character stream from the given Reader into a JsonNode object.

Parameters:

reader - the Reader to parse.

Returns:

a JsonNode representing the JSON read from the given Reader.

Throws:

InvalidSyntaxException - if the characters streamed from the given Reader do not represent valid JSON.

java.io.IOException - rethrown when reading characters from the given Reader throws IOException.

parse

public JsonNode parse(java.lang.String json)
               throws InvalidSyntaxException

Parses the given JSON String into a JsonNode object.

Parameters:

json - the String to parse.

Returns:

a JsonNode representing the JSON read from the given String.

Throws:

InvalidSyntaxException - if the characters streamed from the given String do not represent valid JSON.

parseStreaming

public java.util.Iterator<JsonStreamElement> parseStreaming(java.io.Reader reader)

Parses the character stream from the given Reader into an Iterator of JsonStreamElements.

The next() and hasNext() methods of the returned Iterator throw

• InvalidSyntaxRuntimeException if the next element could not be read, for example if the next element turns out not to be valid JSON
• JsonStreamException if the underlying character stream failed.

Parameters:

reader - the Reader to parse.

Returns:

an Iterator of JsonStreamElements reading from the given Reader.

parseStreaming

public java.util.Iterator<JsonStreamElement> parseStreaming(java.lang.String json)

Parses the given JSON String into an Iterator of JsonStreamElements.

The next() and hasNext() methods of the returned Iterator throw

• InvalidSyntaxRuntimeException if the next element could not be read, for example if the next element turns out not to be valid JSON
• JsonStreamException if the underlying character stream failed.

Parameters:

json - the String to parse.

Returns:

an Iterator of JsonStreamElements reading from the given Reader.

parseStreaming

public void parseStreaming(java.io.Reader reader,
                           JsonListener jsonListener)
                    throws InvalidSyntaxException,
                           java.io.IOException

Parses the character stream from the given Reader into calls to the given JsonListener.

Parameters:

reader - the Reader to parse.

jsonListener - the JsonListener to notify of parsing events

Throws:

InvalidSyntaxException - if the characters streamed from the given Reader do not represent valid JSON.

java.io.IOException - rethrown when reading characters from the given Reader throws IOException.

parseStreaming

public void parseStreaming(java.lang.String json,
                           JsonListener jsonListener)
                    throws InvalidSyntaxException

Parses the given JSON String into calls to the given JsonListener.

Parameters:

json - the String to parse.

jsonListener - the JsonListener to notify of parsing events

Throws:

InvalidSyntaxException - if the characters streamed from the given String do not represent valid JSON.