org.hotwheel.json.impl.jackson

枚举 JacksonParser.Feature

java.lang.Object

java.lang.Enum<JacksonParser.Feature>

org.hotwheel.json.impl.jackson.JacksonParser.Feature

所有已实现的接口:

Serializable, Comparable<JacksonParser.Feature>

封闭类:

JacksonParser

public static enum JacksonParser.Feature
extends Enum<JacksonParser.Feature>

Enumeration that defines all on/off features for parsers.

枚举常量概要

枚举常量

枚举常量和说明
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.
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.

方法概要

限定符和类型	方法和说明
static int	collectDefaults() Method that calculates bit set (flags) of all features that are enabled by default.
boolean	enabledByDefault()
int	getMask()
static JacksonParser.Feature	valueOf(String name) 返回带有指定名称的该类型的枚举常量。
static JacksonParser.Feature[]	values() 按照声明该枚举类型的常量的顺序, 返回 包含这些常量的数组。

从类继承的方法 java.lang.Enum

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

从类继承的方法 java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

枚举常量详细资料

AUTO_CLOSE_SOURCE

public static final JacksonParser.Feature AUTO_CLOSE_SOURCE

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 JsonParser#close.

Feature is enabled by default.

ALLOW_COMMENTS

public static final JacksonParser.Feature ALLOW_COMMENTS

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.

ALLOW_UNQUOTED_FIELD_NAMES

public static final JacksonParser.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).

Since JSON specification requires use of double quotes for field names, this is a non-standard feature, and as such disabled by default.

ALLOW_SINGLE_QUOTES

public static final JacksonParser.Feature ALLOW_SINGLE_QUOTES

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.

ALLOW_UNQUOTED_CONTROL_CHARS

public static final JacksonParser.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. 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.

ALLOW_BACKSLASH_ESCAPING_ANY_CHARACTER

public static final JacksonParser.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.

ALLOW_NUMERIC_LEADING_ZEROS

public static final JacksonParser.Feature ALLOW_NUMERIC_LEADING_ZEROS

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 JsonParser#getText).

Since JSON specification does not allow leading zeroes, this is a non-standard feature, and as such disabled by default.

ALLOW_NON_NUMERIC_NUMBERS

public static final JacksonParser.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). Specific subset contains values that XML Schema (see section 3.2.4.1, Lexical Representation) allows (tokens are quoted contents, not including quotes):

• "INF" (for positive infinity), as well as alias of "Infinity"
• "-INF" (for negative infinity), alias "-Infinity"
• "NaN" (for other not-a-numbers, like result of division by zero)

Since JSON specification does not allow use of such values, this is a non-standard feature, and as such disabled by default.

方法详细资料

values

public static JacksonParser.Feature[] values()

按照声明该枚举类型的常量的顺序, 返回 包含这些常量的数组。该方法可用于迭代 常量, 如下所示:

for (JacksonParser.Feature c : JacksonParser.Feature.values())
    System.out.println(c);

返回:

按照声明该枚举类型的常量的顺序返回的包含这些常量的数组

valueOf

public static JacksonParser.Feature valueOf(String name)

返回带有指定名称的该类型的枚举常量。 字符串必须与用于声明该类型的枚举常量的 标识符完全匹配。(不允许有多余 的空格字符。)

参数:

name - 要返回的枚举常量的名称。

返回:

返回带有指定名称的枚举常量

抛出:

IllegalArgumentException - 如果该枚举类型没有带有指定名称的常量

NullPointerException - 如果参数为空值

collectDefaults

public static int collectDefaults()

Method that calculates bit set (flags) of all features that are enabled by default.

enabledByDefault

public boolean enabledByDefault()

getMask

public int getMask()