Class ObjectNode

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      JsonToken asToken()
      Method that can be used for efficient type detection when using stream abstraction for traversing nodes.
      boolean equals​(java.lang.Object o)
      Equality for node objects is defined as full (deep) value equality.
      ObjectNode findParent​(java.lang.String fieldName)
      Method for finding a JSON Object that contains specified field, within this node or its descendants.
      java.util.List<JsonNode> findParents​(java.lang.String fieldName, java.util.List<JsonNode> foundSoFar)  
      JsonNode findValue​(java.lang.String fieldName)
      Method for finding a JSON Object field with specified name in this node or its child nodes, and returning value it has.
      java.util.List<JsonNode> findValues​(java.lang.String fieldName, java.util.List<JsonNode> foundSoFar)  
      java.util.List<java.lang.String> findValuesAsText​(java.lang.String fieldName, java.util.List<java.lang.String> foundSoFar)  
      JsonNode get​(int index)
      Method for accessing value of the specified element of an array node.
      JsonNode get​(java.lang.String fieldName)
      Method for accessing value of the specified field of an object node.
      java.util.Iterator<JsonNode> getElements()
      Method for accessing all value nodes of this Node, iff this node is a JSON Array or Object node.
      java.util.Iterator<java.lang.String> getFieldNames()
      Method for accessing names of all fields for this Node, iff this node is a JSON Object node.
      java.util.Iterator<java.util.Map.Entry<java.lang.String,​JsonNode>> getFields()
      Method to use for accessing all fields (with both names and values) of this JSON Object.
      int hashCode()  
      boolean isObject()  
      JsonNode path​(int index)
      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.
      JsonNode path​(java.lang.String fieldName)
      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.
      void put​(java.lang.String fieldName, boolean v)
      Method for setting value of a field to specified String value.
      void put​(java.lang.String fieldName, byte[] v)
      Method for setting value of a field to specified binary value
      void put​(java.lang.String fieldName, double v)
      Method for setting value of a field to specified numeric value.
      void put​(java.lang.String fieldName, float v)
      Method for setting value of a field to specified numeric value.
      void put​(java.lang.String fieldName, int v)
      Method for setting value of a field to specified numeric value.
      void put​(java.lang.String fieldName, long v)
      Method for setting value of a field to specified numeric value.
      void put​(java.lang.String fieldName, java.lang.Boolean value)
      Alternative method that we need to avoid bumping into NPE issues with auto-unboxing.
      void put​(java.lang.String fieldName, java.lang.Double value)
      Alternative method that we need to avoid bumping into NPE issues with auto-unboxing.
      void put​(java.lang.String fieldName, java.lang.Float value)
      Alternative method that we need to avoid bumping into NPE issues with auto-unboxing.
      void put​(java.lang.String fieldName, java.lang.Integer value)
      Alternative method that we need to avoid bumping into NPE issues with auto-unboxing.
      void put​(java.lang.String fieldName, java.lang.Long value)
      Alternative method that we need to avoid bumping into NPE issues with auto-unboxing.
      void put​(java.lang.String fieldName, java.lang.String v)
      Method for setting value of a field to specified String value.
      void put​(java.lang.String fieldName, java.math.BigDecimal v)
      Method for setting value of a field to specified numeric value.
      JsonNode put​(java.lang.String fieldName, JsonNode value)
      Method that will set specified field, replacing old value, if any.
      JsonNode putAll​(java.util.Map<java.lang.String,​JsonNode> properties)
      Method for adding given properties to this object node, overriding any existing values for those properties.
      JsonNode putAll​(ObjectNode other)
      Method for adding all properties of the given Object, overriding any existing values for those properties.
      ArrayNode putArray​(java.lang.String fieldName)
      Method that will construct an ArrayNode and add it as a field of this ObjectNode, replacing old value, if any.
      protected void putContentsTo​(java.util.Map<java.lang.String,​JsonNode> dst)  
      void putNull​(java.lang.String fieldName)  
      ObjectNode putObject​(java.lang.String fieldName)
      Method that will construct an ObjectNode and add it as a field of this ObjectNode, replacing old value, if any.
      void putPOJO​(java.lang.String fieldName, java.lang.Object pojo)  
      JsonNode remove​(java.lang.String fieldName)
      Method for removing field entry from this ObjectNode.
      ObjectNode remove​(java.util.Collection<java.lang.String> fieldNames)
      Method for removing specified field properties out of this ObjectNode.
      ObjectNode removeAll()
      Method for removing all field properties, such that this ObjectNode will contain no properties after call.
      ObjectNode retain​(java.lang.String... fieldNames)
      Method for removing all field properties out of this ObjectNode except for ones specified in argument.
      ObjectNode retain​(java.util.Collection<java.lang.String> fieldNames)
      Method for removing all field properties out of this ObjectNode except for ones specified in argument.
      void serialize​(JsonGenerator jg, SerializerProvider provider)
      Method that can be called to serialize this node and all of its descendants using specified JSON generator.
      void serializeWithType​(JsonGenerator jg, SerializerProvider provider, TypeSerializer typeSer)
      Type information is needed, even if JsonNode instances are "plain" JSON, since they may be mixed with other types.
      int size()
      Method that returns number of child nodes this node contains: for Array nodes, number of child elements, for Object nodes, number of fields, and for all other nodes 0.
      java.lang.String toString()
      Note: marked as abstract to ensure all implementation classes define it properly.
      ObjectNode with​(java.lang.String propertyName)
      Method that can be called on object nodes, to access a property that has object value; or if no such property exists, to create and return such object node.
      • Methods inherited from class java.lang.Object

        clone, finalize, getClass, notify, notifyAll, wait, wait, wait
      • Methods inherited from interface java.lang.Iterable

        forEach, spliterator
    • Field Detail

      • _children

        protected java.util.LinkedHashMap<java.lang.String,​JsonNode> _children
    • Method Detail

      • 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 ContainerNode
      • isObject

        public boolean isObject()
        Overrides:
        isObject in class JsonNode
        Returns:
        True if this node represents Json Object
      • size

        public int size()
        Description copied from class: JsonNode
        Method that returns number of child nodes this node contains: for Array nodes, number of child elements, for Object nodes, number of fields, and for all other nodes 0.
        Specified by:
        size in class ContainerNode
        Returns:
        For non-container nodes returns 0; for arrays number of contained elements, and for objects number of fields.
      • getElements

        public java.util.Iterator<JsonNode> getElements()
        Description copied from class: JsonNode
        Method for accessing all value nodes of this Node, iff this node is a JSON Array or Object node. In case of Object node, field names (keys) are not included, only values. For other types of nodes, returns empty iterator.
        Overrides:
        getElements in class JsonNode
      • get

        public JsonNode get​(int index)
        Description copied from class: JsonNode
        Method for accessing value of the specified element of an array node. For other nodes, null is always returned.

        For array nodes, index specifies exact location within array and allows for efficient iteration over child elements (underlying storage is guaranteed to be efficiently indexable, i.e. has random-access to elements). If index is less than 0, or equal-or-greater than node.size(), null is returned; no exception is thrown for any index.

        Specified by:
        get in class ContainerNode
        Returns:
        Node that represent value of the specified element, if this node is an array and has specified element. Null otherwise.
      • get

        public JsonNode get​(java.lang.String fieldName)
        Description copied from class: JsonNode
        Method for accessing value of the specified field of an object node. If this node is not an object (or it does not have a value for specified field name), or if there is no field with such name, null is returned.
        Specified by:
        get in class ContainerNode
        Returns:
        Node that represent value of the specified field, if this node is an object and has value for the specified field. Null otherwise.
      • getFieldNames

        public java.util.Iterator<java.lang.String> getFieldNames()
        Description copied from class: JsonNode
        Method for accessing names of all fields for this Node, iff this node is a JSON Object node.
        Overrides:
        getFieldNames 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
      • path

        public JsonNode path​(java.lang.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
      • getFields

        public java.util.Iterator<java.util.Map.Entry<java.lang.String,​JsonNode>> getFields()
        Method to use for accessing all fields (with both names and values) of this JSON Object.
        Overrides:
        getFields in class JsonNode
        Returns:
        Iterator that can be used to traverse all key/value pairs for object nodes; empty iterator (no contents) for other types
      • with

        public ObjectNode with​(java.lang.String propertyName)
        Description copied from class: JsonNode
        Method that can be called on object nodes, to access a property that has object value; or if no such property exists, to create and return such object node. If node method is called on is not Object node, or if property exists and has value that is not object node, UnsupportedOperationException is thrown
        Overrides:
        with in class JsonNode
      • findValue

        public JsonNode findValue​(java.lang.String fieldName)
        Description copied from class: JsonNode
        Method for finding a JSON Object field with specified name in this node or its child nodes, and returning value it has. If no matching field is found in this node or its descendants, returns null.
        Specified by:
        findValue in class ContainerNode
        Parameters:
        fieldName - Name of field to look for
        Returns:
        Value of first matching node found, if any; null if none
      • findValuesAsText

        public java.util.List<java.lang.String> findValuesAsText​(java.lang.String fieldName,
                                                                 java.util.List<java.lang.String> foundSoFar)
        Specified by:
        findValuesAsText in class ContainerNode
      • findParent

        public ObjectNode findParent​(java.lang.String fieldName)
        Description copied from class: JsonNode
        Method for finding a JSON Object that contains specified field, within this node or its descendants. If no matching field is found in this node or its descendants, returns null.
        Specified by:
        findParent in class ContainerNode
        Parameters:
        fieldName - Name of field to look for
        Returns:
        Value of first matching node found, if any; null if none
      • put

        public JsonNode put​(java.lang.String fieldName,
                            JsonNode value)
        Method that will set specified field, replacing old value, if any.
        Parameters:
        value - to set field to; if null, will be converted to a NullNode first (to remove field entry, call remove(java.lang.String) instead)
        Returns:
        Old value of the field, if any; null if there was no old value.
      • remove

        public JsonNode remove​(java.lang.String fieldName)
        Method for removing field entry from this ObjectNode. Will return value of the field, if such field existed; null if not.
      • remove

        public ObjectNode remove​(java.util.Collection<java.lang.String> fieldNames)
        Method for removing specified field properties out of this ObjectNode.
        Parameters:
        fieldNames - Names of fields to remove
        Returns:
        This ObjectNode after removing entries
        Since:
        1.6
      • removeAll

        public ObjectNode removeAll()
        Method for removing all field properties, such that this ObjectNode will contain no properties after call.
        Specified by:
        removeAll in class ContainerNode
        Returns:
        Container node itself (to allow method call chaining)
      • putAll

        public JsonNode putAll​(java.util.Map<java.lang.String,​JsonNode> properties)
        Method for adding given properties to this object node, overriding any existing values for those properties.
        Parameters:
        properties - Properties to add
        Returns:
        This node (to allow chaining)
        Since:
        1.3
      • putAll

        public JsonNode putAll​(ObjectNode other)
        Method for adding all properties of the given Object, overriding any existing values for those properties.
        Parameters:
        other - Object of which properties to add to this object
        Returns:
        This node (to allow chaining)
        Since:
        1.3
      • retain

        public ObjectNode retain​(java.util.Collection<java.lang.String> fieldNames)
        Method for removing all field properties out of this ObjectNode except for ones specified in argument.
        Parameters:
        fieldNames - Fields to retain in this ObjectNode
        Returns:
        This ObjectNode (to allow call chaining)
        Since:
        1.6
      • retain

        public ObjectNode retain​(java.lang.String... fieldNames)
        Method for removing all field properties out of this ObjectNode except for ones specified in argument.
        Parameters:
        fieldNames - Fields to retain in this ObjectNode
        Returns:
        This ObjectNode (to allow call chaining)
        Since:
        1.6
      • putArray

        public ArrayNode putArray​(java.lang.String fieldName)
        Method that will construct an ArrayNode and add it as a field of this ObjectNode, replacing old value, if any.
        Returns:
        Newly constructed ArrayNode (NOT the old value, which could be of any type)
      • putObject

        public ObjectNode putObject​(java.lang.String fieldName)
        Method that will construct an ObjectNode and add it as a field of this ObjectNode, replacing old value, if any.
        Returns:
        Newly constructed ObjectNode (NOT the old value, which could be of any type)
      • putPOJO

        public void putPOJO​(java.lang.String fieldName,
                            java.lang.Object pojo)
      • putNull

        public void putNull​(java.lang.String fieldName)
      • put

        public void put​(java.lang.String fieldName,
                        int v)
        Method for setting value of a field to specified numeric value.
      • put

        public void put​(java.lang.String fieldName,
                        java.lang.Integer value)
        Alternative method that we need to avoid bumping into NPE issues with auto-unboxing.
        Since:
        1.9
      • put

        public void put​(java.lang.String fieldName,
                        long v)
        Method for setting value of a field to specified numeric value.
      • put

        public void put​(java.lang.String fieldName,
                        java.lang.Long value)
        Alternative method that we need to avoid bumping into NPE issues with auto-unboxing.
        Since:
        1.9
      • put

        public void put​(java.lang.String fieldName,
                        float v)
        Method for setting value of a field to specified numeric value.
      • put

        public void put​(java.lang.String fieldName,
                        java.lang.Float value)
        Alternative method that we need to avoid bumping into NPE issues with auto-unboxing.
        Since:
        1.9
      • put

        public void put​(java.lang.String fieldName,
                        double v)
        Method for setting value of a field to specified numeric value.
      • put

        public void put​(java.lang.String fieldName,
                        java.lang.Double value)
        Alternative method that we need to avoid bumping into NPE issues with auto-unboxing.
        Since:
        1.9
      • put

        public void put​(java.lang.String fieldName,
                        java.math.BigDecimal v)
        Method for setting value of a field to specified numeric value.
      • put

        public void put​(java.lang.String fieldName,
                        java.lang.String v)
        Method for setting value of a field to specified String value.
      • put

        public void put​(java.lang.String fieldName,
                        boolean v)
        Method for setting value of a field to specified String value.
      • put

        public void put​(java.lang.String fieldName,
                        java.lang.Boolean value)
        Alternative method that we need to avoid bumping into NPE issues with auto-unboxing.
        Since:
        1.9
      • put

        public void put​(java.lang.String fieldName,
                        byte[] v)
        Method for setting value of a field to specified binary value
      • putContentsTo

        protected void putContentsTo​(java.util.Map<java.lang.String,​JsonNode> dst)
        Since:
        1.6
      • equals

        public boolean equals​(java.lang.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
      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class java.lang.Object
      • toString

        public java.lang.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