public class ArrayNode extends ContainerNode<ArrayNode>
ContainerNode.NoNodesIterator, ContainerNode.NoStringsIterator
Modifier and Type | Field and Description |
---|---|
protected List<JsonNode> |
_children |
_nodeFactory
NO_NODES, NO_STRINGS
Modifier | Constructor and Description |
---|---|
|
ArrayNode(JsonNodeFactory nc) |
protected |
ArrayNode(JsonNodeFactory nc,
List<JsonNode> children) |
Modifier and Type | Method and Description |
---|---|
protected List<JsonNode> |
_createList()
Internal factory method for creating
Map used for storing
child nodes. |
protected List<JsonNode> |
_createList(int defaultSize)
Internal factory method for creating
Map used for storing
child nodes. |
protected boolean |
_customEquals(ArrayNode other)
Method that sub-classes should override, if equality comparison
needs additional verification beyond defaults.
|
protected ArrayNode |
_defaultDeepCopy()
Default implementation for 'deepCopy()': can be delegated to by sub-classes
if necessary; but usually isn't.
|
protected boolean |
_equals(ArrayNode other)
Method that sub-classes should override, if equality comparison
needs additional verification beyond defaults.
|
JsonNode |
_set(int index,
JsonNode value) |
protected boolean |
_stdEquals(ArrayNode other)
Standard equality check, which may also be overridden by
sub-classes if necessary (but usually isn't).
|
ArrayNode |
add(BigDecimal v)
Method for adding specified number at the end of this array.
|
ArrayNode |
add(boolean v)
Method for adding specified boolean value at the end of this array.
|
ArrayNode |
add(Boolean value)
Alternative method that we need to avoid bumping into NPE issues
with auto-unboxing.
|
ArrayNode |
add(byte[] v)
Method for adding specified binary value at the end of this array
(note: when serializing as JSON, will be output Base64 encoded)
|
ArrayNode |
add(double v)
Method for adding specified number at the end of this array.
|
ArrayNode |
add(Double value)
Alternative method that we need to avoid bumping into NPE issues
with auto-unboxing.
|
ArrayNode |
add(float v)
Method for adding specified number at the end of this array.
|
ArrayNode |
add(Float value)
Alternative method that we need to avoid bumping into NPE issues
with auto-unboxing.
|
ArrayNode |
add(int v)
Method for adding specified number at the end of this array.
|
ArrayNode |
add(Integer value)
Alternative method that we need to avoid bumping into NPE issues
with auto-unboxing.
|
ArrayNode |
add(JsonNode value)
Method for adding specified node at the end of this array.
|
ArrayNode |
add(long v)
Method for adding specified number at the end of this array.
|
ArrayNode |
add(Long value)
Alternative method that we need to avoid bumping into NPE issues
with auto-unboxing.
|
ArrayNode |
add(String v)
Method for adding specified String value at the end of this array.
|
ArrayNode |
addAll(ArrayNode other)
Method for adding all child nodes of given Array, appending to
child nodes this array contains
|
ArrayNode |
addAll(Collection<JsonNode> nodes)
Method for adding given nodes as child nodes of this array node.
|
ArrayNode |
addArray()
Method that will construct an ArrayNode and add it as a
field of this ObjectNode, replacing old value, if any.
|
protected void |
addContentsTo(List<JsonNode> dst) |
ArrayNode |
addNull()
Method that will add a null value at the end of this array node.
|
ObjectNode |
addObject()
Method that will construct an ObjectNode and add it at the end
of this array node.
|
ArrayNode |
addPOJO(Object value)
Method that will construct a POJONode and add it at the end
of this array node.
|
JsonToken |
asToken()
Method that can be used for efficient type detection
when using stream abstraction for traversing nodes.
|
ArrayNode |
deepCopy()
Method that can be called to get a node that is guaranteed
not to allow changing of this node through mutators on
this node or any of its children.
|
Iterator<JsonNode> |
elements()
Method for accessing all value nodes of this Node, iff
this node is a JSON Array or Object node.
|
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.
|
int |
hashCode() |
ArrayNode |
insert(int index,
BigDecimal v)
Method that will insert specified numeric value
at specified position in this array.
|
ArrayNode |
insert(int index,
boolean v)
Method that will insert specified String
at specified position in this array.
|
ArrayNode |
insert(int index,
Boolean value)
Alternative method that we need to avoid bumping into NPE issues
with auto-unboxing.
|
ArrayNode |
insert(int index,
byte[] v)
Method that will insert specified binary value
at specified position in this array
(note: when written as JSON, will be Base64 encoded)
|
ArrayNode |
insert(int index,
double v)
Method that will insert specified numeric value
at specified position in this array.
|
ArrayNode |
insert(int index,
Double value)
Alternative method that we need to avoid bumping into NPE issues
with auto-unboxing.
|
ArrayNode |
insert(int index,
float v)
Method that will insert specified numeric value
at specified position in this array.
|
ArrayNode |
insert(int index,
Float value)
Alternative method that we need to avoid bumping into NPE issues
with auto-unboxing.
|
ArrayNode |
insert(int index,
int v)
Method that will insert specified numeric value
at specified position in this array.
|
ArrayNode |
insert(int index,
Integer value)
Alternative method that we need to avoid bumping into NPE issues
with auto-unboxing.
|
ArrayNode |
insert(int index,
JsonNode value)
Method for inserting specified child node as an element
of this Array.
|
ArrayNode |
insert(int index,
long v)
Method that will insert specified numeric value
at specified position in this array.
|
ArrayNode |
insert(int index,
Long value)
Alternative method that we need to avoid bumping into NPE issues
with auto-unboxing.
|
ArrayNode |
insert(int index,
String v)
Method that will insert specified String
at specified position in this array.
|
ArrayNode |
insertArray(int index)
Method for creating an array node, inserting it at the
specified point in the array,
and returning the newly created array
(note: NOT 'this' array)
|
ArrayNode |
insertNull(int index)
Method that will insert a null value
at specified position in this array.
|
ObjectNode |
insertObject(int index)
Method for creating an
ObjectNode , appending it at the end
of this array, and returning the newly created node
(note: NOT 'this' array) |
ArrayNode |
insertPOJO(int index,
Object value)
Method that will construct a POJONode and
insert it at specified position in this array.
|
boolean |
isArray() |
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. |
JsonNode |
remove(int index)
Method for removing an entry from this ArrayNode.
|
ArrayNode |
removeAll()
Method for removing all elements of this array, leaving the
array empty.
|
void |
serialize(JsonGenerator jg,
SerializerProvider provider)
Method called to serialize node instances using given 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.
|
JsonNode |
set(int index,
JsonNode value)
Method that will set specified field, replacing old value,
if any.
|
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.
|
arrayNode, asText, binaryNode, binaryNode, booleanNode, isContainerNode, nullNode, numberNode, numberNode, numberNode, numberNode, numberNode, numberNode, numberNode, objectNode, POJONode, textNode
findPath, numberType, traverse
asBoolean, asBoolean, asDouble, asDouble, asInt, asInt, asLong, asLong, bigIntegerValue, binaryValue, booleanValue, canConvertToInt, canConvertToLong, decimalValue, doubleValue, fieldNames, fields, findParents, findValues, findValuesAsText, has, has, hasNonNull, hasNonNull, intValue, isBigDecimal, isBigInteger, isBinary, isBoolean, isDouble, isFloatingPointNumber, isInt, isIntegralNumber, isLong, isMissingNode, isNull, isNumber, isObject, isPojo, isTextual, isValueNode, iterator, longValue, numberValue, textValue, with, withArray
public ArrayNode(JsonNodeFactory nc)
protected ArrayNode(JsonNodeFactory nc, List<JsonNode> children)
public ArrayNode deepCopy()
JsonNode
Note: return type is guaranteed to have same type as the node method is called on; which is why method is declared with local generic type.
protected ArrayNode _defaultDeepCopy()
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 interface TreeNode
asToken
in class ContainerNode<ArrayNode>
public boolean isArray()
public int size()
JsonNode
size
in class ContainerNode<ArrayNode>
public Iterator<JsonNode> elements()
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.
NOTE: if the element value has been explicitly set as null
(which is different from removal!),
a NullNode
will be returned,
not null.
get
in class ContainerNode<ArrayNode>
public JsonNode get(String fieldName)
JsonNode
NOTE: if the property value has been explicitly set as null
(which is different from removal!),
a NullNode
will be returned,
not null.
get
in class ContainerNode<ArrayNode>
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 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 final void serialize(JsonGenerator jg, SerializerProvider provider) throws IOException, JsonProcessingException
BaseJsonNode
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 JsonSerializable
serializeWithType
in class BaseJsonNode
IOException
JsonProcessingException
public JsonNode findValue(String fieldName)
JsonNode
findValue
in class ContainerNode<ArrayNode>
fieldName
- Name of field to look forpublic List<JsonNode> findValues(String fieldName, List<JsonNode> foundSoFar)
findValues
in class ContainerNode<ArrayNode>
public List<String> findValuesAsText(String fieldName, List<String> foundSoFar)
findValuesAsText
in class ContainerNode<ArrayNode>
public ObjectNode findParent(String fieldName)
JsonNode
findParent
in class ContainerNode<ArrayNode>
fieldName
- Name of field to look forpublic List<JsonNode> findParents(String fieldName, List<JsonNode> foundSoFar)
findParents
in class ContainerNode<ArrayNode>
public JsonNode set(int index, JsonNode value)
value
- to set field to; if null, will be converted
to a NullNode
first (to remove field entry, call
remove(int)
instead)public ArrayNode add(JsonNode value)
public ArrayNode addAll(ArrayNode other)
other
- Array to add contents frompublic ArrayNode addAll(Collection<JsonNode> nodes)
nodes
- Nodes to addpublic ArrayNode insert(int index, JsonNode value)
public JsonNode remove(int index)
public ArrayNode removeAll()
removeAll
in class ContainerNode<ArrayNode>
public ArrayNode addArray()
public ObjectNode addObject()
public ArrayNode addPOJO(Object value)
public ArrayNode addNull()
public ArrayNode add(int v)
public ArrayNode add(Integer value)
public ArrayNode add(long v)
public ArrayNode add(Long value)
public ArrayNode add(float v)
public ArrayNode add(Float value)
public ArrayNode add(double v)
public ArrayNode add(Double value)
public ArrayNode add(BigDecimal v)
public ArrayNode add(String v)
public ArrayNode add(boolean v)
public ArrayNode add(Boolean value)
public ArrayNode add(byte[] v)
public ArrayNode insertArray(int index)
public ObjectNode insertObject(int index)
ObjectNode
, appending it at the end
of this array, and returning the newly created node
(note: NOT 'this' array)public ArrayNode insertPOJO(int index, Object value)
public ArrayNode insertNull(int index)
public ArrayNode insert(int index, int v)
public ArrayNode insert(int index, Integer value)
public ArrayNode insert(int index, long v)
public ArrayNode insert(int index, Long value)
public ArrayNode insert(int index, float v)
public ArrayNode insert(int index, Float value)
public ArrayNode insert(int index, double v)
public ArrayNode insert(int index, Double value)
public ArrayNode insert(int index, BigDecimal v)
public ArrayNode insert(int index, String v)
public ArrayNode insert(int index, boolean v)
public ArrayNode insert(int index, Boolean value)
public ArrayNode insert(int index, byte[] v)
protected List<JsonNode> _createList()
Map
used for storing
child nodes.
Overridable by sub-classes, used when caller does not know what
optimal size would, used for example when constructing a Map when adding
the first one.protected List<JsonNode> _createList(int defaultSize)
Map
used for storing
child nodes.
Overridable by sub-classes, used when caller has an idea of what
optimal size should be: used when copying contents of an existing node.public final boolean equals(Object o)
JsonNode
Note: marked as abstract to ensure all implementation
classes define it properly and not rely on definition
from Object
.
protected boolean _equals(ArrayNode other)
protected boolean _customEquals(ArrayNode other)
protected final boolean _stdEquals(ArrayNode other)
public String toString()
JsonNode
Note: marked as abstract to ensure all implementation classes define it properly.
Copyright © 2012-2013 FasterXML. All Rights Reserved.