Package com.fasterxml.jackson.databind.cfg

Enum JsonNodeFeature

java.lang.Object
java.lang.Enum<JsonNodeFeature>
com.fasterxml.jackson.databind.cfg.JsonNodeFeature
All Implemented Interfaces:
JacksonFeature, DatatypeFeature, Serializable, Comparable<JsonNodeFeature>, java.lang.constant.Constable
public enum JsonNodeFeature extends Enum<JsonNodeFeature> implements DatatypeFeature
New Datatype-specific configuration options related to handling of JsonNode types.
Since:
2.14

  • Enum Constant Details

    • READ_NULL_PROPERTIES

      public static final JsonNodeFeature READ_NULL_PROPERTIES
      When reading JsonNodes are null valued properties included as explicit NullNodes in resulting ObjectNode or skipped?

      Default value: true

    • WRITE_NULL_PROPERTIES

      public static final JsonNodeFeature WRITE_NULL_PROPERTIES
      When writing JsonNodes are null valued properties written as explicit JSON nulls or skipped?

      Default value: true

    • WRITE_PROPERTIES_SORTED

      public static final JsonNodeFeature WRITE_PROPERTIES_SORTED
      When writing com.fasterxml.jackson.databind.JsonNodes are Object properties (for ObjectNodes) sorted alphabetically (using natural order of String) 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 whether BigDecimal values will be "normalized" by stripping trailing zeroes off, when constructing nodes with JsonNodeFactory.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` to BigDecimal with DeserializationFeature.USE_BIG_DECIMAL_FOR_FLOATS enabled. 1. If set to true, will throw an InvalidFormatException for attempting to coerce NaN into BigDecimal. 2. If set to false, will simply let coercing NaN into BigDecimal happen, regardless of how such coercion will behave --as of 2.16, will simply stay as NaN of original floating-point type node.

      Default value is false for backwards-compatibility, but will most likely be changed to true in 3.0.

      Since:
      2.16

  • Method Details

    • values

      public static JsonNodeFeature[] values()
      Returns an array containing the constants of this enum type, in the order they are declared.
      Returns:
      an array containing the constants of this enum type, in the order they are declared

    • valueOf

      public static JsonNodeFeature valueOf(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:
      IllegalArgumentException - if this enum type has no constant with the specified name
      NullPointerException - if the argument is null

    • enabledByDefault

      public boolean enabledByDefault()
      Description copied from interface: JacksonFeature
      Accessor for checking whether this feature is enabled by default.
      Specified by:
      enabledByDefault in interface JacksonFeature
      Returns:
      Whether this instance is enabled by default or not

    • enabledIn

      public boolean enabledIn(int flags)
      Description copied from interface: JacksonFeature
      Convenience method for checking whether feature is enabled in given bitmask.
      Specified by:
      enabledIn in interface JacksonFeature
      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: JacksonFeature
      Returns bit mask for this feature instance; must be a single bit, that is of form 1 << N.
      Specified by:
      getMask in interface JacksonFeature
      Returns:
      Bit mask of this feature

    • featureIndex

      public int featureIndex()
      Description copied from interface: DatatypeFeature
      Internal index used for efficient storage and index; no user serviceable contents inside!
      Specified by:
      featureIndex in interface DatatypeFeature