LDValue (launchdarkly-java-server-sdk 4.13.0 API)

java.lang.Object
- com.launchdarkly.client.value.LDValue

```
public abstract class LDValue
extends java.lang.Object
```
An immutable instance of any data type that is allowed in JSON.
This is used with the client's LDClientInterface.jsonValueVariation(String, LDUser, LDValue) method, and is also used internally to hold feature flag values.
While the LaunchDarkly SDK uses Gson for JSON parsing, some of the Gson value types (object and array) are mutable. In contexts where it is important for data to remain immutable after it is created, these values are represented with LDValue instead. It is easily convertible to primitive types and provides array element/object property accessors.

Since:

4.8.0

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`LDValue.Convert` Predefined instances of `LDValue.Converter` for commonly used types.
`static class`	`LDValue.Converter<T>` Defines a conversion between `LDValue` and some other type.

Constructor Summary

Constructors
Constructor and Description

LDValue()

Constructors
Constructor and Description
`LDValue()`

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`com.google.gson.JsonElement`	`asJsonElement()` Deprecated. The Gson types may be removed from the public API at some point; it is preferable to use getters like `booleanValue()` and `getType()`.
`com.google.gson.JsonElement`	`asUnsafeJsonElement()` Deprecated. This method will be removed in a future version. Application code should always use `asJsonElement()`.
`boolean`	`booleanValue()` Returns this value as a boolean if it is explicitly a boolean.
`static ArrayBuilder`	`buildArray()` Starts building an array value.
`static ObjectBuilder`	`buildObject()` Starts building an object value.
`double`	`doubleValue()` Returns this value as a `double` if it is numeric.
`boolean`	`equals(java.lang.Object o)`
`float`	`floatValue()` Returns this value as a `float` if it is numeric.
`static LDValue`	`fromJsonElement(com.google.gson.JsonElement value)` Deprecated. The Gson types may be removed from the public API at some point; it is preferable to use factory methods like `of(boolean)`.
`LDValue`	`get(int index)` Returns an array element by index.
`LDValue`	`get(java.lang.String name)` Returns an object property by name.
`abstract LDValueType`	`getType()` Gets the JSON type for this value.
`int`	`hashCode()`
`int`	`intValue()` Returns this value as an `int` if it is numeric.
`boolean`	`isInt()` Tests whether this value is a number that is also an integer.
`boolean`	`isNull()` Tests whether this value is a null.
`boolean`	`isNumber()` Tests whether this value is a number (not a numeric string).
`boolean`	`isString()` Tests whether this value is a string.
`java.lang.Iterable<java.lang.String>`	`keys()` Enumerates the property names in an object.
`long`	`longValue()` Returns this value as a `long` if it is numeric.
`static LDValue`	`normalize(LDValue value)` Returns the same value if non-null, or `ofNull()` if null.
`static LDValue`	`of(boolean value)` Returns an instance for a boolean value.
`static LDValue`	`of(double value)` Returns an instance for a numeric value.
`static LDValue`	`of(float value)` Returns an instance for a numeric value.
`static LDValue`	`of(int value)` Returns an instance for a numeric value.
`static LDValue`	`of(long value)` Returns an instance for a numeric value.
`static LDValue`	`of(java.lang.String value)` Returns an instance for a string value (or a null).
`static LDValue`	`ofNull()` Returns an instance for a null value.
`int`	`size()` Returns the number of elements in an array or object.
`java.lang.String`	`stringValue()` Returns this value as a `String` if it is a string.
`java.lang.String`	`toJsonString()` Converts this value to its JSON serialization.
`java.lang.String`	`toString()`
`static LDValue`	`unsafeFromJsonElement(com.google.gson.JsonElement value)` Deprecated. This method will be removed in a future version. Application code should use `fromJsonElement(JsonElement)` or, preferably, factory methods like `of(boolean)`.
`java.lang.Iterable<LDValue>`	`values()` Enumerates the values in an array or object.
`<T> java.lang.Iterable<T>`	`valuesAs(LDValue.Converter<T> converter)` Enumerates the values in an array or object, converting them to a specific type.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - LDValue
```
public LDValue()
```
- Method Detail
  - normalize
```
public static LDValue normalize(LDValue value)
```
    Returns the same value if non-null, or ofNull() if null.
    
    Parameters:
    
    value - an LDValue or null
    
    Returns:
    
    an LDValue which will never be a null reference
  - ofNull
```
public static LDValue ofNull()
```
    Returns an instance for a null value. The same instance is always used.
    
    Returns:
    
    an LDValue containing null
  - of
