JsonArray (Couchbase Java SDK)

java.lang.Object
- com.couchbase.client.java.document.json.JsonValue
- - com.couchbase.client.java.document.json.JsonArray

All Implemented Interfaces:

Serializable, Iterable<Object>
```
public class JsonArray
extends JsonValue
implements Iterable<Object>, Serializable
```
Represents a JSON array that can be stored and loaded from Couchbase Server.
If boxed return values are unboxed, the calling code needs to make sure to handle potential NullPointerExceptions.
The JsonArray is backed by a List and is intended to work similar to it API wise, but to only allow to store such objects which can be represented by JSON.

Since:

2.0

Author:

Michael Nitschinger, Simon Baslé

See Also:

Serialized Form

Field Summary
- Fields inherited from class com.couchbase.client.java.document.json.JsonValue
  NULL

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`JsonArray`	`add(boolean value)` Append an `Boolean` element to the `JsonArray`.
`JsonArray`	`add(double value)` Append an `Double` element to the `JsonArray`.
`JsonArray`	`add(int value)` Append an `Integer` element to the `JsonArray`.
`JsonArray`	`add(JsonArray value)` Append an `JsonArray` element to the `JsonArray`.
`JsonArray`	`add(JsonObject value)` Append an `JsonObject` element to the `JsonArray`.
`JsonArray`	`add(List<?> value)` Append an `JsonArray` element, converted from a `List`, to the `JsonArray`.
`JsonArray`	`add(long value)` Append an `Long` element to the `JsonArray`.
`JsonArray`	`add(Map<String,?> value)` Append an `JsonObject` element, converted from a `List`, to the `JsonArray`.
`JsonArray`	`add(Object value)` Append an element to the `JsonArray`.
`JsonArray`	`add(String value)` Append an `String` element to the `JsonArray`.
`JsonArray`	`addNull()` Append a null element to the `JsonArray`.
`static JsonArray`	`create()` Creates a empty `JsonArray`.
`static JsonArray`	`empty()` Creates a empty `JsonArray`.
`boolean`	`equals(Object o)`
`static JsonArray`	`from(List<?> items)` Creates a new `JsonArray` and populates it with the values in the supplied `List`.
`static JsonArray`	`from(Object... items)` Creates a new `JsonArray` and populates it with the values supplied.
`static JsonArray`	`fromJson(String s)` Static method to create a `JsonArray` from a JSON `String`.
`Object`	`get(int index)` Retrieves the value by the position in the `JsonArray` and does not cast it.
`JsonArray`	`getArray(int index)` Retrieves the value by the position in the `JsonArray` and casts it to `JsonArray`.
`boolean`	`getBoolean(int index)` Retrieves the value by the position in the `JsonArray` and casts it to `Boolean`.
`Double`	`getDouble(int index)` Retrieves the value by the position in the `JsonArray` and casts it to `Double`.
`Integer`	`getInt(int index)` Retrieves the value by the position in the `JsonArray` and casts it to `Integer`.
`Long`	`getLong(int index)` Retrieves the value by the position in the `JsonArray` and casts it to `Long`.
`JsonObject`	`getObject(int index)` Retrieves the value by the position in the `JsonArray` and casts it to `JsonObject`.
`String`	`getString(int index)` Retrieves the value by the position in the `JsonArray` and casts it to `String`.
`int`	`hashCode()`
`boolean`	`isEmpty()` Checks if the `JsonArray` is empty or not.
`Iterator<Object>`	`iterator()`
`int`	`size()` Returns the size of the `JsonArray`.
`List<Object>`	`toList()` Copies the content of the `JsonArray` into a new `List` and returns it.
`String`	`toString()` Converts the `JsonArray` into its JSON string representation.

Methods inherited from class com.couchbase.client.java.document.json.JsonValue
checkType, ja, jo

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

Methods inherited from interface java.lang.Iterable
forEach, spliterator

- Method Detail
  - empty
```
public static JsonArray empty()
```
    Creates a empty JsonArray.
    
    Returns:
    
    a empty JsonArray.
  - create
```
public static JsonArray create()
```
    Creates a empty JsonArray.
    
    Returns:
    
    a empty JsonArray.
  - from
