JSONArray

java.lang.Object
- java.util.AbstractCollection<E>
- - java.util.AbstractList<E>
  - - java.util.ArrayList<java.lang.Object>
    - - com.alibaba.fastjson2.JSONArray

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, java.lang.Iterable<java.lang.Object>, java.util.Collection<java.lang.Object>, java.util.List<java.lang.Object>, java.util.RandomAccess
```
public class JSONArray
extends java.util.ArrayList<java.lang.Object>
```
See Also:

Serialized Form

Field Summary

Fields
Modifier and Type Field and Description

(package private) static ObjectWriter<JSONArray> arrayWriter

private static long serialVersionUID
- Fields inherited from class java.util.AbstractList
  modCount

Fields
Modifier and Type	Field and Description
`(package private) static ObjectWriter<JSONArray>`	`arrayWriter`
`private static long`	`serialVersionUID`

Constructor Summary

Constructors
Constructor and Description

JSONArray()
default

JSONArray(java.util.Collection<?> collection)

JSONArray(int initialCapacity)

JSONArray(java.lang.Object... items)

Constructors
Constructor and Description
`JSONArray()` default
`JSONArray(java.util.Collection<?> collection)`
`JSONArray(int initialCapacity)`
`JSONArray(java.lang.Object... items)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`JSONArray`	`addArray()` Adds a new `JSONArray` to the end of this `JSONArray`.
`JSONObject`	`addObject()` Adds a new `JSONObject` to the end of this `JSONArray`.
`java.lang.Object`	`clone()` Creates and returns a copy of this `JSONArray`.
`static JSONArray`	`copyOf(java.util.Collection collection)` Returns an `JSONArray` containing the elements of the given Collection, in its iteration order.
`JSONArray`	`fluentAdd(java.lang.Object element)` Chained addition of elements
`JSONArray`	`fluentAddAll(java.util.Collection<?> c)` Chained add operation that appends all of the elements in the specified collection to the end of this list.
`JSONArray`	`fluentClear()` Chained clear operation that removes all elements from this `JSONArray`.
`JSONArray`	`fluentRemove(int index)` Chained remove operation that removes the element at the specified position.
`JSONArray`	`fluentRemove(java.lang.Object o)` Chained remove operation that removes the first occurrence of the specified element.
`JSONArray`	`fluentRemoveAll(java.util.Collection<?> c)` Chained remove operation that removes from this list all of its elements that are contained in the specified collection.
`JSONArray`	`fluentSet(int index, java.lang.Object element)` Chained set operation that replaces the element at the specified position.
`static JSONArray`	`from(java.lang.Object obj)` See `JSON.toJSON(java.lang.Object)` for details
`static JSONArray`	`from(java.lang.Object obj, JSONWriter.Feature... writeFeatures)` See `JSON.toJSON(java.lang.Object)` for details
`java.math.BigDecimal`	`getBigDecimal(int index)` Returns the `BigDecimal` at the specified location in this `JSONArray`.
`java.math.BigInteger`	`getBigInteger(int index)` Returns the `BigInteger` at the specified location in this `JSONArray`.
`java.lang.Boolean`	`getBoolean(int index)` Returns the `Boolean` at the specified location in this `JSONArray`.
`boolean`	`getBooleanValue(int index)` Returns a boolean value at the specified location in this `JSONArray`.
`java.lang.Byte`	`getByte(int index)` Returns the `Byte` at the specified location in this `JSONArray`.
`byte`	`getByteValue(int index)` Returns a byte value at the specified location in this `JSONArray`.
`java.util.Date`	`getDate(int index)` Returns the `Date` at the specified location in this `JSONArray`.
`java.util.Date`	`getDate(int index, java.util.Date defaultValue)` Returns the `Date` at the specified location in this `JSONArray`.
`java.lang.Double`	`getDouble(int index)` Returns the `Double` at the specified location in this `JSONArray`.
`double`	`getDoubleValue(int index)` Returns a double value at the specified location in this `JSONArray`.
`java.lang.Float`	`getFloat(int index)` Returns the `Float` at the specified location in this `JSONArray`.
`float`	`getFloatValue(int index)` Returns a float value at the specified location in this `JSONArray`.
`java.time.Instant`	`getInstant(int index)` Returns the `Instant` at the specified location in this `JSONArray`.
`java.lang.Integer`	`getInteger(int index)` Returns the `Integer` at the specified location in this `JSONArray`.
`int`	`getIntValue(int index)` Returns an int value at the specified location in this `JSONArray`.
`JSONArray`	`getJSONArray(int index)` Returns the `JSONArray` at the specified location in this `JSONArray`.
`JSONObject`	`getJSONObject(int index)` Returns the `JSONObject` at the specified location in this `JSONArray`.
`java.time.LocalDate`	`getLocalDate(int index)` Returns the `LocalDate` at the specified location in this `JSONArray`.
`java.time.LocalDate`	`getLocalDate(int index, java.time.LocalDate defaultValue)` Returns the `LocalDate` at the specified location in this `JSONArray`.
`java.time.LocalDateTime`	`getLocalDateTime(int index)` Returns the `LocalDateTime` at the specified location in this `JSONArray`.
`java.time.LocalDateTime`	`getLocalDateTime(int index, java.time.LocalDateTime defaultValue)` Returns the `LocalDateTime` at the specified location in this `JSONArray`.
`java.time.LocalTime`	`getLocalTime(int index)` Returns the `LocalTime` at the specified location in this `JSONArray`.
`java.time.LocalTime`	`getLocalTime(int index, java.time.LocalTime defaultValue)` Returns the `LocalTime` at the specified location in this `JSONArray`.
`java.lang.Long`	`getLong(int index)` Returns the `Long` at the specified location in this `JSONArray`.
`long`	`getLongValue(int index)` Returns a long value at the specified location in this `JSONArray`.
`<T> T`	`getObject(int index, java.lang.Class<T> type, JSONReader.Feature... features)` Returns the result of the `Type` converter conversion of the element at the specified position in this `JSONArray`.
`<T> T`	`getObject(int index, java.util.function.Function<JSONObject,T> creator)`
`<T> T`	`getObject(int index, java.lang.reflect.Type type, JSONReader.Feature... features)` Returns the result of the `Type` converter conversion of the element at the specified position in this `JSONArray`.
`java.time.OffsetDateTime`	`getOffsetDateTime(int index)` Returns the `OffsetDateTime` at the specified location in this `JSONArray`.
`java.time.OffsetDateTime`	`getOffsetDateTime(int index, java.time.OffsetDateTime defaultValue)` Returns the `OffsetDateTime` at the specified location in this `JSONArray`.
`java.time.OffsetTime`	`getOffsetTime(int index)` Returns the `OffsetTime` at the specified location in this `JSONArray`.
`java.time.OffsetTime`	`getOffsetTime(int index, java.time.OffsetTime defaultValue)` Returns the `OffsetTime` at the specified location in this `JSONArray`.
`java.lang.Short`	`getShort(int index)` Returns the `Short` at the specified location in this `JSONArray`.
`short`	`getShortValue(int index)` Returns a short value at the specified location in this `JSONArray`.
`java.lang.String`	`getString(int index)` Returns the `String` at the specified location in this `JSONArray`.
`java.lang.String`	`getString(int index, java.lang.String defaultValue)` Returns the `String` at the specified location in this `JSONArray`.
`java.time.ZonedDateTime`	`getZonedDateTime(int index)` Returns the `ZonedDateTime` at the specified location in this `JSONArray`.
`java.time.ZonedDateTime`	`getZonedDateTime(int index, java.time.ZonedDateTime defaultValue)` Returns the `ZonedDateTime` at the specified location in this `JSONArray`.
`boolean`	`isValid(JSONSchema schema)` Checks if this `JSONArray` is valid against the specified `JSONSchema`.
`static JSONArray`	`of(java.lang.Object... items)` Pack multiple elements as `JSONArray`
`static JSONArray`	`of(java.lang.Object item)` Pack an element as `JSONArray`
`static JSONArray`	`of(java.lang.Object first, java.lang.Object second)` Pack two elements as `JSONArray`
`static JSONArray`	`of(java.lang.Object first, java.lang.Object second, java.lang.Object third)` Pack three elements as `JSONArray`
`static JSONArray`	`parse(java.lang.String text, JSONReader.Feature... features)` Parse JSON `String` into `JSONArray`
`static <T> java.util.List<T>`	`parseArray(java.lang.String input, java.lang.Class<T> type)` Parse JSON `String` into `List`
`static <T> java.util.List<T>`	`parseArray(java.lang.String text, java.lang.Class<T> type, JSONReader.Feature... features)` Parse JSON `String` into `List`
`static JSONArray`	`parseArray(java.lang.String text, JSONReader.Feature... features)` Parse JSON `String` into `JSONArray`
`java.lang.Object`	`set(int index, java.lang.Object element)` Replaces the element at the specified position with the specified element
`<T> T`	`to(java.lang.Class<T> type)`
`<T> T`	`to(java.lang.reflect.Type type)` Convert this `JSONArray` to the specified Object
`<T> T`	`to(java.lang.reflect.Type type, long features)` Convert this `JSONArray` to the specified Object
`<T> T[]`	`toArray(java.lang.Class<T> itemClass, JSONReader.Feature... features)` Convert all the members of this `JSONArray` into the specified Object.
`<T> java.util.List<T>`	`toJavaList(java.lang.Class<T> clazz, JSONReader.Feature... features)` Convert all the members of this `JSONArray` into the specified Object.
`<T> T`	`toJavaObject(java.lang.reflect.Type type)` Deprecated. since 2.0.4, please use `to(Type)`
`byte[]`	`toJSONBBytes(JSONWriter.Feature... features)` Serialize to JSONB bytes
`java.lang.String`	`toJSONString(JSONWriter.Feature... features)` Serialize to JSON `String`
`static java.lang.String`	`toJSONString(java.lang.Object object, JSONWriter.Feature... features)` Serialize Java Object to JSON `String` with specified `JSONReader.Feature`s enabled
`<T> java.util.List<T>`	`toList(java.lang.Class<T> itemClass, JSONReader.Feature... features)` Convert all the members of this `JSONArray` into the specified Object.
`java.lang.String`	`toString()` Serialize to JSON `String`
`java.lang.String`	`toString(JSONWriter.Feature... features)` Serialize to JSON `String`

Methods inherited from class java.util.ArrayList
add, add, addAll, addAll, clear, contains, ensureCapacity, forEach, get, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, removeIf, removeRange, replaceAll, retainAll, size, sort, spliterator, subList, toArray, toArray, trimToSize

Methods inherited from class java.util.AbstractList
equals, hashCode

Methods inherited from class java.util.AbstractCollection
containsAll

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

Methods inherited from interface java.util.List
containsAll, equals, hashCode

Methods inherited from interface java.util.Collection
parallelStream, stream

- Field Detail
  - serialVersionUID
```
private static final long serialVersionUID
```
    See Also:
    
    Constant Field Values
  - arrayWriter
```
static ObjectWriter<JSONArray> arrayWriter
```
- Constructor Detail
  - JSONArray
```
public JSONArray()
```
    default
  - JSONArray
```
public JSONArray(int initialCapacity)
```
    Parameters:
    
    initialCapacity - the initial capacity of the JSONArray
    
    Throws:
    
    java.lang.IllegalArgumentException - If the specified initial capacity is negative
  - JSONArray
```
public JSONArray(java.util.Collection<?> collection)
```
    Parameters:
    
    collection - the collection whose elements are to be placed into this JSONArray
    
    Throws:
    
    java.lang.NullPointerException - If the specified collection is null
  - JSONArray
```
public JSONArray(java.lang.Object... items)
```
    Parameters:
    
    items - the array whose elements are to be placed into this JSONArray
    
    Throws:
    
    java.lang.NullPointerException - If the specified items is null
- Method Detail
  - set
```
public java.lang.Object set(int index,
                            java.lang.Object element)