```
public static LDValue of(boolean value)
```
    Returns an instance for a boolean value. The same instances for true and false are always used.
    
    Parameters:
    
    value - a boolean value
    
    Returns:
    
    an LDValue containing that value
  - of
```
public static LDValue of(int value)
```
    Returns an instance for a numeric value.
    
    Parameters:
    
    value - an integer numeric value
    
    Returns:
    
    an LDValue containing that value
  - of
```
public static LDValue of(long value)
```
    Returns an instance for a numeric value.
    Note that the LaunchDarkly service, and most of the SDKs, represent numeric values internally in 64-bit floating-point, which has slightly less precision than a signed 64-bit long; therefore, the full range of long values cannot be accurately represented. If you need to set a user attribute to a numeric value with more significant digits than will fit in a double, it is best to encode it as a string.
    
    Parameters:
    
    value - a long integer numeric value
    
    Returns:
    
    an LDValue containing that value
  - of
```
public static LDValue of(float value)
```
    Returns an instance for a numeric value.
    
    Parameters:
    
    value - a floating-point numeric value
    
    Returns:
    
    an LDValue containing that value
  - of
```
public static LDValue of(double value)
```
    Returns an instance for a numeric value.
    
    Parameters:
    
    value - a floating-point numeric value
    
    Returns:
    
    an LDValue containing that value
  - of
```
public static LDValue of(java.lang.String value)
```
    Returns an instance for a string value (or a null).
    
    Parameters:
    
    value - a nullable String reference
    
    Returns:
    
    an LDValue containing a string, or ofNull() if the value was null.
  - buildArray
```
public static ArrayBuilder buildArray()
```
    Starts building an array value.
```
     LDValue arrayOfInts = LDValue.buildArray().add(LDValue.int(1), LDValue.int(2)).build():
 
```
    If the values are all of the same type, you may also use LDValue.Converter.arrayFrom(Iterable) or LDValue.Converter.arrayOf(Object...).
    Returns:
    
    an ArrayBuilder
  - buildObject
```
public static ObjectBuilder buildObject()
```
    Starts building an object value.
```
     LDValue objectVal = LDValue.buildObject().put("key", LDValue.int(1)).build():
 
```
    If the values are all of the same type, you may also use LDValue.Converter.objectFrom(Map).
    Returns:
    
    an ObjectBuilder
  - fromJsonElement
```
@Deprecated
public static LDValue fromJsonElement(com.google.gson.JsonElement value)
```
    Deprecated. The Gson types may be removed from the public API at some point; it is preferable to use factory methods like of(boolean).
    
    Returns an instance based on a JsonElement value. If the value is a complex type, it is deep-copied; primitive types are used as is.
    
    Parameters:
    
    value - a nullable JsonElement reference
    
    Returns:
    
    an LDValue containing the specified value, or ofNull() if the value was null.
  - unsafeFromJsonElement
```
@Deprecated
public static LDValue unsafeFromJsonElement(com.google.gson.JsonElement value)
```
    Deprecated. This method will be removed in a future version. Application code should use fromJsonElement(JsonElement) or, preferably, factory methods like of(boolean).
    
    Returns an instance that wraps an existing JsonElement value without copying it. This method exists only to support deprecated SDK methods where a JsonElement is needed, to avoid the inefficiency of a deep-copy; application code should not use it, since it can break the immutability contract of LDValue.
    
    Parameters:
    
    value - a nullable JsonElement reference
    
    Returns:
    
    an LDValue containing the specified value, or ofNull() if the value was null.
  - getType
```
public abstract LDValueType getType()
```
    Gets the JSON type for this value.
    
    Returns:
    
    the appropriate LDValueType
  - isNull
```
public boolean isNull()
```
    Tests whether this value is a null.
    
    Returns:
    
    true if this is a null value
  - booleanValue
```
public boolean booleanValue()
```
    Returns this value as a boolean if it is explicitly a boolean. Otherwise returns false.
    
    Returns:
    
    a boolean
  - isNumber
```
public boolean isNumber()
```
    Tests whether this value is a number (not a numeric string).
    
    Returns:
    
    true if this is a numeric value
  - isInt
```
public boolean isInt()
```
    Tests whether this value is a number that is also an integer.
    JSON does not have separate types for integer and floating-point values; they are both just numbers. This method returns true if and only if the actual numeric value has no fractional component, so LDValue.of(2).isInt() and LDValue.of(2.0f).isInt() are both true.
    
    Returns:
    
    true if this is an integer value
  - intValue
