JSONArray (hutool-json 6.0.0-M16 API)

java.lang.Object
- org.dromara.hutool.json.JSONArray

All Implemented Interfaces:

Serializable, Cloneable, Iterable<Object>, Collection<Object>, List<Object>, RandomAccess, Converter, TypeGetter<Integer>, JSON, JSONGetter<Integer>
```
public class JSONArray
extends Object
implements JSON, JSONGetter<Integer>, List<Object>, RandomAccess
```
JSON数组
JSON数组是表示中括号括住的数据表现形式
对应的JSON字符串格格式例如:
```
 ["a", "b", "c", 12]
 
```
Author:

looly

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type Field and Description

static int DEFAULT_CAPACITY
默认初始大小

Fields
Modifier and Type	Field and Description
`static int`	`DEFAULT_CAPACITY` 默认初始大小

Constructor Summary

Constructors
Constructor and Description
`JSONArray()` 构造默认使用`ArrayList` 实现
`JSONArray(int initialCapacity)` 构造默认使用`ArrayList` 实现
`JSONArray(int initialCapacity, JSONConfig config)` 构造默认使用`ArrayList` 实现
`JSONArray(JSONConfig config)` 构造默认使用`ArrayList` 实现
`JSONArray(Object object)` 从对象构造，忽略`null`的值支持以下类型的参数： 1.
`JSONArray(Object object, JSONConfig jsonConfig)` 从对象构造支持以下类型的参数： 1.
`JSONArray(Object object, JSONConfig jsonConfig, Predicate<Mutable<Object>> predicate)` 从对象构造支持以下类型的参数： 1.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`add(int index, Object element)`
`boolean`	`add(Object e)`
`boolean`	`add(Object e, Predicate<Mutable<Object>> predicate)` 增加元素
`boolean`	`addAll(Collection<?> c)`
`boolean`	`addAll(int index, Collection<?> c)`
`protected boolean`	`addRaw(Object obj, Predicate<Mutable<Object>> predicate)` 原始添加，添加的对象不做任何处理
`void`	`clear()`
`Object`	`clone()`
`JSONConfig`	`config()` 获取JSON配置
`boolean`	`contains(Object o)`
`boolean`	`containsAll(Collection<?> c)`
`boolean`	`equals(Object obj)`
`Object`	`get(int index)`
`Object`	`getObj(Integer index, Object defaultValue)`
`int`	`hashCode()`
`int`	`indexOf(Object o)`
`boolean`	`isEmpty()`
`Iterator<Object>`	`iterator()`
`String`	`join(String separator)` JSONArray转为以`separator`为分界符的字符串
`Iterable<JSONObject>`	`jsonIter()` 当此JSON列表的每个元素都是一个JSONObject时，可以调用此方法返回一个Iterable，便于使用foreach语法遍历
`int`	`lastIndexOf(Object o)`
`ListIterator<Object>`	`listIterator()`
`ListIterator<Object>`	`listIterator(int index)`
`JSONArray`	`put(int index, Object value)` 加入或者替换JSONArray中指定Index的值，如果index大于JSONArray的长度，将在指定index设置值，之前的位置填充JSONNull.Null
`JSONArray`	`put(Object value)` Append an object value.
`Object`	`remove(int index)`
`boolean`	`remove(Object o)`
`boolean`	`removeAll(Collection<?> c)`
`boolean`	`retainAll(Collection<?> c)`
`Object`	`set(int index, Object element)` 加入或者替换JSONArray中指定Index的值，如果index大于JSONArray的长度，将在指定index设置值，之前的位置填充JSONNull.Null
`Object`	`set(int index, Object element, Predicate<MutableEntry<Integer,Object>> filter)` 加入或者替换JSONArray中指定Index的值，如果index大于JSONArray的长度，将在指定index设置值，之前的位置填充JSONNull.Null
`JSONArray`	`set(Object value)` Append an object value.
`JSONArray`	`setDateFormat(String format)` 设置转为字符串时的日期格式，默认为时间戳（null值）
`int`	`size()` JSON大小，对于JSONObject，是键值对的多少，JSONArray则是元素的个数
`List<Object>`	`subList(int fromIndex, int toIndex)`
`Object[]`	`toArray()`
`Object`	`toArray(Class<?> arrayClass)` 转为Bean数组
`<T> T[]`	`toArray(T[] a)`
`JSONObject`	`toJSONObject(JSONArray names)` 根据给定名列表，与其位置对应的值组成JSONObject
`String`	`toJSONString(int indentFactor, Predicate<MutableEntry<Object,Object>> predicate)` 返回JSON字符串支持过滤器，即选择哪些字段或值不写出
`<T> List<T>`	`toList(Class<T> elementType)` 转为`ArrayList`
`String`	`toString()` 转为JSON字符串，无缩进
`Writer`	`write(Writer writer, int indentFactor, int indent, Predicate<MutableEntry<Object,Object>> predicate)` 将JSON内容写入Writer Warning: This method assumes that the data structure is acyclical.

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