```
    Replaces the element at the specified position with the specified element
```
    JSONArray array = new JSONArray();
    array.add(-1); // [-1]
    array.add(2); // [-1,2]
    array.set(0, 1); // [1,2]
    array.set(4, 3); // [1,2,null,null,3]
    array.set(-1, -1); // [1,2,null,null,-1]
    array.set(-2, -2); // [1,2,null,-2,-1]
    array.set(-6, -6); // [-6,1,2,null,-2,-1]
 
```
    Specified by:
    
    set in interface java.util.List<java.lang.Object>
    
    Overrides:
    
    set in class java.util.ArrayList<java.lang.Object>
    
    Parameters:
    
    index - index of the element to replace
    
    element - element to be stored at the specified position
    
    Returns:
    
    the element previously at the specified position
    
    Since:
    
    2.0.3
  - getJSONArray
```
public JSONArray getJSONArray(int index)
```
    Returns the JSONArray at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    JSONArray or null
    
    Throws:
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
  - getJSONObject
```
public JSONObject getJSONObject(int index)
```
    Returns the JSONObject at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    JSONObject or null
    
    Throws:
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
  - getString
```
public java.lang.String getString(int index)
```
    Returns the String at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    String or null
    
    Throws:
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
  - getString
```
public java.lang.String getString(int index,
                                  java.lang.String defaultValue)
