org.embulk.util.json

Class JsonValueParser.Builder

java.lang.Object

org.embulk.util.json.JsonValueParser.Builder

Enclosing class:

JsonValueParser

public static final class JsonValueParser.Builder
extends Object

Builds JsonValueParser.

Method Summary

Modifier and Type	Method and Description
JsonValueParser	build(InputStream jsonStream) Builds JsonValueParser for the stringified JSON.
JsonValueParser	build(String json) Builds JsonValueParser for the stringified JSON.
JsonValueParser.Builder	enableSupplementalLiteralsWithNumbers() Enables creating JsonDouble and JsonLong instances with supplemental literal strings.
JsonValueParser.Builder	fallbackForUnparsableNumbers(double defaultDouble, long defaultLong) Enables falling back to default numbers for unparsable numbers.
JsonValueParser.Builder	root(JsonPointer root) Sets the JSON Pointer to the "root" element to parse.
JsonValueParser.Builder	root(String root) Sets the JSON Pointer to the "root" element to parse.
JsonValueParser.Builder	setDepthToFlattenJsonArrays(int depthToFlattenJsonArrays) Sets the depth to flatten JSON Arrays to parse.

Methods inherited from class java.lang.Object

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

Method Detail

root

public JsonValueParser.Builder root(JsonPointer root)

Sets the JSON Pointer to the "root" element to parse.

Parameters:

root - the JSON Pointer to the root element

Returns:

this builder

root

public JsonValueParser.Builder root(String root)

Sets the JSON Pointer to the "root" element to parse.

Parameters:

root - the JSON Pointer to the root element

Returns:

this builder

Throws:

IllegalArgumentException - if the input does not present a valid JSON Pointer expression

setDepthToFlattenJsonArrays

public JsonValueParser.Builder setDepthToFlattenJsonArrays(int depthToFlattenJsonArrays)

Sets the depth to flatten JSON Arrays to parse.

Parameters:

depthToFlattenJsonArrays - the depth to flatten JSON Arrays

Returns:

this builder

enableSupplementalLiteralsWithNumbers

public JsonValueParser.Builder enableSupplementalLiteralsWithNumbers()

Enables creating JsonDouble and JsonLong instances with supplemental literal strings.

JsonDouble.withLiteral(double,String) and JsonLong.withLiteral(long,String) are used to create JsonDouble and JsonLong instances if enabled. The text representations from JsonParser are passed as literals.

The supplemental literal strings would help with representing unparsable numbers, such as integers larger than Long.MAX_VALUE, but literals would consume larger object heap memory.

Returns:

this builder

fallbackForUnparsableNumbers

public JsonValueParser.Builder fallbackForUnparsableNumbers(double defaultDouble,
                                                            long defaultLong)

Enables falling back to default numbers for unparsable numbers.

The parser would throw an exception for unparsable numbers if falling back is not enabled.

Parameters:

defaultDouble - the default for floating-point numbers

defaultLong - the default for integral numbers

Returns:

this builder

build

public JsonValueParser build(String json)
                      throws IOException

Builds JsonValueParser for the stringified JSON.

Parameters:

json - the stringified JSON

Returns:

the JsonValueParser instance created

Throws:

IOException

build

public JsonValueParser build(InputStream jsonStream)
                      throws IOException

Builds JsonValueParser for the stringified JSON.

Parameters:

jsonStream - InputStream of the stringified JSON

Returns:

the JsonValueParser instance created

Throws:

IOException