Methods inherited from interface org.dromara.hutool.json.JSON
convert, getByPath, getByPath, putByPath, toBean, toJSONString, toStringPretty, write

Methods inherited from interface org.dromara.hutool.core.convert.Converter
convert, identity

Methods inherited from interface org.dromara.hutool.json.JSONGetter
get, getBean, getBeanList, getJSONArray, getJSONObject, getStrEscaped, getStrEscaped, isNull

Methods inherited from interface org.dromara.hutool.core.lang.getter.TypeGetter
get, get, getBigDecimal, getBigDecimal, getBigInteger, getBigInteger, getBool, getBool, getByte, getByte, getBytes, getBytes, getChar, getChar, getDate, getDate, getDouble, getDouble, getEnum, getEnum, getFloat, getFloat, getInt, getInt, getLocalDate, getLocalDate, getLocalDateTime, getLocalDateTime, getLocalTime, getLocalTime, getLong, getLong, getNumber, getNumber, getObj, getShort, getShort, getSqlTime, getSqlTime, getSqlTimestamp, getSqlTimestamp, getStr, getStr

Methods inherited from interface java.util.List
replaceAll, sort, spliterator

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

Methods inherited from interface java.lang.Iterable
forEach

- Field Detail
  - DEFAULT_CAPACITY
```
public static final int DEFAULT_CAPACITY
```
    默认初始大小
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - JSONArray
```
public JSONArray()
```
    构造
    默认使用ArrayList 实现
  - JSONArray
```
public JSONArray(int initialCapacity)
```
    构造
    默认使用ArrayList 实现
    
    Parameters:
    
    initialCapacity - 初始大小
    
    Since:
    
    3.2.2
  - JSONArray
```
public JSONArray(JSONConfig config)
```
    构造
    默认使用ArrayList 实现
    
    Parameters:
    
    config - JSON配置项
    
    Since:
    
    4.6.5
  - JSONArray
```
public JSONArray(int initialCapacity,
                 JSONConfig config)
```
    构造
    默认使用ArrayList 实现
    
    Parameters:
    
    initialCapacity - 初始大小
    
    config - JSON配置项
    
    Since:
    
    4.1.19
  - JSONArray
```
public JSONArray(Object object)
          throws JSONException
```
    从对象构造，忽略null的值
    支持以下类型的参数：
```
 1. 数组
 2. Iterable对象
 3. JSON数组字符串
 
```
    Parameters:
    
    object - 数组或集合或JSON数组字符串
    
    Throws:
    
    JSONException - 非数组或集合
  - JSONArray
```
public JSONArray(Object object,
                 JSONConfig jsonConfig)
          throws JSONException
```
    从对象构造
    支持以下类型的参数：
```
 1. 数组
 2. Iterable对象
 3. JSON数组字符串
 
```
    Parameters:
    
    object - 数组或集合或JSON数组字符串
    
    jsonConfig - JSON选项
    
    Throws:
    
    JSONException - 非数组或集合
    
    Since:
    
    4.6.5
  - JSONArray
```
public JSONArray(Object object,
                 JSONConfig jsonConfig,
                 Predicate<Mutable<Object>> predicate)
          throws JSONException
```
    从对象构造
    支持以下类型的参数：
