JSONArray (hutool 6.0.0-M20 API)

java.lang.Object
- org.dromara.hutool.core.lang.wrapper.SimpleWrapper<List<E>>
- - org.dromara.hutool.core.collection.ListWrapper<JSON>
  - - org.dromara.hutool.json.JSONArray

All Implemented Interfaces:

Serializable, Iterable<JSON>, Collection<JSON>, List<JSON>, RandomAccess, TypeGetter<Integer>, Wrapper<List<JSON>>, JSON, JSONGetter<Integer>
```
public class JSONArray
extends ListWrapper<JSON>
implements JSON, JSONGetter<Integer>, 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 inherited from class org.dromara.hutool.core.lang.wrapper.SimpleWrapper
  raw

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(int initialCapacity, JSONFactory factory)` 构造默认使用`ArrayList` 实现
`JSONArray(JSONConfig config)` 构造默认使用`ArrayList` 实现

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`add(int index, JSON element)`
`boolean`	`add(JSON element)`
`boolean`	`addAll(int index, Collection<? extends JSON> c)`
`JSONArray`	`addNull()` 加入`null`元素，如果设置中忽略null值，则忽略
`JSONArray`	`addValue(Boolean value)` 加入元素，数组长度+1，等同于 `ListWrapper.add(Object)`
`JSONArray`	`addValue(Character value)` 加入元素，数组长度+1，等同于 `ListWrapper.add(Object)`
`JSONArray`	`addValue(Number value)` 加入元素，数组长度+1，等同于 `ListWrapper.add(Object)`
`JSONArray`	`addValue(Object value)` 加入元素，数组长度+1，等同于 `ListWrapper.add(Object)`
`JSONArray`	`addValue(String value)` 加入元素，数组长度+1，等同于 `ListWrapper.add(Object)`
`JSONFactory`	`getFactory()` 获取JSON工厂
`JSON`	`getJSON(Integer key)` 获取JSON对象在JSON树模型中，JSON的节点都以JSON格式存储，所有get方法都基于此方法
`Iterator<JSON>`	`iterator()`
`JSON`	`set(int index, JSON element)` 加入或者替换JSONArray中指定Index的值，如果index大于JSONArray的长度，将在指定index设置值，之前的位置填充JSONNull.Null
`JSONArray`	`setValue(int index, Object element)` 加入或者替换JSONArray中指定Index的值，如果index大于JSONArray的长度，将在指定index设置值，之前的位置填充JSONNull.Null
`Object`	`toArray(Class<?> arrayClass)` 转为Bean数组
`<T> T[]`	`toArray(T[] a)`
`JSONObject`	`toJSONObject(JSONArray names)` 根据给定名列表，与其位置对应的值组成JSONObject
`<T> List<T>`	`toList(Class<T> elementType)` 转为`ArrayList`
`String`	`toString()` 转为JSON字符串，无缩进
`void`	`write(JSONWriter writer)` 将JSON内容写入Writer Warning: This method assumes that the data structure is acyclical.

Methods inherited from class org.dromara.hutool.core.collection.ListWrapper
addAll, clear, contains, containsAll, equals, forEach, get, hashCode, indexOf, isEmpty, lastIndexOf, listIterator, listIterator, parallelStream, remove, remove, removeAll, removeIf, replaceAll, retainAll, size, sort, spliterator, stream, subList, toArray

Methods inherited from class org.dromara.hutool.core.lang.wrapper.SimpleWrapper
getRaw

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

Methods inherited from interface org.dromara.hutool.json.JSON
asJSONArray, asJSONObject, asJSONPrimitive, config, getByPath, getByPath, getObjByPath, isEmpty, putByPath, size, toBean, toJSONString, toJSONString, toStringPretty

Methods inherited from interface org.dromara.hutool.json.JSONGetter
get, getBeanList, getJSONArray, getJSONObject, getObj, 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

- 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 - 初始大小
  - 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配置项
  - JSONArray
```
public JSONArray(int initialCapacity,
                 JSONFactory factory)
```
    构造
    默认使用ArrayList 实现
    
    Parameters:
    
    initialCapacity - 初始大小
    
    factory - JSON工厂
- Method Detail
  - getFactory
```
public JSONFactory getFactory()
```
    Description copied from interface: JSON
    
    获取JSON工厂
    
    Specified by:
    
    getFactory in interface JSON
    
    Specified by:
    
    getFactory in interface JSONGetter<Integer>
    
    Returns:
    
    JSON工厂
  - getJSON
```
public JSON getJSON(Integer key)
```
    Description copied from interface: JSONGetter
    
    获取JSON对象
    在JSON树模型中，JSON的节点都以JSON格式存储，所有get方法都基于此方法
    
    Specified by:
    
    getJSON in interface JSONGetter<Integer>
    
    Parameters:
    
    key - KEY
    
    Returns:
    
    JSON对象
  - addNull
