Class MissingNode

  • All Implemented Interfaces:
    TreeNode, JsonSerializable, Serializable, Iterable<JsonNode>

    public final class MissingNode
    extends ValueNode
    This singleton node class is generated to denote "missing nodes" along paths that do not exist. For example, if a path via element of an array is requested for an element outside range of elements in the array; or for a non-array value, result will be reference to this node.

    In most respects this placeholder node will act as NullNode; for example, for purposes of value conversions, value is considered to be null and represented as value zero when used for numeric conversions.

    See Also:
    Serialized Form
    • Method Detail

      • deepCopy

        public <T extends JsonNode> T deepCopy()
        Description copied from class: ValueNode
        All current value nodes are immutable, so we can just return them as is.
        Overrides:
        deepCopy in class ValueNode
        Returns:
        Node that is either a copy of this node (and all non-leaf children); or, for immutable leaf nodes, node itself.
      • getInstance

        public static MissingNode getInstance()
      • asToken

        public JsonToken asToken()
        Description copied from class: BaseJsonNode
        Method that can be used for efficient type detection when using stream abstraction for traversing nodes. Will return the first JsonToken that equivalent stream event would produce (for most nodes there is just one token but for structured/container types multiple)
        Specified by:
        asToken in interface TreeNode
        Specified by:
        asToken in class ValueNode
        Returns:
        JsonToken that is most closely associated with the node type
      • asText

        public String asText()
        Description copied from class: JsonNode
        Method that will return a valid String representation of the container value, if the node is a value node (method JsonNode.isValueNode() returns true), otherwise empty String.
        Specified by:
        asText in class JsonNode
      • asText

        public String asText​(String defaultValue)
        Description copied from class: JsonNode
        Method similar to JsonNode.asText(), except that it will return defaultValue in cases where null value would be returned; either for missing nodes (trying to access missing property, or element at invalid item for array) or explicit nulls.
        Overrides:
        asText in class JsonNode
      • require

        public JsonNode require()
        Description copied from class: JsonNode
        Method that may be called to verify that this node is NOT so-called "missing node": that is, one for which JsonNode.isMissingNode() returns true. If not missing node, this is returned to allow chaining; otherwise IllegalArgumentException is thrown.
        Overrides:
        require in class JsonNode
        Returns:
        this node to allow chaining
      • toString

        public String toString()
        Description copied from class: JsonNode
        Method that will produce (as of Jackson 2.10) valid JSON using default settings of databind, as String. If you want other kinds of JSON output (or output formatted using one of other Jackson-supported data formats) make sure to use ObjectMapper or ObjectWriter to serialize an instance, for example:
           String json = objectMapper.writeValueAsString(rootNode);
        

        Note: method defined as abstract to ensure all implementation classes explicitly implement method, instead of relying on Object.toString() definition.

        Overrides:
        toString in class BaseJsonNode
      • equals

        public boolean equals​(Object o)
        Description copied from class: JsonNode
        Equality for node objects is defined as full (deep) value equality. This means that it is possible to compare complete JSON trees for equality by comparing equality of root nodes.

        Note: marked as abstract to ensure all implementation classes define it properly and not rely on definition from Object.

        Specified by:
        equals in class JsonNode