|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | ENUM CONSTANTS | FIELD | METHOD | DETAIL: ENUM CONSTANTS | FIELD | METHOD |
java.lang.Objectjava.lang.Enum<JsonParser.Feature>
org.codehaus.jackson.JsonParser.Feature
public static enum JsonParser.Feature
Enumeration that defines all togglable features for parsers.
Enum Constant Summary | |
---|---|
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. |
Method Summary | |
---|---|
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. |
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 |
---|
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
).
Method Detail |
---|
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 name
NullPointerException
- if the argument is nullpublic static int collectDefaults()
public boolean enabledByDefault()
public boolean enabledIn(int flags)
public int getMask()
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | ENUM CONSTANTS | FIELD | METHOD | DETAIL: ENUM CONSTANTS | FIELD | METHOD |