```
 1. 数组
 2. Iterable对象
 3. JSON数组字符串
 
```
    Parameters:
    
    object - 数组或集合或JSON数组字符串
    
    jsonConfig - JSON选项
    
    predicate - 键值对过滤编辑器，可以通过实现此接口，完成解析前对值的过滤和修改操作，null表示不过滤，Predicate.test(Object)为true保留
    
    Throws:
    
    JSONException - 非数组或集合
    
    Since:
    
    5.8.0
- Method Detail
  - config
```
public JSONConfig config()
```
    Description copied from interface: JSON
    
    获取JSON配置
    
    Specified by:
    
    config in interface JSON
    
    Specified by:
    
    config in interface JSONGetter<Integer>
    
    Returns:
    
    JSONConfig
  - setDateFormat
```
public JSONArray setDateFormat(String format)
```
    设置转为字符串时的日期格式，默认为时间戳（null值）
    
    Parameters:
    
    format - 格式，null表示使用时间戳
    
    Returns:
    
    this
    
    Since:
    
    4.1.19
  - join
```
public String join(String separator)
            throws JSONException
```
    JSONArray转为以separator为分界符的字符串
    
    Parameters:
    
    separator - 分界符
    
    Returns:
    
    a string.
    
    Throws:
    
    JSONException - If the array contains an invalid number.
  - get
```
public Object get(int index)
```
    Specified by:
    
    get in interface List<Object>
  - getObj
```
public Object getObj(Integer index,
                     Object defaultValue)
```
    Specified by:
    
    getObj in interface TypeGetter<Integer>
  - put
```
public JSONArray put(Object value)
```
    Append an object value. This increases the array's length by one.
    加入元素，数组长度+1，等同于 add(Object)
    
    Parameters:
    
    value - 值，可以是： Boolean, Double, Integer, JSONArray, JSONObject, Long, or String, or the JSONNull.NULL。
    
    Returns:
    
    this.
    
    See Also:
    
    set(Object)
  - set
```
public JSONArray set(Object value)
```
    Append an object value. This increases the array's length by one.
    加入元素，数组长度+1，等同于 add(Object)
    
    Parameters:
    
    value - 值，可以是： Boolean, Double, Integer, JSONArray, JSONObject, Long, or String, or the JSONNull.NULL。
    
    Returns:
    
    this.
    
    Since:
    
    5.2.5
  - put
```
public JSONArray put(int index,
                     Object value)
              throws JSONException
```
    加入或者替换JSONArray中指定Index的值，如果index大于JSONArray的长度，将在指定index设置值，之前的位置填充JSONNull.Null
    
    Parameters:
    
    index - 位置
    
    value - 值对象. 可以是以下类型: Boolean, Double, Integer, JSONArray, JSONObject, Long, String, or the JSONNull.NULL.
    
    Returns:
    
    this.
    
    Throws:
    
    JSONException - index < 0 或者非有限的数字
    
    See Also:
    
    set(int, Object)
  - toJSONObject
```
public JSONObject toJSONObject(JSONArray names)
                        throws JSONException
```
    根据给定名列表，与其位置对应的值组成JSONObject
    
    Parameters:
    
    names - 名列表，位置与JSONArray中的值位置对应
    
    Returns:
    
    A JSONObject，无名或值返回null
    
    Throws:
    
    JSONException - 如果任何一个名为null
  - hashCode
```
public int hashCode()
```
    Specified by:
    
    hashCode in interface Collection<Object>
    
    Specified by:
    
    hashCode in interface List<Object>
    
    Overrides:
    
    hashCode in class Object
  - equals
```
public boolean equals(Object obj)
```
    Specified by:
    
    equals in interface Collection<Object>
    
    Specified by:
    
    equals in interface List<Object>
    
    Overrides:
    
    equals in class Object
  - iterator
```
public Iterator<Object> iterator()
```
    Specified by:
    
    iterator in interface Iterable<Object>
    
    Specified by:
    
    iterator in interface Collection<Object>
    
    Specified by:
    
    iterator in interface List<Object>
  - jsonIter
```
public Iterable<JSONObject> jsonIter()
```
    当此JSON列表的每个元素都是一个JSONObject时，可以调用此方法返回一个Iterable，便于使用foreach语法遍历
    
    Returns:
    
    Iterable
    
    Since:
    
    4.0.12
  - size
