public static enum JsonParser.Feature extends Enum<JsonParser.Feature>
Enum Constant and Description |
---|
ALLOW_BACKSLASH_ESCAPING_ANY_CHARACTER
Feature that can be enabled to accept quoting of all character
using backslash qooting mechanism: if not enabled, only characters
that are explicitly listed by JSON specification can be thus
escaped (see JSON spec for small list of these characters)
|
ALLOW_COMMENTS
Feature that determines whether parser will allow use
of Java/C++ style comments (both '/'+'*' and
'//' varieties) within parsed content or not.
|
ALLOW_NON_NUMERIC_NUMBERS
Feature that allows parser to recognize set of
"Not-a-Number" (NaN) tokens as legal floating number
values (similar to how many other data formats and
programming language source code allows it).
|
ALLOW_NUMERIC_LEADING_ZEROS
Feature that determines whether parser will allow
JSON integral numbers to start with additional (ignorable)
zeroes (like: 000001).
|
ALLOW_SINGLE_QUOTES
Feature that determines whether parser will allow use
of single quotes (apostrophe, character '\'') for
quoting Strings (names and String values).
|
ALLOW_UNQUOTED_CONTROL_CHARS
Feature that determines whether parser will allow
JSON Strings to contain unquoted control characters
(ASCII characters with value less than 32, including
tab and line feed characters) or not.
|
ALLOW_UNQUOTED_FIELD_NAMES
Feature that determines whether parser will allow use
of unquoted field names (which is allowed by Javascript,
but not by JSON specification).
|
AUTO_CLOSE_SOURCE
Feature that determines whether parser will automatically
close underlying input source that is NOT owned by the
parser.
|
CANONICALIZE_FIELD_NAMES
Feature that determines whether JSON object field names are
to be canonicalized (details of how canonicalization is done
then further specified by
INTERN_FIELD_NAMES ). |
INTERN_FIELD_NAMES
Feature that determines whether JSON object field names are
to be canonicalized using
String.intern() or not:
if enabled, all field names will be intern()ed (and caller
can count on this being true for all such names); if disabled,
no intern()ing is done. |
Modifier and Type | Method and Description |
---|---|
static int |
collectDefaults()
Method that calculates bit set (flags) of all features that
are enabled by default.
|
boolean |
enabledByDefault() |
boolean |
enabledIn(int flags) |
int |
getMask() |
static JsonParser.Feature |
valueOf(String name)
Returns the enum constant of this type with the specified name.
|
static JsonParser.Feature[] |
values()
Returns an array containing the constants of this enum type, in
the order they are declared.
|
public static final JsonParser.Feature AUTO_CLOSE_SOURCE
InputStream
and Reader
instances used to create the parser. If enabled, parser
will handle closing, as long as parser itself gets closed:
this happens when end-of-input is encountered, or parser
is closed by a call to JsonParser.close()
.
Feature is enabled by default.
public static final JsonParser.Feature ALLOW_COMMENTS
Since JSON specification does not mention comments as legal construct, this is a non-standard feature; however, in the wild this is extensively used. As such, feature is disabled by default for parsers and must be explicitly enabled (via factory or parser instance).
This feature can be changed for parser instances.
public static final JsonParser.Feature ALLOW_UNQUOTED_FIELD_NAMES
Since JSON specification requires use of double quotes for field names, this is a non-standard feature, and as such disabled by default.
This feature can be changed for parser instances.
public static final JsonParser.Feature ALLOW_SINGLE_QUOTES
Since JSON specification requires use of double quotes for field names, this is a non-standard feature, and as such disabled by default.
This feature can be changed for parser instances.
public static final JsonParser.Feature ALLOW_UNQUOTED_CONTROL_CHARS
Since JSON specification requires quoting for all control characters, this is a non-standard feature, and as such disabled by default.
This feature can be changed for parser instances.
public static final JsonParser.Feature ALLOW_BACKSLASH_ESCAPING_ANY_CHARACTER
Since JSON specification requires quoting for all control characters, this is a non-standard feature, and as such disabled by default.
This feature can be changed for parser instances.
public static final JsonParser.Feature ALLOW_NUMERIC_LEADING_ZEROS
JsonParser.getText()
).
Since JSON specification does not allow leading zeroes, this is a non-standard feature, and as such disabled by default.
This feature can be changed for parser instances.
public static final JsonParser.Feature ALLOW_NON_NUMERIC_NUMBERS
public static final JsonParser.Feature INTERN_FIELD_NAMES
String.intern()
or not:
if enabled, all field names will be intern()ed (and caller
can count on this being true for all such names); if disabled,
no intern()ing is done. There may still be basic
canonicalization (that is, same String will be used to represent
all identical object property names for a single document).
Note: this setting only has effect if
CANONICALIZE_FIELD_NAMES
is true -- otherwise no
canonicalization of any sort is done.
public static final JsonParser.Feature CANONICALIZE_FIELD_NAMES
INTERN_FIELD_NAMES
).public static JsonParser.Feature[] values()
for (JsonParser.Feature c : JsonParser.Feature.values()) System.out.println(c);
public static JsonParser.Feature valueOf(String name)
name
- the name of the enum constant to be returned.IllegalArgumentException
- if this enum type has no constant
with the specified nameNullPointerException
- if the argument is nullpublic static int collectDefaults()
public boolean enabledByDefault()
public boolean enabledIn(int flags)
public int getMask()