Module tools.jackson.databind
Package tools.jackson.databind.cfg

Enum Class JsonNodeFeature

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

  • 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

    • 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: false (since 3.0).

    • 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.

    • USE_BIG_DECIMAL_FOR_FLOATS

      public static final JsonNodeFeature USE_BIG_DECIMAL_FOR_FLOATS
      Determines whether floating-point numbers should be deserialized into BigDecimal when reading JsonNodes. This feature provides more precise control over number deserialization for JsonNode and takes precedence over DeserializationFeature.USE_BIG_DECIMAL_FOR_FLOATS if explicitly set.

      Behavior follows these rules:

      • If explicitly enabled, floating-point numbers will be read as BigDecimal.
      • If explicitly disabled, floating-point numbers will be read as Double.
      • If left undefined (default), the behavior follows DeserializationFeature.USE_BIG_DECIMAL_FOR_FLOATS.

      Default value is false but unless explicitly set, handling depends on more general DeserializationFeature.USE_BIG_DECIMAL_FOR_FLOATS).

  • Method Details

    • values

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

    • valueOf

      public static JsonNodeFeature valueOf(String name)
      Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (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 class has no constant with the specified name
      NullPointerException - if the argument is null

    • enabledByDefault

      public boolean enabledByDefault()
      Specified by:
      enabledByDefault in interface JacksonFeature

    • enabledIn

      public boolean enabledIn(int flags)
      Specified by:
      enabledIn in interface JacksonFeature

    • getMask

      public int getMask()
      Specified by:
      getMask in interface JacksonFeature

    • 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