```
public int size()
```
    Description copied from interface: JSON
    
    JSON大小，对于JSONObject，是键值对的多少，JSONArray则是元素的个数
    
    Specified by:
    
    size in interface Collection<Object>
    
    Specified by:
    
    size in interface List<Object>
    
    Specified by:
    
    size in interface JSON
    
    Returns:
    
    大小
  - isEmpty
```
public boolean isEmpty()
```
    Specified by:
    
    isEmpty in interface Collection<Object>
    
    Specified by:
    
    isEmpty in interface List<Object>
  - contains
```
public boolean contains(Object o)
```
    Specified by:
    
    contains in interface Collection<Object>
    
    Specified by:
    
    contains in interface List<Object>
  - toArray
```
public Object[] toArray()
```
    Specified by:
    
    toArray in interface Collection<Object>
    
    Specified by:
    
    toArray in interface List<Object>
  - toArray
```
public <T> T[] toArray(T[] a)
```
    Specified by:
    
    toArray in interface Collection<Object>
    
    Specified by:
    
    toArray in interface List<Object>
  - add
```
public boolean add(Object e)
```
    Specified by:
    
    add in interface Collection<Object>
    
    Specified by:
    
    add in interface List<Object>
  - add
```
public boolean add(Object e,
                   Predicate<Mutable<Object>> predicate)
```
    增加元素
    
    Parameters:
    
    e - 元素对象，自动根据对象类型转换为JSON中的对象
    
    predicate - 键值对过滤编辑器，可以通过实现此接口，完成解析前对值的过滤和修改操作，null表示不过滤，Predicate.test(Object)为true保留
    
    Returns:
    
    是否加入成功
  - remove
```
public Object remove(int index)
```
    Specified by:
    
    remove in interface List<Object>
  - remove
```
public boolean remove(Object o)
```
    Specified by:
    
    remove in interface Collection<Object>
    
    Specified by:
    
    remove in interface List<Object>
  - containsAll
```
public boolean containsAll(Collection<?> c)
```
    Specified by:
    
    containsAll in interface Collection<Object>
    
    Specified by:
    
    containsAll in interface List<Object>
  - addAll
```
public boolean addAll(Collection<?> c)
```
    Specified by:
    
    addAll in interface Collection<Object>
    
    Specified by:
    
    addAll in interface List<Object>
  - addAll
```
public boolean addAll(int index,
                      Collection<?> c)
```
    Specified by:
    
    addAll in interface List<Object>
  - removeAll
```
public boolean removeAll(Collection<?> c)
```
    Specified by:
    
    removeAll in interface Collection<Object>
    
    Specified by:
    
    removeAll in interface List<Object>
  - retainAll
```
public boolean retainAll(Collection<?> c)
```
    Specified by:
    
    retainAll in interface Collection<Object>
    
    Specified by:
    
    retainAll in interface List<Object>
  - clear
```
public void clear()
```
    Specified by:
    
    clear in interface Collection<Object>
    
    Specified by:
    
    clear in interface List<Object>
  - set
```
public Object set(int index,
                  Object element)
```
    加入或者替换JSONArray中指定Index的值，如果index大于JSONArray的长度，将在指定index设置值，之前的位置填充JSONNull.Null
    
    Specified by:
    
    set in interface List<Object>
    
    Parameters:
    
    index - 位置
    
    element - 值对象. 可以是以下类型: Boolean, Double, Integer, JSONArray, JSONObject, Long, String, or the JSONNull.NULL.
    
    Returns:
    
    替换的值，即之前的值
  - set
```
public Object set(int index,
                  Object element,
                  Predicate<MutableEntry<Integer,Object>> filter)
```
    加入或者替换JSONArray中指定Index的值，如果index大于JSONArray的长度，将在指定index设置值，之前的位置填充JSONNull.Null
    
    Parameters:
    
    index - 位置
    
    element - 值对象. 可以是以下类型: Boolean, Double, Integer, JSONArray, JSONObject, Long, String, or the JSONNull.NULL.
    
    filter - 过滤器，可以修改值，key（index）无法修改，Predicate.test(Object)为true保留，null表示全部保留。
    
    Returns:
    
    替换的值，即之前的值
    
    Since:
    
    5.8.0
  - add
```
public void add(int index,
                Object element)
```
    Specified by:
    
    add in interface List<Object>
  - indexOf
