java.lang.Object | ||
↳ | java.lang.Enum<E extends java.lang.Enum<E>> | |
↳ | com.fasterxml.jackson.core.JsonParser.Feature |
Enumeration that defines all on/off features for parsers.
Enum Values | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
JsonParser.Feature | 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)
Since JSON specification requires quoting for all control characters, this is a non-standard feature, and as such disabled by default. |
|||||||||
JsonParser.Feature | ALLOW_COMMENTS | Feature that determines whether parser will allow use of Java/C++ style comments (both '/'+'*' and '//' varieties) within parsed content or not. | |||||||||
JsonParser.Feature | 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). | |||||||||
JsonParser.Feature | ALLOW_NUMERIC_LEADING_ZEROS | Feature that determines whether parser will allow JSON integral numbers to start with additional (ignorable) zeroes (like: 000001). | |||||||||
JsonParser.Feature | ALLOW_SINGLE_QUOTES | Feature that determines whether parser will allow use of single quotes (apostrophe, character '\'') for quoting Strings (names and String values). | |||||||||
JsonParser.Feature | 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. | |||||||||
JsonParser.Feature | 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). | |||||||||
JsonParser.Feature | AUTO_CLOSE_SOURCE | Feature that determines whether parser will automatically close underlying input source that is NOT owned by the parser. |
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Method that calculates bit set (flags) of all features that
are enabled by default.
| |||||||||||
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Enum
| |||||||||||
From class
java.lang.Object
| |||||||||||
From interface
java.lang.Comparable
|
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)
Since JSON specification requires quoting for all control characters, this is a non-standard feature, and as such disabled by default.
Feature that determines whether parser will allow use of Java/C++ style comments (both '/'+'*' and '//' varieties) within parsed content or not.
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.
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). Specific subset contains values that XML Schema (see section 3.2.4.1, Lexical Representation) allows (tokens are quoted contents, not including quotes):
Since JSON specification does not allow use of such values, this is a non-standard feature, and as such disabled by default.
Feature that determines whether parser will allow
JSON integral numbers to start with additional (ignorable)
zeroes (like: 000001). If enabled, no exception is thrown, and extra
nulls are silently ignored (and not included in textual representation
exposed via getText()
).
Since JSON specification does not allow leading zeroes, this is a non-standard feature, and as such disabled by default.
Feature that determines whether parser will allow use of single quotes (apostrophe, character '\'') for quoting Strings (names and String values). If so, this is in addition to other acceptabl markers. but not by JSON specification).
Since JSON specification requires use of double quotes for field names, this is a non-standard feature, and as such disabled by default.
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. If feature is set false, an exception is thrown if such a character is encountered.
Since JSON specification requires quoting for all control characters, this is a non-standard feature, and as such disabled by default.
Feature that determines whether parser will allow use of unquoted field names (which is allowed by Javascript, but not by JSON specification).
Since JSON specification requires use of double quotes for field names, this is a non-standard feature, and as such disabled by default.
Feature that determines whether parser will automatically
close underlying input source that is NOT owned by the
parser. If disabled, calling application has to separately
close the underlying 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 close()
.
Feature is enabled by default.
Method that calculates bit set (flags) of all features that are enabled by default.