Class MissingNode

  • All Implemented Interfaces:
    Iterable<JsonNode>, JsonSerializable, JsonSerializableWithType

    public final class MissingNode
    extends BaseJsonNode
    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.

    • Method Detail

      • 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 class BaseJsonNode
      • asText

        public String asText()
        Description copied from class: JsonNode
        Method that will return 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
      • asBoolean

        public boolean asBoolean​(boolean defaultValue)
        Description copied from class: JsonNode
        Method that will try to convert value of this node to a Java boolean. JSON booleans map naturally; integer numbers other than 0 map to true, and 0 maps to false and Strings 'true' and 'false' map to corresponding values.

        If representation can not be converted to a boolean value (including structured types like Objects and Arrays), specified defaultValue will be returned; no exceptions are thrown.

        Overrides:
        asBoolean in class JsonNode
      • asInt

        public int asInt​(int defaultValue)
        Description copied from class: JsonNode
        Method that will try to convert value of this node to a Java int. Numbers are coerced using default Java rules; booleans convert to 0 (false) and 1 (true), and Strings are parsed using default Java language integer parsing rules.

        If representation can not be converted to an int (including structured types like Objects and Arrays), specified defaultValue will be returned; no exceptions are thrown.

        Overrides:
        asInt in class JsonNode
      • asLong

        public long asLong​(long defaultValue)
        Description copied from class: JsonNode
        Method that will try to convert value of this node to a Java long. Numbers are coerced using default Java rules; booleans convert to 0 (false) and 1 (true), and Strings are parsed using default Java language integer parsing rules.

        If representation can not be converted to an long (including structured types like Objects and Arrays), specified defaultValue will be returned; no exceptions are thrown.

        Overrides:
        asLong in class JsonNode
      • asDouble

        public double asDouble​(double defaultValue)
        Description copied from class: JsonNode
        Method that will try to convert value of this node to a Java double. Numbers are coerced using default Java rules; booleans convert to 0.0 (false) and 1.0 (true), and Strings are parsed using default Java language integer parsing rules.

        If representation can not be converted to an int (including structured types like Objects and Arrays), specified defaultValue will be returned; no exceptions are thrown.

        Overrides:
        asDouble in class JsonNode
      • path

        public JsonNode path​(String fieldName)
        Description copied from class: JsonNode
        This method is similar to JsonNode.get(String), except that instead of returning null if no such value exists (due to this node not being an object, or object not having value for the specified field), a "missing node" (node that returns true for JsonNode.isMissingNode()) will be returned. This allows for convenient and safe chained access via path calls.
        Specified by:
        path in class JsonNode
      • path

        public JsonNode path​(int index)
        Description copied from class: JsonNode
        This method is similar to JsonNode.get(int), except that instead of returning null if no such element exists (due to index being out of range, or this node not being an array), a "missing node" (node that returns true for JsonNode.isMissingNode()) will be returned. This allows for convenient and safe chained access via path calls.
        Specified by:
        path in class JsonNode
      • 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
      • toString

        public String toString()
        Description copied from class: JsonNode

        Note: marked as abstract to ensure all implementation classes define it properly.

        Specified by:
        toString in class JsonNode