org.embulk.util.json

Class JsonValueParser

java.lang.Object

org.embulk.util.json.JsonValueParser

All Implemented Interfaces:

Closeable, AutoCloseable

public final class JsonValueParser
extends Object
implements Closeable

Parses a stringified JSON to Embulk's JsonValue.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JsonValueParser.Builder Builds JsonValueParser.

Method Summary

Modifier and Type	Method and Description
static JsonValueParser.Builder	builder() Returns a new builder.
static JsonValueParser.Builder	builder(JsonFactory jsonFactory) Returns a new builder with the specified JsonFactory.
JsonValue[]	captureJsonValues(CapturingPointers capturingPointers) Captures JsonValues from the parser with the specified capturing pointers.
void	close() Closes the parser.
JsonValue	readJsonValue() Reads a JsonValue from the parser.

Methods inherited from class java.lang.Object

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

Method Detail

builder

public static JsonValueParser.Builder builder()

Returns a new builder.

It applies some default configurations for its internal JsonFactory. The defaults include:

• Allowing JSON Strings to contain unquoted control characters
• Allowing to recognize set of "Not-a-Number" (NaN) tokens as legal floating number values

Note that the defaults may change in future versions.

Returns:

the new builder

builder

public static JsonValueParser.Builder builder(JsonFactory jsonFactory)

Returns a new builder with the specified JsonFactory.

It applies no additional configuration for the specified JsonFactory.

Returns:

the new builder

readJsonValue

public JsonValue readJsonValue()
                        throws IOException

Reads a JsonValue from the parser.

Returns:

the JSON value, or null if the parser reaches at the end of input in the beginning

Throws:

IOException - if failing to read JSON

JsonParseException - if failing to parse JSON

captureJsonValues

public JsonValue[] captureJsonValues(CapturingPointers capturingPointers)
                              throws IOException

Captures JsonValues from the parser with the specified capturing pointers.

Returns:

an array of the captured JSON values, or null if the parser reaches at the end of input in the beginning

Throws:

IOException - if failing to read JSON

JsonParseException - if failing to parse JSON

close

public final void close()
                 throws IOException

Closes the parser.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException - if failing to close