```
    Returns the String at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    defaultValue - the default mapping of the index
    
    Returns:
    
    String or null
    
    Throws:
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
  - getDouble
```
public java.lang.Double getDouble(int index)
```
    Returns the Double at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    Double or null
    
    Throws:
    
    java.lang.NumberFormatException - If the value of get is String and it contains no parsable double
    
    JSONException - Unsupported type conversion to Double
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
  - getDoubleValue
```
public double getDoubleValue(int index)
```
    Returns a double value at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    double
    
    Throws:
    
    java.lang.NumberFormatException - If the value of get is String and it contains no parsable double
    
    JSONException - Unsupported type conversion to double value
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
  - getFloat
```
public java.lang.Float getFloat(int index)
```
    Returns the Float at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    Float or null
    
    Throws:
    
    java.lang.NumberFormatException - If the value of get is String and it contains no parsable float
    
    JSONException - Unsupported type conversion to Float
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
  - getFloatValue
```
public float getFloatValue(int index)
```
    Returns a float value at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    float
    
    Throws:
    
    java.lang.NumberFormatException - If the value of get is String and it contains no parsable float
    
    JSONException - Unsupported type conversion to float value
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
  - getLong
```
public java.lang.Long getLong(int index)
```
    Returns the Long at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    Long or null
    
    Throws:
    
    java.lang.NumberFormatException - If the value of get is String and it contains no parsable long
    
    JSONException - Unsupported type conversion to Long
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
  - getLongValue
```
public long getLongValue(int index)
```
    Returns a long value at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    long
    
    Throws:
    
    java.lang.NumberFormatException - If the value of get is String and it contains no parsable long
    
    JSONException - Unsupported type conversion to long value
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
  - getInteger
```
public java.lang.Integer getInteger(int index)
```
    Returns the Integer at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    Integer or null
    
    Throws:
    
    java.lang.NumberFormatException - If the value of get is String and it contains no parsable int
    
    JSONException - Unsupported type conversion to Integer
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
  - getIntValue
```
public int getIntValue(int index)
```
    Returns an int value at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    int
    
    Throws:
    
    java.lang.NumberFormatException - If the value of get is String and it contains no parsable int
    
    JSONException - Unsupported type conversion to int value
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
  - getShort
```
public java.lang.Short getShort(int index)
```
    Returns the Short at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    Short or null
    
    Throws:
    
    java.lang.NumberFormatException - If the value of get is String and it contains no parsable short
    
    JSONException - Unsupported type conversion to Short
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
  - getShortValue
```
public short getShortValue(int index)
```
    Returns a short value at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    short
    
    Throws:
    
    java.lang.NumberFormatException - If the value of get is String and it contains no parsable short
    
    JSONException - Unsupported type conversion to short value
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
  - getByte
```
public java.lang.Byte getByte(int index)
```
    Returns the Byte at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    Byte or null
    
    Throws:
    
    java.lang.NumberFormatException - If the value of get is String and it contains no parsable byte
    
    JSONException - Unsupported type conversion to Byte
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
  - getByteValue
```
public byte getByteValue(int index)
```
    Returns a byte value at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    byte
    
    Throws:
    
    java.lang.NumberFormatException - If the value of get is String and it contains no parsable byte
    
    JSONException - Unsupported type conversion to byte value
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
  - getBoolean
```
public java.lang.Boolean getBoolean(int index)
```
    Returns the Boolean at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    Boolean or null
    
    Throws:
    
    JSONException - Unsupported type conversion to Boolean
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
  - getBooleanValue
```
public boolean getBooleanValue(int index)
```
    Returns a boolean value at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    boolean
    
    Throws:
    
    JSONException - Unsupported type conversion to boolean value
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
  - getBigInteger
```
public java.math.BigInteger getBigInteger(int index)
```
    Returns the BigInteger at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    BigInteger or null
    
    Throws:
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
    
    JSONException - Unsupported type conversion to BigInteger
    
    java.lang.NumberFormatException - If the value of get is String and it is not a valid representation of BigInteger
  - getBigDecimal
```
public java.math.BigDecimal getBigDecimal(int index)
```
    Returns the BigDecimal at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    BigDecimal or null
    
    Throws:
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
    
    JSONException - Unsupported type conversion to BigDecimal
    
    java.lang.NumberFormatException - If the value of get is String and it is not a valid representation of BigDecimal
  - getDate
```
public java.util.Date getDate(int index)
```
    Returns the Date at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    Date or null
    
    Throws:
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
  - getDate
```
public java.util.Date getDate(int index,
                              java.util.Date defaultValue)