```
public int intValue()
```
    Returns this value as an int if it is numeric. Returns zero for all non-numeric values.
    If the value is a number but not an integer, it will be rounded toward zero (truncated). This is consistent with Java casting behavior, and with most other LaunchDarkly SDKs.
    
    Returns:
    
    an int value
  - longValue
```
public long longValue()
```
    Returns this value as a long if it is numeric. Returns zero for all non-numeric values.
    If the value is a number but not an integer, it will be rounded toward zero (truncated). This is consistent with Java casting behavior, and with most other LaunchDarkly SDKs.
    
    Returns:
    
    a long value
  - floatValue
```
public float floatValue()
```
    Returns this value as a float if it is numeric. Returns zero for all non-numeric values.
    
    Returns:
    
    a float value
  - doubleValue
```
public double doubleValue()
```
    Returns this value as a double if it is numeric. Returns zero for all non-numeric values.
    
    Returns:
    
    a double value
  - isString
```
public boolean isString()
```
    Tests whether this value is a string.
    
    Returns:
    
    true if this is a string value
  - stringValue
```
public java.lang.String stringValue()
```
    Returns this value as a String if it is a string. Returns null for all non-string values.
    
    Returns:
    
    a nullable string value
  - size
```
public int size()
```
    Returns the number of elements in an array or object. Returns zero for all other types.
    
    Returns:
    
    the number of array elements or object properties
  - keys
```
public java.lang.Iterable<java.lang.String> keys()
```
    Enumerates the property names in an object. Returns an empty iterable for all other types.
    
    Returns:
    
    the property names
  - values
```
public java.lang.Iterable<LDValue> values()
```
    Enumerates the values in an array or object. Returns an empty iterable for all other types.
    
    Returns:
    
    an iterable of LDValue values
  - valuesAs
```
public <T> java.lang.Iterable<T> valuesAs(LDValue.Converter<T> converter)
```
    Enumerates the values in an array or object, converting them to a specific type. Returns an empty iterable for all other types.
    This is an efficient method because it does not copy values to a new list, but returns a view into the existing array.
    Example:
```
     LDValue anArrayOfInts = LDValue.Convert.Integer.arrayOf(1, 2, 3);
     for (int i: anArrayOfInts.valuesAs(LDValue.Convert.Integer)) { println(i); }
 
```
    Type Parameters:
    
    T - the desired type
    
    Parameters:
    
    converter - the LDValue.Converter for the specified type
    
    Returns:
    
    an iterable of values of the specified type
  - get
```
public LDValue get(int index)
```
    Returns an array element by index. Returns ofNull() if this is not an array or if the index is out of range (will never throw an exception).
    
    Parameters:
    
    index - the array index
    
    Returns:
    
    the element value or ofNull()
  - get
```
public LDValue get(java.lang.String name)
```
    Returns an object property by name. Returns ofNull() if this is not an object or if the key is not found (will never throw an exception).
    
    Parameters:
    
    name - the property name
    
    Returns:
    
    the property value or ofNull()
  - toJsonString
```
public java.lang.String toJsonString()
```
    Converts this value to its JSON serialization.
    
    Returns:
    
    a JSON string
  - asJsonElement
```
@Deprecated
public com.google.gson.JsonElement asJsonElement()
```
    Deprecated. The Gson types may be removed from the public API at some point; it is preferable to use getters like booleanValue() and getType().
    
    Converts this value to a JsonElement. If the value is a complex type, it is deep-copied deep-copied, so modifying the return value will not affect the LDValue.
    
    Returns:
    
    a JsonElement, or null if the value is a null
  - asUnsafeJsonElement
```
@Deprecated
public com.google.gson.JsonElement asUnsafeJsonElement()
```
    Deprecated. This method will be removed in a future version. Application code should always use asJsonElement().
    
    Returns the original JsonElement if the value was created from one, otherwise converts the value to a JsonElement. This method exists only to support deprecated SDK methods where a JsonElement is needed, to avoid the inefficiency of a deep-copy; application code should not use it, since it can break the immutability contract of LDValue.
    
    Returns:
    
    a JsonElement, or null if the value is a null
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - equals
```
public boolean equals(java.lang.Object o)
```
    Overrides:
    
    equals in class java.lang.Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class java.lang.Object

Class LDValue

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

LDValue

Method Detail

normalize

ofNull

of

of

of

of

of

of

buildArray

buildObject

fromJsonElement

unsafeFromJsonElement

getType

isNull

booleanValue

isNumber

isInt

intValue

longValue

floatValue

doubleValue

isString

stringValue

size

keys

values

valuesAs

get

get

toJsonString

asJsonElement

asUnsafeJsonElement

toString

equals

hashCode