Package javax.json
Interface JsonArray
-
- All Superinterfaces:
java.util.Collection<JsonValue>
,java.lang.Iterable<JsonValue>
,JsonStructure
,JsonValue
,java.util.List<JsonValue>
public interface JsonArray extends JsonStructure, java.util.List<JsonValue>
A JsonArray e.g.[1,5,8]
or[ {"name":"karl", "age": 38}, {"name":"sue", "age": 42}, ]
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface javax.json.JsonValue
JsonValue.ValueType
-
-
Field Summary
-
Fields inherited from interface javax.json.JsonValue
EMPTY_JSON_ARRAY, EMPTY_JSON_OBJECT, FALSE, NULL, TRUE
-
-
Method Summary
All Methods Instance Methods Abstract Methods Default Methods Modifier and Type Method Description boolean
getBoolean(int index)
boolean
getBoolean(int index, boolean defaultValue)
int
getInt(int index)
int
getInt(int index, int defaultValue)
JsonArray
getJsonArray(int index)
JsonNumber
getJsonNumber(int index)
JsonObject
getJsonObject(int index)
JsonString
getJsonString(int index)
java.lang.String
getString(int index)
java.lang.String
getString(int index, java.lang.String defaultValue)
<T extends JsonValue>
java.util.List<T>getValuesAs(java.lang.Class<T> clazz)
default <T,K extends JsonValue>
java.util.List<T>getValuesAs(java.util.function.Function<K,T> func)
Returns a list for the array.boolean
isNull(int index)
-
Methods inherited from interface javax.json.JsonStructure
getValue
-
Methods inherited from interface javax.json.JsonValue
asJsonArray, asJsonObject, getValueType, toString
-
Methods inherited from interface java.util.List
add, add, addAll, addAll, clear, contains, containsAll, equals, get, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, replaceAll, retainAll, set, size, sort, spliterator, subList, toArray, toArray
-
-
-
-
Method Detail
-
getJsonObject
JsonObject getJsonObject(int index)
- Returns:
- the JsonObject at the given position
- Throws:
java.lang.IndexOutOfBoundsException
- if the index is out of rangejava.lang.ClassCastException
- if the value at the specified position is not assignable to the JsonObject
-
getJsonArray
JsonArray getJsonArray(int index)
- Returns:
- the JsonArray at the given position
- Throws:
java.lang.IndexOutOfBoundsException
- if the index is out of rangejava.lang.ClassCastException
- if the value at the specified position is not assignable to the JsonArray
-
getJsonNumber
JsonNumber getJsonNumber(int index)
- Returns:
- the JsonNumber at the given position
- Throws:
java.lang.IndexOutOfBoundsException
- if the index is out of rangejava.lang.ClassCastException
- if the value at the specified position is not assignable to the JsonNumber
-
getJsonString
JsonString getJsonString(int index)
- Returns:
- the JsonString at the given position
- Throws:
java.lang.IndexOutOfBoundsException
- if the index is out of rangejava.lang.ClassCastException
- if the value at the specified position is not assignable to the JsonString
-
getValuesAs
<T extends JsonValue> java.util.List<T> getValuesAs(java.lang.Class<T> clazz)
- Returns:
- the respective JsonValue at the given position
- Throws:
java.lang.IndexOutOfBoundsException
- if the index is out of rangejava.lang.ClassCastException
- if the value at the specified position is not assignable to the given slazz
-
getValuesAs
default <T,K extends JsonValue> java.util.List<T> getValuesAs(java.util.function.Function<K,T> func)
Returns a list for the array. The value and the type of the elements in the list is specified by thefunc
argument.This method can be used to obtain a list of the unwrapped types, such as
It can also be used to obtain a list of simple projections, such asList<String> strings = ary1.getValuesAs(JsonString::getString); List<Integer> ints = ary2.getValuesAs(JsonNumber::intValue);
Lsit<Integer> stringsizes = arr.getValueAs((JsonString v) -> v.getString().length();
- Type Parameters:
K
- The element type (must be a subtype of JsonValue) of this JsonArray.T
- The element type of the returned List- Parameters:
func
- The function that maps the elements of this JsonArray to the target elements.- Returns:
- A List of the specified values and type.
- Throws:
java.lang.ClassCastException
- if theJsonArray
contains a value of wrong type
-
getString
java.lang.String getString(int index)
- Returns:
- the native String at the given position
- Throws:
java.lang.IndexOutOfBoundsException
- if the index is out of rangejava.lang.ClassCastException
- if the value at the specified position is not assignable to a String
-
getString
java.lang.String getString(int index, java.lang.String defaultValue)
- Returns:
- the native String at the given position or the defaultValue if null
- Throws:
java.lang.IndexOutOfBoundsException
- if the index is out of rangejava.lang.ClassCastException
- if the value at the specified position is not assignable to a String
-
getInt
int getInt(int index)
- Returns:
- the native int value at the given position
- Throws:
java.lang.IndexOutOfBoundsException
- if the index is out of rangejava.lang.ClassCastException
- if the value at the specified position is not assignable to an intjava.lang.NullPointerException
- if an object with the given name doesn't exist
-
getInt
int getInt(int index, int defaultValue)
- Returns:
- the native int value at the given position or the defaultValue if null
- Throws:
java.lang.IndexOutOfBoundsException
- if the index is out of rangejava.lang.ClassCastException
- if the value at the specified position is not assignable to an int
-
getBoolean
boolean getBoolean(int index)
- Returns:
- the native boolean value at the given position
- Throws:
java.lang.IndexOutOfBoundsException
- if the index is out of rangejava.lang.ClassCastException
- if the value at the specified position is not assignable to a booleanjava.lang.NullPointerException
- if an object with the given name doesn't exist
-
getBoolean
boolean getBoolean(int index, boolean defaultValue)
- Returns:
- the native boolean value at the given position or the defaultValue if null
- Throws:
java.lang.IndexOutOfBoundsException
- if the index is out of rangejava.lang.ClassCastException
- if the value at the specified position is not assignable to a boolean
-
isNull
boolean isNull(int index)
- Returns:
- whether the value at the given position is
JsonValue.NULL
. - Throws:
java.lang.IndexOutOfBoundsException
- if the index is out of range
-
-