```
public static JsonArray from(Object... items)
```
    Creates a new JsonArray and populates it with the values supplied.
    If the type is not supported, a IllegalArgumentException exception is thrown.
    
    Parameters:
    
    items - the items to be stored in the JsonArray.
    
    Returns:
    
    a populated JsonArray.
  - from
```
public static JsonArray from(List<?> items)
```
    Creates a new JsonArray and populates it with the values in the supplied List.
    If the type of an item is not supported, an IllegalArgumentException is thrown. If the list is null, a NullPointerException is thrown, but null items are supported.
    Sub Maps and Lists If possible, Maps and Lists contained in items will be converted to JsonObject and JsonArray respectively. However, same restrictions apply. Any non-convertible collection will raise a ClassCastException. If the sub-conversion raises an exception (like an IllegalArgumentException) then it is put as cause for the ClassCastException.
    
    Parameters:
    
    items - the list of items to be stored in the JsonArray.
    
    Returns:
    
    a populated JsonArray.
    
    Throws:
    
    IllegalArgumentException - if at least one item is of unsupported type.
    
    NullPointerException - if the list of items is null.
  - fromJson
```
public static JsonArray fromJson(String s)
```
    Static method to create a JsonArray from a JSON String.
    Not to be confused with from(Object...) from(aString)} which will populate a new array with the string.
    The string is expected to be a valid JSON array representation (eg. starting with a ‘[’).
    
    Parameters:
    
    s - the JSON String to convert to a JsonArray.
    
    Returns:
    
    the corresponding JsonArray.
    
    Throws:
    
    IllegalArgumentException - if the conversion cannot be done.
  - get
```
public Object get(int index)
```
    Retrieves the value by the position in the JsonArray and does not cast it.
    
    Parameters:
    
    index - the index of the value.
    
    Returns:
    
    the value at index.
    
    Throws:
    
    IndexOutOfBoundsException - if the index is negative or too large.
  - add
```
public JsonArray add(Object value)
```
    Append an element to the JsonArray.
    Note that the type is checked and a IllegalArgumentException is thrown if not supported.
    
    Parameters:
    
    value - the value to append.
    
    Returns:
    
    the JsonArray.
  - addNull
```
public JsonArray addNull()
```
    Append a null element to the JsonArray.
    This is equivalent to calling add(Object) with null or JsonValue.NULL.
    
    Returns:
    
    the JsonArray.
  - add
```
public JsonArray add(String value)
```
    Append an String element to the JsonArray.
    
    Parameters:
    
    value - the value to append.
    
    Returns:
    
    the JsonArray.
  - getString
```
public String getString(int index)
```
    Retrieves the value by the position in the JsonArray and casts it to String.
    
    Parameters:
    
    index - the index of the value.
    
    Returns:
    
    the value at index.
    
    Throws:
    
    IndexOutOfBoundsException - if the index is negative or too large.
  - add
```
public JsonArray add(long value)
```
    Append an Long element to the JsonArray.
    
    Parameters:
    
    value - the value to append.
    
    Returns:
    
    the JsonArray.
  - getLong
```
public Long getLong(int index)
```
    Retrieves the value by the position in the JsonArray and casts it to Long.
    Note that if value was stored as another numerical type, some truncation or rounding may occur.
    
    Parameters:
    
    index - the index of the value.
    
    Returns:
    
    the value at index.
    
    Throws:
    
    IndexOutOfBoundsException - if the index is negative or too large.
  - add
```
public JsonArray add(int value)
```
    Append an Integer element to the JsonArray.
    
    Parameters:
    
    value - the value to append.
    
    Returns:
    
    the JsonArray.
  - getInt
```
public Integer getInt(int index)
```
    Retrieves the value by the position in the JsonArray and casts it to Integer.
    Note that if value was stored as another numerical type, some truncation or rounding may occur.
    
    Parameters:
    
    index - the index of the value.
    
    Returns:
    
    the value at index.
    
    Throws:
    
    IndexOutOfBoundsException - if the index is negative or too large.
  - add
```
public JsonArray add(double value)
```
    Append an Double element to the JsonArray.
    
    Parameters:
    
    value - the value to append.
    
    Returns:
    
    the JsonArray.
  - getDouble
```
public Double getDouble(int index)
```
    Retrieves the value by the position in the JsonArray and casts it to Double.
    Note that if value was stored as another numerical type, some truncation or rounding may occur.
    
    Parameters:
    
    index - the index of the value.
    
    Returns:
    
    the value at index.
    
    Throws:
    
    IndexOutOfBoundsException - if the index is negative or too large.
  - add
```
public JsonArray add(boolean value)
```
    Append an Boolean element to the JsonArray.
    
    Parameters:
    
    value - the value to append.
    
    Returns:
    
    the JsonArray.
  - getBoolean
```
public boolean getBoolean(int index)
```
    Retrieves the value by the position in the JsonArray and casts it to Boolean.
    
    Parameters:
    
    index - the index of the value.
    
    Returns:
    
    the value at index.
    
    Throws:
    
    IndexOutOfBoundsException - if the index is negative or too large.
  - add
```
public JsonArray add(JsonObject value)
```
    Append an JsonObject element to the JsonArray.
    
    Parameters:
    
    value - the value to append.
    
    Returns:
    
    the JsonArray.
  - add
```
public JsonArray add(Map<String,?> value)
```
    Append an JsonObject element, converted from a List, to the JsonArray.
    
    Parameters:
    
    value - the value to append.
    
    Returns:
    
    the JsonArray.
    
    See Also:
    
    JsonObject.from(Map)
  - getObject
```
public JsonObject getObject(int index)
```
    Retrieves the value by the position in the JsonArray and casts it to JsonObject.
    
    Parameters:
    
    index - the index of the value.
    
    Returns:
    
    the value at index.
    
    Throws:
    
    IndexOutOfBoundsException - if the index is negative or too large.
  - add
```
public JsonArray add(JsonArray value)
```
    Append an JsonArray element to the JsonArray.
    
    Parameters:
    
    value - the value to append.
    
    Returns:
    
    the JsonArray.
  - add
```
public JsonArray add(List<?> value)
```
    Append an JsonArray element, converted from a List, to the JsonArray.
    
    Parameters:
    
    value - the value to append.
    
    Returns:
    
    the JsonArray.
    
    See Also:
    
    from(List)
  - getArray
```
public JsonArray getArray(int index)
```
    Retrieves the value by the position in the JsonArray and casts it to JsonArray.
    
    Parameters:
    
    index - the index of the value.
    
    Returns:
    
    the value at index.
    
    Throws:
    
    IndexOutOfBoundsException - if the index is negative or too large.
  - toList
```
public List<Object> toList()
```
    Copies the content of the JsonArray into a new List and returns it. Note that if the array contains sub-JsonObject or JsonArray, they will recursively be converted to Map and List, respectively.
    
    Returns:
    
    the content of the JsonArray in a new List.
  - isEmpty
```
public boolean isEmpty()
```
    Checks if the JsonArray is empty or not.
    
    Returns:
    
    true if it is, false otherwise.
  - size
```
public int size()
```
    Returns the size of the JsonArray.
    
    Returns:
    
    the size.
  - iterator
```
public Iterator<Object> iterator()
```
    Specified by:
    
    iterator in interface Iterable<Object>
  - toString
```
public String toString()
```
    Converts the JsonArray into its JSON string representation.
    
    Overrides:
    
    toString in class Object
    
    Returns:
    
    the JSON string representing this JsonArray.
  - equals
```
public boolean equals(Object o)
```
    Overrides:
    
    equals in class Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object

Class JsonArray

Field Summary

Fields inherited from class com.couchbase.client.java.document.json.JsonValue

Method Summary

Methods inherited from class com.couchbase.client.java.document.json.JsonValue

Methods inherited from class java.lang.Object

Methods inherited from interface java.lang.Iterable

Method Detail

empty

create

from

from

fromJson

get

add

addNull

add

getString

add

getLong

add

getInt

add

getDouble

add

getBoolean

add

add

getObject

add

add

getArray

toList

isEmpty

size

iterator

toString

equals

hashCode