```
    Returns the Date at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    defaultValue - default value to return if the element is null
    
    Returns:
    
    Date or defaultValue
    
    Throws:
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
    
    Since:
    
    2.0.27
  - getInstant
```
public java.time.Instant getInstant(int index)
```
    Returns the Instant at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    Instant or null
    
    Throws:
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
  - getLocalDate
```
public java.time.LocalDate getLocalDate(int index)
```
    Returns the LocalDate at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    LocalDate or null
    
    Throws:
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
    
    Since:
    
    2.0.57
  - getLocalDate
```
public java.time.LocalDate getLocalDate(int index,
                                        java.time.LocalDate defaultValue)
```
    Returns the LocalDate at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    defaultValue - default value to return if the element is null
    
    Returns:
    
    LocalDate or defaultValue
    
    Throws:
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
    
    Since:
    
    2.0.57
  - getLocalTime
```
public java.time.LocalTime getLocalTime(int index)
```
    Returns the LocalTime at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    LocalTime or null
    
    Throws:
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
    
    Since:
    
    2.0.57
  - getLocalTime
```
public java.time.LocalTime getLocalTime(int index,
                                        java.time.LocalTime defaultValue)
```
    Returns the LocalTime at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    defaultValue - default value to return if the element is null
    
    Returns:
    
    LocalTime or defaultValue
    
    Throws:
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
    
    Since:
    
    2.0.57
  - getOffsetTime
```
public java.time.OffsetTime getOffsetTime(int index)
```
    Returns the OffsetTime at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    OffsetTime or null
    
    Throws:
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
    
    Since:
    
    2.0.57
  - getOffsetTime
```
public java.time.OffsetTime getOffsetTime(int index,
                                          java.time.OffsetTime defaultValue)
