Package com.fasterxml.jackson.databind.node

Class BigIntegerNode

java.lang.Object

com.fasterxml.jackson.databind.JsonSerializable.Base

com.fasterxml.jackson.databind.JsonNode

com.fasterxml.jackson.databind.node.BaseJsonNode

com.fasterxml.jackson.databind.node.ValueNode

com.fasterxml.jackson.databind.node.NumericNode

com.fasterxml.jackson.databind.node.BigIntegerNode

All Implemented Interfaces:

TreeNode, JsonSerializable, java.io.Serializable, java.lang.Iterable<JsonNode>

public class BigIntegerNode
extends NumericNode

Numeric node that contains simple 64-bit integer values.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.fasterxml.jackson.databind.JsonNode

JsonNode.OverwriteMode

Nested classes/interfaces inherited from interface com.fasterxml.jackson.databind.JsonSerializable

JsonSerializable.Base

Constructor Summary

Constructors

Constructor	Description
BigIntegerNode(java.math.BigInteger v)

Method Summary

Modifier and Type	Method	Description
boolean	asBoolean(boolean defaultValue)	Method that will try to convert value of this node to a Java boolean.
java.lang.String	asText()	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.
JsonToken	asToken()	Method that can be used for efficient type detection when using stream abstraction for traversing nodes.
java.math.BigInteger	bigIntegerValue()	Returns integer value for this node (as BigInteger), if and only if this node is numeric (JsonNode.isNumber() returns true).
boolean	canConvertToInt()	Method that can be used to check whether this node is a numeric node (JsonNode.isNumber() would return true) AND its value fits within Java's 32-bit signed integer type, int.
boolean	canConvertToLong()	Method that can be used to check whether this node is a numeric node (JsonNode.isNumber() would return true) AND its value fits within Java's 64-bit signed integer type, long.
java.math.BigDecimal	decimalValue()	Returns floating point value for this node (as BigDecimal), if and only if this node is numeric (JsonNode.isNumber() returns true).
double	doubleValue()	Returns 64-bit floating point (double) value for this node, if and only if this node is numeric (JsonNode.isNumber() returns true).
boolean	equals(java.lang.Object o)	Equality for node objects is defined as full (deep) value equality.
float	floatValue()	Returns 32-bit floating value for this node, if and only if this node is numeric (JsonNode.isNumber() returns true).
int	hashCode()
int	intValue()	Returns integer value for this node, if and only if this node is numeric (JsonNode.isNumber() returns true).
boolean	isBigInteger()
boolean	isIntegralNumber()
long	longValue()	Returns 64-bit long value for this node, if and only if this node is numeric (JsonNode.isNumber() returns true).
JsonParser.NumberType	numberType()	Returns code that identifies type of underlying numeric value, if (and only if) node is a number node.
java.lang.Number	numberValue()	Returns numeric value for this node, if and only if this node is numeric (JsonNode.isNumber() returns true); otherwise returns null
void	serialize(JsonGenerator g, SerializerProvider provider)	Method called to serialize node instances using given generator.
short	shortValue()	Returns 16-bit short value for this node, if and only if this node is numeric (JsonNode.isNumber() returns true).
static BigIntegerNode	valueOf(java.math.BigInteger v)

Methods inherited from class com.fasterxml.jackson.databind.node.NumericNode

asDouble, asDouble, asInt, asInt, asLong, asLong, getNodeType, isNaN

Methods inherited from class com.fasterxml.jackson.databind.node.ValueNode

deepCopy, findParent, findParents, findValue, findValues, findValuesAsText, get, get, has, has, hasNonNull, hasNonNull, isEmpty, path, path, serializeWithType

Methods inherited from class com.fasterxml.jackson.databind.node.BaseJsonNode

findPath, required, required, toPrettyString, toString, traverse, traverse, withArray, withObject

Methods inherited from class com.fasterxml.jackson.databind.JsonNode

asBoolean, asText, at, at, binaryValue, booleanValue, canConvertToExactIntegral, elements, equals, fieldNames, fields, findParents, findValues, findValuesAsText, isArray, isBigDecimal, isBinary, isBoolean, isContainerNode, isDouble, isFloat, isFloatingPointNumber, isInt, isLong, isMissingNode, isNull, isNumber, isObject, isPojo, isShort, isTextual, isValueNode, iterator, properties, require, requiredAt, requiredAt, requireNonNull, size, textValue, with, withArray, withArray, withArray, withArrayProperty, withObject, withObject, withObject, withObjectProperty

Methods inherited from class com.fasterxml.jackson.databind.JsonSerializable.Base

isEmpty

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

BigIntegerNode

public BigIntegerNode(java.math.BigInteger v)

Method Detail

valueOf

public static BigIntegerNode valueOf(java.math.BigInteger v)

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

numberType

public JsonParser.NumberType numberType()

Description copied from class: BaseJsonNode

Returns code that identifies type of underlying numeric value, if (and only if) node is a number node.

Specified by:

numberType in interface TreeNode

Specified by:

numberType in class NumericNode

Returns:

Type of number contained, if any; or null if node does not contain numeric value.

isIntegralNumber

