Module tools.jackson.databind
Package tools.jackson.databind.node

Class JsonNodeFactory

java.lang.Object
tools.jackson.databind.node.JsonNodeFactory
All Implemented Interfaces:
Serializable, JsonNodeCreator
public class JsonNodeFactory extends Object implements Serializable, JsonNodeCreator
Base class that specifies methods for getting access to Node instances (newly constructed, or shared, depending on type), as well as basic implementation of the methods. Designed to be sub-classed if extended functionality (additions to behavior of node types, mostly) is needed.

Note that behavior of "exact BigDecimal value" (aka "strip trailing zeroes of BigDecimal or not") changed in 3.0: new JsonNodeFeature.STRIP_TRAILING_BIGDECIMAL_ZEROES setting is used to externally configure this behavior. Note, too, that this factory will no longer handle this normalization (if enabled): caller (like JsonNodeDeserializer) is expected to handle it.

See Also:

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final JsonNodeFactory
    instance
    Default singleton instance that construct "standard" node instances: given that this class is stateless, a globally shared singleton can be used.
    protected static final int
    MAX_ELEMENT_INDEX_FOR_INSERT
    Constant that defines maximum JsonPointer element index we use for inserts.

  • Constructor Summary

    Constructors
    Constructor
    Description
    JsonNodeFactory()
    Default constructor.

  • Method Summary

    Modifier and Type
    Method
    Description
    protected boolean
    _inIntRange(long l)
     
    ArrayNode
    arrayNode()
    Factory method for constructing an empty JSON Array node
    ArrayNode
    arrayNode(int capacity)
    Factory method for constructing a JSON Array node with an initial capacity
    BinaryNode
    binaryNode(byte[] data)
    Factory method for constructing a node that represents given binary data, and will get serialized as equivalent base64-encoded String value
    BinaryNode
    binaryNode(byte[] data, int offset, int length)
    Factory method for constructing a node that represents given binary data, and will get serialized as equivalent base64-encoded String value
    BooleanNode
    booleanNode(boolean v)
    Factory method for getting an instance of JSON boolean value (either literal 'true' or 'false')
    int
    getMaxElementIndexForInsert()
     
    JsonNode
    missingNode()
     
    NullNode
    nullNode()
    Factory method for getting an instance of JSON null node (which represents literal null value)
    NumericNode
    numberNode(byte v)
    Factory method for getting an instance of JSON numeric value that expresses given 8-bit value
    NumericNode
    numberNode(double v)
    Factory method for getting an instance of JSON numeric value that expresses given 64-bit floating point value
    NumericNode
    numberNode(float v)
    Factory method for getting an instance of JSON numeric value that expresses given 32-bit floating point value
    NumericNode
    numberNode(int v)
    Factory method for getting an instance of JSON numeric value that expresses given 32-bit integer value
    NumericNode
    numberNode(long v)
    Factory method for getting an instance of JSON numeric value that expresses given 64-bit integer value
    NumericNode
    numberNode(short v)
    Factory method for getting an instance of JSON numeric value that expresses given 16-bit integer value
    ValueNode
    numberNode(Byte value)
    Alternate factory method that will handle wrapper value, which may be null.
    ValueNode
    numberNode(Double value)
    Alternate factory method that will handle wrapper value, which may be null.
    ValueNode
    numberNode(Float value)
    Alternate factory method that will handle wrapper value, which may be null.
    ValueNode
    numberNode(Integer value)
    Alternate factory method that will handle wrapper value, which may be null.
    ValueNode
    numberNode(Long v)
    Alternate factory method that will handle wrapper value, which may be null.
    ValueNode
    numberNode(Short value)
    Alternate factory method that will handle wrapper value, which may be null.
    ValueNode
    numberNode(BigDecimal v)
    Factory method for getting an instance of JSON numeric value that expresses given unlimited precision floating point value
    ValueNode
    numberNode(BigInteger v)
    Factory method for getting an instance of JSON numeric value that expresses given unlimited range integer value
    ObjectNode
    objectNode()
    Factory method for constructing an empty JSON Object ("struct") node
    ValueNode
    pojoNode(Object pojo)
    Factory method for constructing a wrapper for POJO ("Plain Old Java Object") objects; these will get serialized using data binding, usually as JSON Objects, but in some cases as JSON Strings or other node types.
    ValueNode
    rawValueNode(RawValue value)
    Factory method to use for adding "raw values"; pre-encoded values that are included exactly as-is when node is serialized.
    StringNode
    stringNode(String text)
    Factory method for constructing a node that represents JSON String value

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    Methods inherited from interface tools.jackson.databind.node.JsonNodeCreator

    textNode

  • Field Details

    • MAX_ELEMENT_INDEX_FOR_INSERT

      protected static final int MAX_ELEMENT_INDEX_FOR_INSERT
      Constant that defines maximum JsonPointer element index we use for inserts.
      See Also:

    • instance

      public static final JsonNodeFactory instance
      Default singleton instance that construct "standard" node instances: given that this class is stateless, a globally shared singleton can be used.

      Default for 3.x is to make no changes; no normalization by default.

  • Constructor Details

    • JsonNodeFactory

      public JsonNodeFactory()
      Default constructor.

  • Method Details

    • getMaxElementIndexForInsert

      public int getMaxElementIndexForInsert()

    • booleanNode

      public BooleanNode booleanNode(boolean v)
      Factory method for getting an instance of JSON boolean value (either literal 'true' or 'false')
      Specified by:
      booleanNode in interface JsonNodeCreator

    • missingNode

      public JsonNode missingNode()
      Specified by:
      missingNode in interface JsonNodeCreator

    • nullNode

      public NullNode nullNode()
      Factory method for getting an instance of JSON null node (which represents literal null value)
      Specified by:
      nullNode in interface JsonNodeCreator

    • numberNode

      public NumericNode numberNode(byte v)
      Factory method for getting an instance of JSON numeric value that expresses given 8-bit value
      Specified by:
      numberNode in interface JsonNodeCreator

    • numberNode

      public ValueNode numberNode(Byte value)
      Alternate factory method that will handle wrapper value, which may be null. Due to possibility of null, returning type is not guaranteed to be NumericNode, but just ValueNode.
      Specified by:
      numberNode in interface JsonNodeCreator

    • numberNode

      public NumericNode numberNode(short v)
      Factory method for getting an instance of JSON numeric value that expresses given 16-bit integer value
      Specified by:
      numberNode in interface JsonNodeCreator

    • numberNode

      public ValueNode numberNode(Short value)
      Alternate factory method that will handle wrapper value, which may be null. Due to possibility of null, returning type is not guaranteed to be NumericNode, but just ValueNode.
      Specified by:
      numberNode in interface JsonNodeCreator

    • numberNode

      public NumericNode numberNode(int v)
      Factory method for getting an instance of JSON numeric value that expresses given 32-bit integer value
      Specified by:
      numberNode in interface JsonNodeCreator

    • numberNode

      public ValueNode numberNode(Integer value)
      Alternate factory method that will handle wrapper value, which may be null. Due to possibility of null, returning type is not guaranteed to be NumericNode, but just ValueNode.
      Specified by:
      numberNode in interface JsonNodeCreator

    • numberNode

      public NumericNode numberNode(long v)
      Factory method for getting an instance of JSON numeric value that expresses given 64-bit integer value
      Specified by:
      numberNode in interface JsonNodeCreator

    • numberNode

      public ValueNode numberNode(Long v)
      Alternate factory method that will handle wrapper value, which may be null. Due to possibility of null, returning type is not guaranteed to be NumericNode, but just ValueNode.
      Specified by:
      numberNode in interface JsonNodeCreator

    • numberNode

      public ValueNode numberNode(BigInteger v)
      Factory method for getting an instance of JSON numeric value that expresses given unlimited range integer value
      Specified by:
      numberNode in interface JsonNodeCreator

    • numberNode

      public NumericNode numberNode(float v)
      Factory method for getting an instance of JSON numeric value that expresses given 32-bit floating point value
      Specified by:
      numberNode in interface JsonNodeCreator

    • numberNode

      public ValueNode numberNode(Float value)
      Alternate factory method that will handle wrapper value, which may be null. Due to possibility of null, returning type is not guaranteed to be NumericNode, but just ValueNode.
      Specified by:
      numberNode in interface JsonNodeCreator

    • numberNode

      public NumericNode numberNode(double v)
      Factory method for getting an instance of JSON numeric value that expresses given 64-bit floating point value
      Specified by:
      numberNode in interface JsonNodeCreator

    • numberNode

      public ValueNode numberNode(Double value)
      Alternate factory method that will handle wrapper value, which may be null. Due to possibility of null, returning type is not guaranteed to be NumericNode, but just ValueNode.
      Specified by:
      numberNode in interface JsonNodeCreator

    • numberNode

      public ValueNode numberNode(BigDecimal v)
      Factory method for getting an instance of JSON numeric value that expresses given unlimited precision floating point value

      Note that no normalization is performed here; caller may choose to do that, based on JsonNodeFeature.STRIP_TRAILING_BIGDECIMAL_ZEROES setting.

      Specified by:
      numberNode in interface JsonNodeCreator

    • stringNode

      public StringNode stringNode(String text)
      Factory method for constructing a node that represents JSON String value
      Specified by:
      stringNode in interface JsonNodeCreator

    • binaryNode

      public BinaryNode binaryNode(byte[] data)
      Factory method for constructing a node that represents given binary data, and will get serialized as equivalent base64-encoded String value
      Specified by:
      binaryNode in interface JsonNodeCreator

    • binaryNode

      public BinaryNode binaryNode(byte[] data, int offset, int length)
      Factory method for constructing a node that represents given binary data, and will get serialized as equivalent base64-encoded String value
      Specified by:
      binaryNode in interface JsonNodeCreator

    • arrayNode

      public ArrayNode arrayNode()
      Factory method for constructing an empty JSON Array node
      Specified by:
      arrayNode in interface JsonNodeCreator

    • arrayNode

      public ArrayNode arrayNode(int capacity)
      Factory method for constructing a JSON Array node with an initial capacity
      Specified by:
      arrayNode in interface JsonNodeCreator
      Since:
      2.8

    • objectNode

      public ObjectNode objectNode()
      Factory method for constructing an empty JSON Object ("struct") node
      Specified by:
      objectNode in interface JsonNodeCreator

    • pojoNode

      public ValueNode pojoNode(Object pojo)
      Factory method for constructing a wrapper for POJO ("Plain Old Java Object") objects; these will get serialized using data binding, usually as JSON Objects, but in some cases as JSON Strings or other node types.
      Specified by:
      pojoNode in interface JsonNodeCreator

    • rawValueNode

      public ValueNode rawValueNode(RawValue value)
      Description copied from interface: JsonNodeCreator
      Factory method to use for adding "raw values"; pre-encoded values that are included exactly as-is when node is serialized. This may be used, for example, to include fully serialized JSON sub-trees. Note that the concept may not work with all backends, and since no translation of any kinds is done it will not work when converting between data formats.
      Specified by:
      rawValueNode in interface JsonNodeCreator

    • _inIntRange

      protected boolean _inIntRange(long l)