```
    Returns the OffsetTime at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    defaultValue - default value to return if the element is null
    
    Returns:
    
    OffsetTime or defaultValue
    
    Throws:
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
    
    Since:
    
    2.0.57
  - getLocalDateTime
```
public java.time.LocalDateTime getLocalDateTime(int index)
```
    Returns the LocalDateTime at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    LocalDateTime or null
    
    Throws:
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
    
    Since:
    
    2.0.57
  - getLocalDateTime
```
public java.time.LocalDateTime getLocalDateTime(int index,
                                                java.time.LocalDateTime defaultValue)
```
    Returns the LocalDateTime at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    defaultValue - default value to return if the element is null
    
    Returns:
    
    LocalDateTime or defaultValue
    
    Throws:
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
    
    Since:
    
    2.0.57
  - getOffsetDateTime
```
public java.time.OffsetDateTime getOffsetDateTime(int index)
```
    Returns the OffsetDateTime at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    OffsetDateTime or null
    
    Throws:
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
    
    Since:
    
    2.0.57
  - getOffsetDateTime
```
public java.time.OffsetDateTime getOffsetDateTime(int index,
                                                  java.time.OffsetDateTime defaultValue)
```
    Returns the OffsetDateTime at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    defaultValue - default value to return if the element is null
    
    Returns:
    
    OffsetDateTime or defaultValue
    
    Throws:
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
    
    Since:
    
    2.0.57
  - getZonedDateTime
```
public java.time.ZonedDateTime getZonedDateTime(int index)
```
    Returns the ZonedDateTime at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    Returns:
    
    ZonedDateTime or null
    
    Throws:
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
    
    Since:
    
    2.0.57
  - getZonedDateTime
```
public java.time.ZonedDateTime getZonedDateTime(int index,
                                                java.time.ZonedDateTime defaultValue)
