Enum JsonNodeFeature
- java.lang.Object
-
- java.lang.Enum<JsonNodeFeature>
-
- com.fasterxml.jackson.databind.cfg.JsonNodeFeature
-
- All Implemented Interfaces:
JacksonFeature,DatatypeFeature,java.io.Serializable,java.lang.Comparable<JsonNodeFeature>
public enum JsonNodeFeature extends java.lang.Enum<JsonNodeFeature> implements DatatypeFeature
New Datatype-specific configuration options related to handling ofJsonNodetypes.- Since:
- 2.14
-
-
Enum Constant Summary
Enum Constants Enum Constant Description FAIL_ON_NAN_TO_BIG_DECIMAL_COERCIONDetermines the behavior when coercing `NaN` toBigDecimalwithDeserializationFeature.USE_BIG_DECIMAL_FOR_FLOATSenabled.READ_NULL_PROPERTIESWhen readingJsonNodes are null valued properties included as explicitNullNodes in resultingObjectNodeor skipped?STRIP_TRAILING_BIGDECIMAL_ZEROESFeature that determines whetherBigDecimalvalues will be "normalized" by stripping trailing zeroes off, when constructing nodes withJsonNodeFactory.numberNode(java.math.BigDecimal).WRITE_NULL_PROPERTIESWhen writingJsonNodes are null valued properties written as explicit JSONnulls or skipped?WRITE_PROPERTIES_SORTEDWhen writingcom.fasterxml.jackson.databind.JsonNodes are Object properties (forObjectNodes) sorted alphabetically (using natural order ofString) or not? If not sorted, order is the insertion order; when reading this also means retaining order from the input document.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description booleanenabledByDefault()Accessor for checking whether this feature is enabled by default.booleanenabledIn(int flags)Convenience method for checking whether feature is enabled in given bitmask.intfeatureIndex()Internal index used for efficient storage and index; no user serviceable contents inside!intgetMask()Returns bit mask for this feature instance; must be a single bit, that is of form1 << N.static JsonNodeFeaturevalueOf(java.lang.String name)Returns the enum constant of this type with the specified name.static JsonNodeFeature[]values()Returns an array containing the constants of this enum type, in the order they are declared.
-
-
-
Enum Constant Detail
-
READ_NULL_PROPERTIES
public static final JsonNodeFeature READ_NULL_PROPERTIES
When readingJsonNodes are null valued properties included as explicitNullNodes in resultingObjectNodeor skipped?Default value:
true
-
WRITE_NULL_PROPERTIES
public static final JsonNodeFeature WRITE_NULL_PROPERTIES
When writingJsonNodes are null valued properties written as explicit JSONnulls or skipped?Default value:
true
-
WRITE_PROPERTIES_SORTED
public static final JsonNodeFeature WRITE_PROPERTIES_SORTED
When writingcom.fasterxml.jackson.databind.JsonNodes are Object properties (forObjectNodes) sorted alphabetically (using natural order ofString) or not? If not sorted, order is the insertion order; when reading this also means retaining order from the input document.Default value:
false- Since:
- 2.16
-
STRIP_TRAILING_BIGDECIMAL_ZEROES
public static final JsonNodeFeature STRIP_TRAILING_BIGDECIMAL_ZEROES
Feature that determines whetherBigDecimalvalues will be "normalized" by stripping trailing zeroes off, when constructing nodes withJsonNodeFactory.numberNode(java.math.BigDecimal). If enabled,BigDecimal.stripTrailingZeros()will be called prior to node creation; if disabled, numeric value will be used as is.Default value:
true(for backwards-compatibility).- Since:
- 2.15
-
FAIL_ON_NAN_TO_BIG_DECIMAL_COERCION
public static final JsonNodeFeature FAIL_ON_NAN_TO_BIG_DECIMAL_COERCION
Determines the behavior when coercing `NaN` toBigDecimalwithDeserializationFeature.USE_BIG_DECIMAL_FOR_FLOATSenabled. 1. If set totrue, will throw anInvalidFormatExceptionfor attempting to coerceNaNintoBigDecimal. 2. If set tofalse, will simply let coercingNaNintoBigDecimalhappen, regardless of how such coercion will behave --as of 2.16, will simply stay asNaNof original floating-point type node.Default value is
falsefor backwards-compatibility, but will most likely be changed totruein 3.0.- Since:
- 2.16
-
-
Method Detail
-
values
public static JsonNodeFeature[] 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 (JsonNodeFeature c : JsonNodeFeature.values()) System.out.println(c);
- Returns:
- an array containing the constants of this enum type, in the order they are declared
-
valueOf
public static JsonNodeFeature valueOf(java.lang.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:
java.lang.IllegalArgumentException- if this enum type has no constant with the specified namejava.lang.NullPointerException- if the argument is null
-
enabledByDefault
public boolean enabledByDefault()
Description copied from interface:JacksonFeatureAccessor for checking whether this feature is enabled by default.- Specified by:
enabledByDefaultin interfaceJacksonFeature- Returns:
- Whether this instance is enabled by default or not
-
enabledIn
public boolean enabledIn(int flags)
Description copied from interface:JacksonFeatureConvenience method for checking whether feature is enabled in given bitmask.- Specified by:
enabledInin interfaceJacksonFeature- Parameters:
flags- Bit field that contains a set of enabled features of this type- Returns:
- True if this feature is enabled in passed bit field
-
getMask
public int getMask()
Description copied from interface:JacksonFeatureReturns bit mask for this feature instance; must be a single bit, that is of form1 << N.- Specified by:
getMaskin interfaceJacksonFeature- Returns:
- Bit mask of this feature
-
featureIndex
public int featureIndex()
Description copied from interface:DatatypeFeatureInternal index used for efficient storage and index; no user serviceable contents inside!- Specified by:
featureIndexin interfaceDatatypeFeature
-
-