public class ObjectNode extends ContainerNode
Modifier and Type | Class and Description |
---|---|
protected static class |
ObjectNode.NoFieldsIterator
For efficiency, let's share the "no fields" iterator...
|
ContainerNode.NoNodesIterator, ContainerNode.NoStringsIterator
Modifier and Type | Field and Description |
---|---|
protected LinkedHashMap<String,JsonNode> |
_children |
NO_NODES, NO_STRINGS
Constructor and Description |
---|
ObjectNode(JsonNodeFactory nc) |
Modifier and Type | Method and Description |
---|---|
JsonToken |
asToken()
Method that can be used for efficient type detection
when using stream abstraction for traversing nodes.
|
boolean |
equals(Object o)
Equality for node objects is defined as full (deep) value
equality.
|
ObjectNode |
findParent(String fieldName)
Method for finding a JSON Object that contains specified field,
within this node or its descendants.
|
List<JsonNode> |
findParents(String fieldName,
List<JsonNode> foundSoFar) |
JsonNode |
findValue(String fieldName)
Method for finding a JSON Object field with specified name in this
node or its child nodes, and returning value it has.
|
List<JsonNode> |
findValues(String fieldName,
List<JsonNode> foundSoFar) |
List<String> |
findValuesAsText(String fieldName,
List<String> foundSoFar) |
JsonNode |
get(int index)
Method for accessing value of the specified element of
an array node.
|
JsonNode |
get(String fieldName)
Method for accessing value of the specified field of
an object node.
|
Iterator<JsonNode> |
getElements()
Method for accessing all value nodes of this Node, iff
this node is a JSON Array or Object node.
|
Iterator<String> |
getFieldNames()
Method for accessing names of all fields for this Node, iff
this node is a JSON Object node.
|
Iterator<Map.Entry<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(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(String fieldName,
BigDecimal v)
Method for setting value of a field to specified numeric value.
|
void |
put(String fieldName,
boolean v)
Method for setting value of a field to specified String value.
|
void |
put(String fieldName,
Boolean value)
Alternative method that we need to avoid bumping into NPE issues
with auto-unboxing.
|
void |
put(String fieldName,
byte[] v)
Method for setting value of a field to specified binary value
|
void |
put(String fieldName,
double v)
Method for setting value of a field to specified numeric value.
|
void |
put(String fieldName,
Double value)
Alternative method that we need to avoid bumping into NPE issues
with auto-unboxing.
|
void |
put(String fieldName,
float v)
Method for setting value of a field to specified numeric value.
|
void |
put(String fieldName,
Float value)
Alternative method that we need to avoid bumping into NPE issues
with auto-unboxing.
|
void |
put(String fieldName,
int v)
Method for setting value of a field to specified numeric value.
|
void |
put(String fieldName,
Integer value)
Alternative method that we need to avoid bumping into NPE issues
with auto-unboxing.
|
JsonNode |
put(String fieldName,
JsonNode value)
Method that will set specified field, replacing old value,
if any.
|
void |
put(String fieldName,
long v)
Method for setting value of a field to specified numeric value.
|
void |
put(String fieldName,
Long value)
Alternative method that we need to avoid bumping into NPE issues
with auto-unboxing.
|
void |
put(String fieldName,
String v)
Method for setting value of a field to specified String value.
|
JsonNode |
putAll(Map<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(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(Map<String,JsonNode> dst) |
void |
putNull(String fieldName) |
ObjectNode |
putObject(String fieldName)
Method that will construct an ObjectNode and add it as a
field of this ObjectNode, replacing old value, if any.
|
void |
putPOJO(String fieldName,
Object pojo) |
ObjectNode |
remove(Collection<String> fieldNames)
Method for removing specified field properties out of
this ObjectNode.
|
JsonNode |
remove(String fieldName)
Method for removing field entry from this ObjectNode.
|
ObjectNode |
removeAll()
Method for removing all field properties, such that this
ObjectNode will contain no properties after call.
|
ObjectNode |
retain(Collection<String> fieldNames)
Method for removing all field properties out of this ObjectNode
except for ones specified in argument.
|
ObjectNode |
retain(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.
|
String |
toString()
Note: marked as abstract to ensure all implementation
classes define it properly.
|
ObjectNode |
with(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.
|
arrayNode, asText, binaryNode, binaryNode, booleanNode, getValueAsText, isContainerNode, nullNode, numberNode, numberNode, numberNode, numberNode, numberNode, numberNode, numberNode, objectNode, POJONode, textNode
findPath, getNumberType, traverse
asBoolean, asBoolean, asDouble, asDouble, asInt, asInt, asLong, asLong, findParents, findValues, findValuesAsText, getBigIntegerValue, getBinaryValue, getBooleanValue, getDecimalValue, getDoubleValue, getIntValue, getLongValue, getNumberValue, getPath, getPath, getTextValue, getValueAsBoolean, getValueAsBoolean, getValueAsDouble, getValueAsDouble, getValueAsInt, getValueAsInt, getValueAsLong, getValueAsLong, has, has, isArray, isBigDecimal, isBigInteger, isBinary, isBoolean, isDouble, isFloatingPointNumber, isInt, isIntegralNumber, isLong, isMissingNode, isNull, isNumber, isPojo, isTextual, isValueNode, iterator
protected LinkedHashMap<String,JsonNode> _children
public ObjectNode(JsonNodeFactory nc)
public JsonToken asToken()
BaseJsonNode
JsonToken
that equivalent
stream event would produce (for most nodes there is just
one token but for structured/container types multiple)asToken
in class ContainerNode
public boolean isObject()
public int size()
JsonNode
size
in class ContainerNode
public Iterator<JsonNode> getElements()
JsonNode
getElements
in class JsonNode
public JsonNode get(int index)
JsonNode
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.
get
in class ContainerNode
public JsonNode get(String fieldName)
JsonNode
get
in class ContainerNode
public Iterator<String> getFieldNames()
JsonNode
getFieldNames
in class JsonNode
public JsonNode path(int index)
JsonNode
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.public JsonNode path(String fieldName)
JsonNode
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.public Iterator<Map.Entry<String,JsonNode>> getFields()
public ObjectNode with(String propertyName)
JsonNode
UnsupportedOperationException
is thrownpublic JsonNode findValue(String fieldName)
JsonNode
findValue
in class ContainerNode
fieldName
- Name of field to look forpublic List<JsonNode> findValues(String fieldName, List<JsonNode> foundSoFar)
findValues
in class ContainerNode
public List<String> findValuesAsText(String fieldName, List<String> foundSoFar)
findValuesAsText
in class ContainerNode
public ObjectNode findParent(String fieldName)
JsonNode
findParent
in class ContainerNode
fieldName
- Name of field to look forpublic List<JsonNode> findParents(String fieldName, List<JsonNode> foundSoFar)
findParents
in class ContainerNode
public final void serialize(JsonGenerator jg, SerializerProvider provider) throws IOException, JsonProcessingException
serialize
in interface JsonSerializable
serialize
in class BaseJsonNode
IOException
JsonProcessingException
public void serializeWithType(JsonGenerator jg, SerializerProvider provider, TypeSerializer typeSer) throws IOException, JsonProcessingException
BaseJsonNode
serializeWithType
in interface JsonSerializableWithType
serializeWithType
in class BaseJsonNode
IOException
JsonProcessingException
public JsonNode put(String fieldName, JsonNode value)
value
- to set field to; if null, will be converted
to a NullNode
first (to remove field entry, call
remove(java.lang.String)
instead)public JsonNode remove(String fieldName)
public ObjectNode remove(Collection<String> fieldNames)
fieldNames
- Names of fields to removepublic ObjectNode removeAll()
removeAll
in class ContainerNode
public JsonNode putAll(Map<String,JsonNode> properties)
properties
- Properties to addpublic JsonNode putAll(ObjectNode other)
other
- Object of which properties to add to this objectpublic ObjectNode retain(Collection<String> fieldNames)
fieldNames
- Fields to retain in this ObjectNodepublic ObjectNode retain(String... fieldNames)
fieldNames
- Fields to retain in this ObjectNodepublic ArrayNode putArray(String fieldName)
public ObjectNode putObject(String fieldName)
public void putNull(String fieldName)
public void put(String fieldName, int v)
public void put(String fieldName, Integer value)
public void put(String fieldName, long v)
public void put(String fieldName, Long value)
public void put(String fieldName, float v)
public void put(String fieldName, Float value)
public void put(String fieldName, double v)
public void put(String fieldName, Double value)
public void put(String fieldName, BigDecimal v)
public void put(String fieldName, String v)
public void put(String fieldName, boolean v)
public void put(String fieldName, Boolean value)
public void put(String fieldName, byte[] v)
public boolean equals(Object o)
JsonNode
Note: marked as abstract to ensure all implementation
classes define it properly and not rely on definition
from Object
.