```
    Returns the ZonedDateTime at the specified location in this JSONArray.
    
    Parameters:
    
    index - index of the element to return
    
    defaultValue - default value to return if the element is null
    
    Returns:
    
    ZonedDateTime or defaultValue
    
    Throws:
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
    
    Since:
    
    2.0.57
  - toString
```
public java.lang.String toString()
```
    Serialize to JSON String
    
    Overrides:
    
    toString in class java.util.AbstractCollection<java.lang.Object>
    
    Returns:
    
    JSON String
  - toString
```
public java.lang.String toString(JSONWriter.Feature... features)
```
    Serialize to JSON String
    
    Parameters:
    
    features - features to be enabled in serialization
    
    Returns:
    
    JSON String
  - toJSONString
```
public java.lang.String toJSONString(JSONWriter.Feature... features)
```
    Serialize to JSON String
    
    Parameters:
    
    features - features to be enabled in serialization
    
    Returns:
    
    JSON String
  - toJSONString
```
public static java.lang.String toJSONString(java.lang.Object object,
                                            JSONWriter.Feature... features)
```
    Serialize Java Object to JSON String with specified JSONReader.Features enabled
    
    Parameters:
    
    object - Java Object to be serialized into JSON String
    
    features - features to be enabled in serialization
    
    Since:
    
    2.0.15
  - toJSONBBytes
```
public byte[] toJSONBBytes(JSONWriter.Feature... features)
```
    Serialize to JSONB bytes
    
    Parameters:
    
    features - features to be enabled in serialization
    
    Returns:
    
    JSONB bytes
  - to
```
public <T> T to(java.lang.reflect.Type type)
```
    Convert this JSONArray to the specified Object
```
 JSONArray array = ...
 List<User> users = array.to(new TypeReference<ArrayList<User>>(){}.getType());
 
```
    Parameters:
    
    type - specify the Type to be converted
    
    Since:
    
    2.0.4
  - to
```
public <T> T to(java.lang.reflect.Type type,
                long features)
```
    Convert this JSONArray to the specified Object
```
 JSONArray array = ...
 List<User> users = array.to(new TypeReference<ArrayList<User>>(){}.getType());
 
```
    Parameters:
    
    type - specify the Type to be converted
    
    Since:
    
    2.0.51
  - to
```
public <T> T to(java.lang.Class<T> type)
```
    Since:
    
    2.0.9
  - toJavaObject
```
@Deprecated
public <T> T toJavaObject(java.lang.reflect.Type type)
```
    Deprecated. since 2.0.4, please use to(Type)
    
    Convert this JSONArray to the specified Object
    
    Parameters:
    
    type - specify the Type to be converted
  - toList
```
public <T> java.util.List<T> toList(java.lang.Class<T> itemClass,
                                    JSONReader.Feature... features)
```
    Convert all the members of this JSONArray into the specified Object.
```
 String json = "[{\"id\": 1, \"name\": \"fastjson\"}, {\"id\": 2, \"name\": \"fastjson2\"}]";
 JSONArray array = JSON.parseArray(json);
 List<User> users = array.toList(User.class);
 
```
    Parameters:
    
    itemClass - specify the Class<T> to be converted
    
    features - features to be enabled in parsing
    
    Since:
    
    2.0.4
  - toArray
```
public <T> T[] toArray(java.lang.Class<T> itemClass,
                       JSONReader.Feature... features)
```
    Convert all the members of this JSONArray into the specified Object.
```
 String json = "[{\"id\": 1, \"name\": \"fastjson\"}, {\"id\": 2, \"name\": \"fastjson2\"}]";
 JSONArray array = JSON.parseArray(json);
 List<User> users = array.toList(User.class);
 
```
    Parameters:
    
    itemClass - specify the Class<T> to be converted
    
    features - features to be enabled in parsing
    
    Since:
    
    2.0.4
  - toJavaList
```
public <T> java.util.List<T> toJavaList(java.lang.Class<T> clazz,
                                        JSONReader.Feature... features)
```
    Convert all the members of this JSONArray into the specified Object.
    
    Parameters:
    
    clazz - specify the Class<T> to be converted
    
    features - features to be enabled in parsing please use toList(Class, JSONReader.Feature...)
  - getObject
```
public <T> T getObject(int index,
                       java.lang.reflect.Type type,
                       JSONReader.Feature... features)
