net.openhft.saxophone.json

Enum JsonParserOption

java.lang.Object

java.lang.Enum<JsonParserOption>

net.openhft.saxophone.json.JsonParserOption

All Implemented Interfaces:

Serializable, Comparable<JsonParserOption>

public enum JsonParserOption
extends Enum<JsonParserOption>

Options passed to JsonParserBuilder on JsonParser construction specify what input is considered as "valid" JSON, i. e. don't cause ParseException.

See Also:

JsonParserBuilder.options(JsonParserOption, JsonParserOption...)

Enum Constant Summary

Enum Constants

Enum Constant and Description
ALLOW_COMMENTS Ignore JavaScript-style comments present in JSON input.
ALLOW_PARTIAL_VALUES When JsonParser.parse(net.openhft.lang.io.Bytes) is called the parser will check that the top level value was completely consumed.
DONT_VALIDATE_STRINGS When this option is set, the JsonParser will verify that all strings in JSON input are valid UTF8 and will emit a ParseException if this is not so.

Method Summary

Methods

Modifier and Type	Method and Description
static JsonParserOption	valueOf(String name) Returns the enum constant of this type with the specified name.
static JsonParserOption[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

ALLOW_COMMENTS

public static final JsonParserOption ALLOW_COMMENTS

Ignore JavaScript-style comments present in JSON input. Non-standard, but rather fun.

Examples:

{
     "foo": 1, // comment till the end of line
     "bar": /* inline comment */ 2
 }
 

DONT_VALIDATE_STRINGS

public static final JsonParserOption DONT_VALIDATE_STRINGS

When this option is set, the JsonParser will verify that all strings in JSON input are valid UTF8 and will emit a ParseException if this is not so. When set, this option makes parsing slightly more expensive (~7% depending on processor and compiler in use).

ALLOW_PARTIAL_VALUES

public static final JsonParserOption ALLOW_PARTIAL_VALUES

When JsonParser.parse(net.openhft.lang.io.Bytes) is called the parser will check that the top level value was completely consumed. I. e., if called whilst in the middle of parsing a value yajl will throw a ParseException. Setting this option suppresses that check and the corresponding exception.

Method Detail

values

public static JsonParserOption[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (JsonParserOption c : JsonParserOption.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static JsonParserOption valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null