```
public JSONArray addNull()
```
    加入null元素，如果设置中忽略null值，则忽略
    
    Returns:
    
    this.
  - addValue
```
public JSONArray addValue(Boolean value)
```
    加入元素，数组长度+1，等同于 ListWrapper.add(Object)
    
    Parameters:
    
    value - Number值
    
    Returns:
    
    this.
  - addValue
```
public JSONArray addValue(Number value)
```
    加入元素，数组长度+1，等同于 ListWrapper.add(Object)
    
    Parameters:
    
    value - Number值
    
    Returns:
    
    this.
  - addValue
```
public JSONArray addValue(Character value)
```
    加入元素，数组长度+1，等同于 ListWrapper.add(Object)
    
    Parameters:
    
    value - Character值
    
    Returns:
    
    this.
  - addValue
```
public JSONArray addValue(String value)
```
    加入元素，数组长度+1，等同于 ListWrapper.add(Object)
    
    Parameters:
    
    value - String值
    
    Returns:
    
    this.
  - addValue
```
public JSONArray addValue(Object value)
```
    加入元素，数组长度+1，等同于 ListWrapper.add(Object)
    
    Parameters:
    
    value - 值，可以是： Boolean, Double, Integer, JSONArray, JSONObject, Long, or String, or the null。
    
    Returns:
    
    this.
  - toJSONObject
```
public JSONObject toJSONObject(JSONArray names)
                        throws JSONException
```
    根据给定名列表，与其位置对应的值组成JSONObject
    
    Parameters:
    
    names - 名列表，位置与JSONArray中的值位置对应
    
    Returns:
    
    A JSONObject，无名或值返回null
    
    Throws:
    
    JSONException - 如果任何一个名为null
  - iterator
```
public Iterator<JSON> iterator()
```
    Specified by:
    
    iterator in interface Iterable<JSON>
    
    Specified by:
    
    iterator in interface Collection<JSON>
    
    Specified by:
    
    iterator in interface List<JSON>
    
    Overrides:
    
    iterator in class ListWrapper<JSON>
  - addAll
```
public boolean addAll(int index,
                      Collection<? extends JSON> c)
```
    Specified by:
    
    addAll in interface List<JSON>
    
    Overrides:
    
    addAll in class ListWrapper<JSON>
  - setValue
```
public JSONArray setValue(int index,
                          Object element)
```
    加入或者替换JSONArray中指定Index的值，如果index大于JSONArray的长度，将在指定index设置值，之前的位置填充JSONNull.Null
    
    Parameters:
    
    index - 位置
    
    element - 值对象. 可以是以下类型: Boolean, Double, Integer, JSONArray, JSONObject, Long, String, or the JSONNull.NULL.
    
    Returns:
    
    this
  - set
```
public JSON set(int index,
                JSON element)
```
    加入或者替换JSONArray中指定Index的值，如果index大于JSONArray的长度，将在指定index设置值，之前的位置填充JSONNull.Null
    
    Specified by:
    
    set in interface List<JSON>
    
    Overrides:
    
    set in class ListWrapper<JSON>
    
    Parameters:
    
    index - 位置
    
    element - 值对象. 可以是以下类型: Boolean, Double, Integer, JSONArray, JSONObject, Long, String, or the JSONNull.NULL.
    
    Returns:
    
    替换的值，即之前的值
  - add
```
public boolean add(JSON element)
```
    Specified by:
    
    add in interface Collection<JSON>
    
    Specified by:
    
    add in interface List<JSON>
    
    Overrides:
    
    add in class ListWrapper<JSON>
  - add
```
public void add(int index,
                JSON element)
```
    Specified by:
    
    add in interface List<JSON>
    
    Overrides:
    
    add in class ListWrapper<JSON>
  - toArray
```
public <T> T[] toArray(T[] a)
```
    Specified by:
    
    toArray in interface Collection<JSON>
    
    Specified by:
    
    toArray in interface List<JSON>
    
    Overrides:
    
    toArray in class ListWrapper<JSON>
  - 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字符串
  - write
```
public void write(JSONWriter writer)
           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
    
    Throws:
    
    JSONException - JSON相关异常

Class JSONArray

Field Summary

Fields inherited from class org.dromara.hutool.core.lang.wrapper.SimpleWrapper

Constructor Summary

Method Summary

Methods inherited from class org.dromara.hutool.core.collection.ListWrapper

Methods inherited from class org.dromara.hutool.core.lang.wrapper.SimpleWrapper

Methods inherited from class java.lang.Object

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

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

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

Field Detail

DEFAULT_CAPACITY

Constructor Detail

JSONArray

JSONArray

JSONArray

JSONArray

JSONArray

Method Detail

getFactory

getJSON

addNull

addValue

addValue

addValue

addValue

addValue

toJSONObject

iterator

addAll

setValue

set

add

add

toArray

toArray

toList

toString

write