```
    Returns the result of the Type converter conversion of the element at the specified position in this JSONArray.
```
 JSONArray array = ...
 User user = array.getObject(0, TypeReference<HashMap<String ,User>>(){}.getType());
 
```
    Parameters:
    
    index - index of the element to return
    
    type - specify the Type to be converted
    
    Returns:
    
    <T> or null
    
    Throws:
    
    JSONException - If no suitable conversion method is found
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
  - getObject
```
public <T> T getObject(int index,
                       java.lang.Class<T> type,
                       JSONReader.Feature... features)
```
    Returns the result of the Type converter conversion of the element at the specified position in this JSONArray.
    User user = jsonArray.getObject(0, User.class);
    
    Parameters:
    
    index - index of the element to return
    
    type - specify the Class to be converted
    
    Returns:
    
    <T> or null
    
    Throws:
    
    JSONException - If no suitable conversion method is found
    
    java.lang.IndexOutOfBoundsException - if the index is out of range (index < 0 || index >= size())
  - getObject
```
public <T> T getObject(int index,
                       java.util.function.Function<JSONObject,T> creator)
```
    Since:
    
    2.0.3
  - addObject
```
public JSONObject addObject()
```
    Adds a new JSONObject to the end of this JSONArray.
    
    Returns:
    
    the newly created JSONObject
    
    Since:
    
    2.0.3
  - addArray
```
public JSONArray addArray()
```
    Adds a new JSONArray to the end of this JSONArray.
    
    Returns:
    
    the newly created JSONArray
    
    Since:
    
    2.0.3
  - fluentAdd
```
public JSONArray fluentAdd(java.lang.Object element)
```
    Chained addition of elements
```
 JSONArray array = new JSONArray().fluentAdd(1).fluentAdd(2).fluentAdd(3);
 
```
    Parameters:
    
    element - element to be appended to this list
    
    Returns:
    
    this JSONArray instance
    
    Since:
    
    2.0.3
  - fluentClear
```
public JSONArray fluentClear()
```
    Chained clear operation that removes all elements from this JSONArray.
    
    Returns:
    
    this JSONArray instance
    
    Since:
    
    2.0.3
  - fluentRemove
```
public JSONArray fluentRemove(int index)
```
    Chained remove operation that removes the element at the specified position.
    
    Parameters:
    
    index - the index of the element to be removed
    
    Returns:
    
    this JSONArray instance
    
    Since:
    
    2.0.3
  - fluentSet
```
public JSONArray fluentSet(int index,
                           java.lang.Object element)
```
    Chained set operation that replaces the element at the specified position.
    
    Parameters:
    
    index - index of the element to replace
    
    element - element to be stored at the specified position
    
    Returns:
    
    this JSONArray instance
    
    Since:
    
    2.0.3
  - fluentRemove
```
public JSONArray fluentRemove(java.lang.Object o)
```
    Chained remove operation that removes the first occurrence of the specified element.
    
    Parameters:
    
    o - element to be removed from this list, if present
    
    Returns:
    
    this JSONArray instance
    
    Since:
    
    2.0.3
  - fluentRemoveAll
```
public JSONArray fluentRemoveAll(java.util.Collection<?> c)
```
    Chained remove operation that removes from this list all of its elements that are contained in the specified collection.
    
    Parameters:
    
    c - collection containing elements to be removed from this list
    
    Returns:
    
    this JSONArray instance
    
    Since:
    
    2.0.3
  - fluentAddAll
```
public JSONArray fluentAddAll(java.util.Collection<?> c)
```
    Chained add operation that appends all of the elements in the specified collection to the end of this list.
    
    Parameters:
    
    c - collection containing elements to be added to this list
    
    Returns:
    
    this JSONArray instance
    
    Since:
    
    2.0.3
  - isValid
```
public boolean isValid(JSONSchema schema)
```
    Checks if this JSONArray is valid against the specified JSONSchema.
    
    Parameters:
    
    schema - the JSONSchema to validate against
    
    Returns:
    
    true if this JSONArray is valid against the schema, false otherwise
    
    Since:
    
    2.0.3
  - clone
```
public java.lang.Object clone()
```
    Creates and returns a copy of this JSONArray.
    
    Overrides:
    
    clone in class java.util.ArrayList<java.lang.Object>
    
    Returns:
    
    a clone of this instance
  - of
```
public static JSONArray of(java.lang.Object... items)
```
    Pack multiple elements as JSONArray
```
 JSONArray array = JSONArray.of(1, 2, "3", 4F, 5L, 6D, true);
 