public boolean isIntegralNumber()

Overrides:

isIntegralNumber in class JsonNode

Returns:

True if this node represents an integral (integer) numeric JSON value

isBigInteger

public boolean isBigInteger()

Overrides:

isBigInteger in class JsonNode

canConvertToInt

public boolean canConvertToInt()

Description copied from class: JsonNode

Method that can be used to check whether this node is a numeric node (JsonNode.isNumber() would return true) AND its value fits within Java's 32-bit signed integer type, int. Note that floating-point numbers are convertible if the integral part fits without overflow (as per standard Java coercion rules)

NOTE: this method does not consider possible value type conversion from JSON String into Number; so even if this method returns false, it is possible that JsonNode.asInt() could still succeed if node is a JSON String representing integral number, or boolean.

Specified by:

canConvertToInt in class NumericNode

canConvertToLong

public boolean canConvertToLong()

Description copied from class: JsonNode

Method that can be used to check whether this node is a numeric node (JsonNode.isNumber() would return true) AND its value fits within Java's 64-bit signed integer type, long. Note that floating-point numbers are convertible if the integral part fits without overflow (as per standard Java coercion rules)

NOTE: this method does not consider possible value type conversion from JSON String into Number; so even if this method returns false, it is possible that JsonNode.asLong() could still succeed if node is a JSON String representing integral number, or boolean.

Specified by:

canConvertToLong in class NumericNode

numberValue

public java.lang.Number numberValue()

Description copied from class: JsonNode

Returns numeric value for this node, if and only if this node is numeric (JsonNode.isNumber() returns true); otherwise returns null

Specified by:

numberValue in class NumericNode

Returns:

Number value this node contains, if any (null for non-number nodes).

shortValue

public short shortValue()

Description copied from class: JsonNode

Returns 16-bit short value for this node, if and only if this node is numeric (JsonNode.isNumber() returns true). For other types returns 0. For floating-point numbers, value is truncated using default Java coercion, similar to how cast from double to short operates.

Overrides:

shortValue in class JsonNode

Returns:

Short value this node contains, if any; 0 for non-number nodes.

intValue

public int intValue()

Description copied from class: JsonNode

Returns integer value for this node, if and only if this node is numeric (JsonNode.isNumber() returns true). For other types returns 0. For floating-point numbers, value is truncated using default Java coercion, similar to how cast from double to int operates.

Specified by:

intValue in class NumericNode

Returns:

Integer value this node contains, if any; 0 for non-number nodes.

longValue

public long longValue()

Description copied from class: JsonNode

Returns 64-bit long value for this node, if and only if this node is numeric (JsonNode.isNumber() returns true). For other types returns 0. For floating-point numbers, value is truncated using default Java coercion, similar to how cast from double to long operates.

Specified by:

longValue in class NumericNode

Returns:

Long value this node contains, if any; 0 for non-number nodes.

bigIntegerValue

public java.math.BigInteger bigIntegerValue()

Description copied from class: JsonNode

Returns integer value for this node (as BigInteger), if and only if this node is numeric (JsonNode.isNumber() returns true). For other types returns BigInteger.ZERO.

NOTE: In Jackson 2.x MAY throw StreamConstraintsException if the scale of the underlying BigDecimal is too large to convert (NOTE: thrown "sneakily" in Jackson 2.x due to API compatibility restrictions)

Specified by:

bigIntegerValue in class NumericNode

Returns:

BigInteger value this node contains, if numeric node; BigInteger.ZERO for non-number nodes.

floatValue

public float floatValue()

Description copied from class: JsonNode

Returns 32-bit floating value for this node, if and only if this node is numeric (JsonNode.isNumber() returns true). For other types returns 0.0. For integer values, conversion is done using coercion; this means that an overflow is possible for `long` values

Overrides:

floatValue in class JsonNode

Returns:

32-bit float value this node contains, if any; 0.0 for non-number nodes.

doubleValue

public double doubleValue()

Description copied from class: JsonNode

Returns 64-bit floating point (double) value for this node, if and only if this node is numeric (JsonNode.isNumber() returns true). For other types returns 0.0. For integer values, conversion is done using coercion; this may result in overflows with BigInteger values.

Specified by:

doubleValue in class NumericNode

Returns:

64-bit double value this node contains, if any; 0.0 for non-number nodes.

decimalValue

public java.math.BigDecimal decimalValue()

Description copied from class: JsonNode

Returns floating point value for this node (as BigDecimal), if and only if this node is numeric (JsonNode.isNumber() returns true). For other types returns BigDecimal.ZERO.

Specified by:

decimalValue in class NumericNode

Returns:

BigDecimal value this node contains, if numeric node; BigDecimal.ZERO for non-number nodes.

asText

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

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 cannot 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

serialize

public final void serialize(JsonGenerator g,
                            SerializerProvider provider)
                     throws java.io.IOException

Description copied from class: BaseJsonNode

Method called to serialize node instances using given generator.

Specified by:

serialize in interface JsonSerializable

Specified by:

serialize in class BaseJsonNode

Throws:

java.io.IOException

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()

Specified by:

hashCode in class BaseJsonNode