```
public int indexOf(Object o)
```
    Specified by:
    
    indexOf in interface List<Object>
  - lastIndexOf
```
public int lastIndexOf(Object o)
```
    Specified by:
    
    lastIndexOf in interface List<Object>
  - listIterator
```
public ListIterator<Object> listIterator()
```
    Specified by:
    
    listIterator in interface List<Object>
  - listIterator
```
public ListIterator<Object> listIterator(int index)
```
    Specified by:
    
    listIterator in interface List<Object>
  - subList
```
public List<Object> subList(int fromIndex,
                            int toIndex)
```
    Specified by:
    
    subList in interface List<Object>
  - toArray
```
public Object toArray(Class<?> arrayClass)
```
    转为Bean数组
    
    Parameters:
    
    arrayClass - 数组元素类型
    
    Returns:
    
    实体类对象
  - toList
```
public <T> List<T> toList(Class<T> elementType)
```
    转为ArrayList
    
    Type Parameters:
    
    T - 元素类型
    
    Parameters:
    
    elementType - 元素类型
    
    Returns:
    
    ArrayList
    
    Since:
    
    3.0.8
  - toString
```
public String toString()
```
    转为JSON字符串，无缩进
    
    Overrides:
    
    toString in class Object
    
    Returns:
    
    JSONArray字符串
  - toJSONString
```
public String toJSONString(int indentFactor,
                           Predicate<MutableEntry<Object,Object>> predicate)
```
    返回JSON字符串
    支持过滤器，即选择哪些字段或值不写出
    
    Parameters:
    
    indentFactor - 每层缩进空格数
    
    predicate - 过滤器，可以修改值，key（index）无法修改，Predicate.test(Object)为true保留
    
    Returns:
    
    JSON字符串
    
    Since:
    
    5.7.15
  - write
```
public Writer write(Writer writer,
                    int indentFactor,
                    int indent,
                    Predicate<MutableEntry<Object,Object>> predicate)
             throws JSONException
```
    Description copied from interface: JSON
    
    将JSON内容写入Writer
    Warning: This method assumes that the data structure is acyclical.
    
    Specified by:
    
    write in interface JSON
    
    Parameters:
    
    writer - writer
    
    indentFactor - 缩进因子，定义每一级别增加的缩进量
    
    indent - 本级别缩进量
    
    predicate - 过滤器，可以修改值，key（index）无法修改，Predicate.test(Object)为true保留
    
    Returns:
    
    Writer
    
    Throws:
    
    JSONException - JSON相关异常
  - clone
```
public Object clone()
             throws CloneNotSupportedException
```
    Overrides:
    
    clone in class Object
    
    Throws:
    
    CloneNotSupportedException
  - addRaw
```
protected boolean addRaw(Object obj,
                         Predicate<Mutable<Object>> predicate)
```
    原始添加，添加的对象不做任何处理
    
    Parameters:
    
    obj - 添加的对象
    
    predicate - 键值对过滤编辑器，可以通过实现此接口，完成解析前对值的过滤和修改操作，null表示不过滤，Predicate.test(Object)为true保留
    
    Returns:
    
    是否加入成功
    
    Since:
    
    5.8.0

Class JSONArray

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface org.dromara.hutool.json.JSON

Methods inherited from interface org.dromara.hutool.core.convert.Converter

Methods inherited from interface org.dromara.hutool.json.JSONGetter

Methods inherited from interface org.dromara.hutool.core.lang.getter.TypeGetter

Methods inherited from interface java.util.List

Methods inherited from interface java.util.Collection

Methods inherited from interface java.lang.Iterable

Field Detail

DEFAULT_CAPACITY

Constructor Detail

JSONArray

JSONArray

JSONArray

JSONArray

JSONArray

JSONArray

JSONArray

Method Detail

config

setDateFormat

join

get

getObj

put

set

put

toJSONObject

hashCode

equals

iterator

jsonIter

size

isEmpty

contains

toArray

toArray

add

add

remove

remove

containsAll

addAll

addAll

removeAll

retainAll

clear

set

set

add

indexOf

lastIndexOf

listIterator

listIterator

subList

toArray

toList

toString

toJSONString

write

clone

addRaw