```
    Parameters:
    
    items - element set
  - of
```
public static JSONArray of(java.lang.Object item)
```
    Pack an element as JSONArray
```
 JSONArray array = JSONArray.of("fastjson");
 
```
    Parameters:
    
    item - target element
  - copyOf
```
public static JSONArray copyOf(java.util.Collection collection)
```
    Returns an JSONArray containing the elements of the given Collection, in its iteration order.
```
 JSONArray array = JSONArray.copyOf(List.of("fastjson"));
 
```
    Since:
    
    2.0.22
  - of
```
public static JSONArray of(java.lang.Object first,
                           java.lang.Object second)
```
    Pack two elements as JSONArray
```
 JSONArray array = JSONArray.of("fastjson", 2);
 
```
    Parameters:
    
    first - first element
    
    second - second element
  - of
```
public static JSONArray of(java.lang.Object first,
                           java.lang.Object second,
                           java.lang.Object third)
```
    Pack three elements as JSONArray
```
 JSONArray array = JSONArray.of("fastjson", 2, true);
 
```
    Parameters:
    
    first - first element
    
    second - second element
    
    third - third element
  - parseArray
```
public static JSONArray parseArray(java.lang.String text,
                                   JSONReader.Feature... features)
```
    Parse JSON String into JSONArray
    
    Parameters:
    
    text - the JSON String to be parsed
    
    features - features to be enabled in parsing
  - parseArray
```
public static <T> java.util.List<T> parseArray(java.lang.String text,
                                               java.lang.Class<T> type,
                                               JSONReader.Feature... features)
```
    Parse JSON String into List
    
    Parameters:
    
    text - the JSON String to be parsed
    
    type - specify the Class to be converted
    
    features - features to be enabled in parsing
  - parse
```
public static JSONArray parse(java.lang.String text,
                              JSONReader.Feature... features)
```
    Parse JSON String into JSONArray
    
    Parameters:
    
    text - the JSON String to be parsed
    
    features - features to be enabled in parsing
    
    Since:
    
    2.0.13
  - parseArray
```
public static <T> java.util.List<T> parseArray(java.lang.String input,
                                               java.lang.Class<T> type)
```
    Parse JSON String into List
    
    Parameters:
    
    input - the JSON String to be parsed
    
    type - specify the Class to be converted
    
    Since:
    
    2.0.24
  - from
```
public static JSONArray from(java.lang.Object obj)
```
    See JSON.toJSON(java.lang.Object) for details
  - from
```
public static JSONArray from(java.lang.Object obj,
                             JSONWriter.Feature... writeFeatures)
```
    See JSON.toJSON(java.lang.Object) for details

Class JSONArray

Field Summary

Fields inherited from class java.util.AbstractList

Constructor Summary

Method Summary

Methods inherited from class java.util.ArrayList

Methods inherited from class java.util.AbstractList

Methods inherited from class java.util.AbstractCollection

Methods inherited from class java.lang.Object

Methods inherited from interface java.util.List

Methods inherited from interface java.util.Collection

Field Detail

serialVersionUID

arrayWriter

Constructor Detail

JSONArray

JSONArray

JSONArray

JSONArray

Method Detail

set

getJSONArray

getJSONObject

getString

getString

getDouble

getDoubleValue

getFloat

getFloatValue

getLong

getLongValue

getInteger

getIntValue

getShort

getShortValue

getByte

getByteValue

getBoolean

getBooleanValue

getBigInteger

getBigDecimal

getDate

getDate

getInstant

getLocalDate

getLocalDate

getLocalTime

getLocalTime

getOffsetTime

getOffsetTime

getLocalDateTime

getLocalDateTime

getOffsetDateTime

getOffsetDateTime

getZonedDateTime

getZonedDateTime

toString

toString

toJSONString

toJSONString

toJSONBBytes

to

to

to

toJavaObject

toList

toArray

toJavaList

getObject

getObject

getObject

addObject

addArray

fluentAdd

fluentClear

fluentRemove

fluentSet

fluentRemove

fluentRemoveAll

fluentAddAll