JSONArray (blade-kit 1.2.9 API)

java.lang.Object
- blade.kit.json.JSONValue
- - blade.kit.json.JSONArray

所有已实现的接口:

Serializable, Iterable<JSONValue>
```
public class JSONArray
extends JSONValue
implements Iterable<JSONValue>
```
Represents a JSON array, an ordered collection of JSON values.
Elements can be added using the add(...) methods which accept instances of JSONValue, strings, primitive numbers, and boolean values. To replace an element of an array, use the set(int, ...) methods.

Elements can be accessed by their index using get(int). This class also supports iterating over the elements in document order using an iterator() or an enhanced for loop:
```
 for (JsonValue value : jsonArray) {
   ...
 }
 
```
An equivalent List can be obtained from the method values().

Note that this class is not thread-safe. If multiple threads access a JsonArray instance concurrently, while at least one of these threads modifies the contents of this array, access to the instance must be synchronized externally. Failure to do so may lead to an inconsistent state.

This class is not supposed to be extended by clients.
另请参阅:

序列化表格

字段概要
- 从类继承的字段 blade.kit.json.JSONValue
  FALSE, NULL, TRUE

构造器概要

构造器
构造器和说明

JSONArray()
Creates a new empty JsonArray.

JSONArray(JSONArray array)
Creates a new JsonArray with the contents of the specified JSON array.

构造器
构造器和说明
`JSONArray()` Creates a new empty JsonArray.
`JSONArray(JSONArray array)` Creates a new JsonArray with the contents of the specified JSON array.

方法概要

All Methods Static Methods Instance Methods Concrete Methods 已过时的方法
限定符和类型	方法和说明
`JSONArray`	`add(boolean value)` Appends the JSON representation of the specified `boolean` value to the end of this array.
`JSONArray`	`add(double value)` Appends the JSON representation of the specified `double` value to the end of this array.
`JSONArray`	`add(float value)` Appends the JSON representation of the specified `float` value to the end of this array.
`JSONArray`	`add(int value)` Appends the JSON representation of the specified `int` value to the end of this array.
`JSONArray`	`add(JSONValue value)` Appends the specified JSON value to the end of this array.
`JSONArray`	`add(long value)` Appends the JSON representation of the specified `long` value to the end of this array.
`JSONArray`	`add(String value)` Appends the JSON representation of the specified string to the end of this array.
`JSONArray`	`asArray()` Returns this JSON value as `JSONArray`, assuming that this value represents a JSON array.
`boolean`	`equals(Object object)` Indicates whether some other object is "equal to" this one according to the contract specified in `Object.equals(Object)`.
`JSONValue`	`get(int index)` Returns the value of the element at the specified position in this array.
`Boolean`	`getBoolean(int index)`
`Double`	`getDouble(int index)`
`Integer`	`getInt(int index)`
`JSONObject`	`getJSONObject(int index)`
`Long`	`getLong(int index)`
`String`	`getString(int index)`
`int`	`hashCode()`
`boolean`	`isArray()` Detects whether this value represents a JSON array.
`boolean`	`isEmpty()` Returns `true` if this array contains no elements.
`Iterator<JSONValue>`	`iterator()` Returns an iterator over the values of this array in document order.
`static JSONArray`	`readFrom(Reader reader)` 已过时。 Use `JSON.parse(Reader).asArray()` instead
`static JSONArray`	`readFrom(String string)` 已过时。 Use `JSON.parse(String).asArray()` instead
`JSONArray`	`remove(int index)` Removes the element at the specified index from this array.
`JSONArray`	`set(int index, boolean value)` Replaces the element at the specified position in this array with the JSON representation of the specified `boolean` value.
`JSONArray`	`set(int index, double value)` Replaces the element at the specified position in this array with the JSON representation of the specified `double` value.
`JSONArray`	`set(int index, float value)` Replaces the element at the specified position in this array with the JSON representation of the specified `float` value.
`JSONArray`	`set(int index, int value)` Replaces the element at the specified position in this array with the JSON representation of the specified `int` value.
`JSONArray`	`set(int index, JSONValue value)` Replaces the element at the specified position in this array with the specified JSON value.
`JSONArray`	`set(int index, long value)` Replaces the element at the specified position in this array with the JSON representation of the specified `long` value.
`JSONArray`	`set(int index, String value)` Replaces the element at the specified position in this array with the JSON representation of the specified string.
`int`	`size()` Returns the number of elements in this array.
`static JSONArray`	`unmodifiableArray(JSONArray array)` Returns an unmodifiable wrapper for the specified JsonArray.
`List<JSONValue>`	`values()` Returns a list of the values in this array in document order.

从类继承的方法 blade.kit.json.JSONValue
asBoolean, asDouble, asFloat, asInt, asLong, asObject, asString, isBoolean, isFalse, isNull, isNumber, isObject, isString, isTrue, toString, toString, valueOf, valueOf, valueOf, valueOf, valueOf, valueOf, writeTo, writeTo

从类继承的方法 java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

从接口继承的方法 java.lang.Iterable
forEach, spliterator

- 构造器详细资料
  - JSONArray
```
public JSONArray()
```
    Creates a new empty JsonArray.
  - JSONArray
```
public JSONArray(JSONArray array)
```
    Creates a new JsonArray with the contents of the specified JSON array.
    
    参数:
    
    array - the JsonArray to get the initial contents from, must not be null
- 方法详细资料
  - readFrom
```
@Deprecated
public static JSONArray readFrom(Reader reader)
                                       throws IOException
```
    已过时。 Use JSON.parse(Reader).asArray() instead
    
    Reads a JSON array from the given reader.
    Characters are read in chunks and buffered internally, therefore wrapping an existing reader in an additional BufferedReader does not improve reading performance.
    
    参数:
    
    reader - the reader to read the JSON array from
    
    返回:
    
    the JSON array that has been read
    
    抛出:
    
    IOException - if an I/O error occurs in the reader
    
    ParseException - if the input is not valid JSON
    
    UnsupportedOperationException - if the input does not contain a JSON array
  - readFrom
```
@Deprecated
public static JSONArray readFrom(String string)
```
    已过时。 Use JSON.parse(String).asArray() instead
    
    Reads a JSON array from the given string.
    
    参数:
    
    string - the string that contains the JSON array
    
    返回:
    
    the JSON array that has been read
    
    抛出:
    
    ParseException - if the input is not valid JSON
    
    UnsupportedOperationException - if the input does not contain a JSON array
  - unmodifiableArray
```
public static JSONArray unmodifiableArray(JSONArray array)
```
    Returns an unmodifiable wrapper for the specified JsonArray. This method allows to provide read-only access to a JsonArray.
    The returned JsonArray is backed by the given array and reflects subsequent changes. Attempts to modify the returned JsonArray result in an UnsupportedOperationException.
    
    参数:
    
    array - the JsonArray for which an unmodifiable JsonArray is to be returned
    
    返回:
    
    an unmodifiable view of the specified JsonArray
  - add
```
public JSONArray add(int value)
```
    Appends the JSON representation of the specified int value to the end of this array.
    
    参数:
    
    value - the value to add to the array
    
    返回:
    
    the array itself, to enable method chaining
  - add
```
public JSONArray add(long value)
```
    Appends the JSON representation of the specified long value to the end of this array.
    
    参数:
    
    value - the value to add to the array
    
    返回:
    
    the array itself, to enable method chaining
  - add
```
public JSONArray add(float value)
```
    Appends the JSON representation of the specified float value to the end of this array.
    
    参数:
    
    value - the value to add to the array
    
    返回:
    
    the array itself, to enable method chaining
  - add
```
public JSONArray add(double value)
```
    Appends the JSON representation of the specified double value to the end of this array.
    
    参数:
    
    value - the value to add to the array
    
    返回:
    
    the array itself, to enable method chaining
  - add
```
public JSONArray add(boolean value)
```
    Appends the JSON representation of the specified boolean value to the end of this array.
    
    参数:
    
    value - the value to add to the array
    
    返回:
    
    the array itself, to enable method chaining
  - add
```
public JSONArray add(String value)
```
    Appends the JSON representation of the specified string to the end of this array.
    
    参数:
    
    value - the string to add to the array
    
    返回:
    
    the array itself, to enable method chaining
  - add
```
public JSONArray add(JSONValue value)
```
    Appends the specified JSON value to the end of this array.
    
    参数:
    
    value - the JsonValue to add to the array, must not be null
    
    返回:
    
    the array itself, to enable method chaining
  - set
```
public JSONArray set(int index,
                     int value)
```
    Replaces the element at the specified position in this array with the JSON representation of the specified int value.
    
    参数:
    
    index - the index of the array element to replace
    
    value - the value to be stored at the specified array position
    
    返回:
    
    the array itself, to enable method chaining
    
    抛出:
    
    IndexOutOfBoundsException - if the index is out of range, i.e. index < 0 or index >= size
  - set
```
public JSONArray set(int index,
                     long value)
```
    Replaces the element at the specified position in this array with the JSON representation of the specified long value.
    
    参数:
    
    index - the index of the array element to replace
    
    value - the value to be stored at the specified array position
    
    返回:
    
    the array itself, to enable method chaining
    
    抛出:
    
    IndexOutOfBoundsException - if the index is out of range, i.e. index < 0 or index >= size
  - set
```
public JSONArray set(int index,
                     float value)
```
    Replaces the element at the specified position in this array with the JSON representation of the specified float value.
    
    参数:
    
    index - the index of the array element to replace
    
    value - the value to be stored at the specified array position
    
    返回:
    
    the array itself, to enable method chaining
    
    抛出:
    
    IndexOutOfBoundsException - if the index is out of range, i.e. index < 0 or index >= size
  - set
```
public JSONArray set(int index,
                     double value)
```
    Replaces the element at the specified position in this array with the JSON representation of the specified double value.
    
    参数:
    
    index - the index of the array element to replace
    
    value - the value to be stored at the specified array position
    
    返回:
    
    the array itself, to enable method chaining
    
    抛出:
    
    IndexOutOfBoundsException - if the index is out of range, i.e. index < 0 or index >= size
  - set
```
public JSONArray set(int index,
                     boolean value)
```
    Replaces the element at the specified position in this array with the JSON representation of the specified boolean value.
    
    参数:
    
    index - the index of the array element to replace
    
    value - the value to be stored at the specified array position
    
    返回:
    
    the array itself, to enable method chaining
    
    抛出:
    
    IndexOutOfBoundsException - if the index is out of range, i.e. index < 0 or index >= size
  - set
```
public JSONArray set(int index,
                     String value)
```
    Replaces the element at the specified position in this array with the JSON representation of the specified string.
    
    参数:
    
    index - the index of the array element to replace
    
    value - the string to be stored at the specified array position
    
    返回:
    
    the array itself, to enable method chaining
    
    抛出:
    
    IndexOutOfBoundsException - if the index is out of range, i.e. index < 0 or index >= size
  - set
```
public JSONArray set(int index,
                     JSONValue value)
```
    Replaces the element at the specified position in this array with the specified JSON value.
    
    参数:
    
    index - the index of the array element to replace
    
    value - the value to be stored at the specified array position, must not be null
    
    返回:
    
    the array itself, to enable method chaining
    
    抛出:
    
    IndexOutOfBoundsException - if the index is out of range, i.e. index < 0 or index >= size
  - remove
```
public JSONArray remove(int index)
```
    Removes the element at the specified index from this array.
    
    参数:
    
    index - the index of the element to remove
    
    返回:
    
    the array itself, to enable method chaining
    
    抛出:
    
    IndexOutOfBoundsException - if the index is out of range, i.e. index < 0 or index >= size
  - size
```
public int size()
```
    Returns the number of elements in this array.
    
    返回:
    
    the number of elements in this array
  - isEmpty
```
public boolean isEmpty()
```
    Returns true if this array contains no elements.
    
    返回:
    
    true if this array contains no elements
  - get
```
public JSONValue get(int index)
```
    Returns the value of the element at the specified position in this array.
    
    参数:
    
    index - the index of the array element to return
    
    返回:
    
    the value of the element at the specified position
    
    抛出:
    
    IndexOutOfBoundsException - if the index is out of range, i.e. index < 0 or index >= size
  - getJSONObject
```
public JSONObject getJSONObject(int index)
```
  - getString
```
public String getString(int index)
```
  - getInt
```
public Integer getInt(int index)
```
  - getLong
```
public Long getLong(int index)
```
  - getDouble
```
public Double getDouble(int index)
```
  - getBoolean
```
public Boolean getBoolean(int index)
```
  - values
```
public List<JSONValue> values()
```
    Returns a list of the values in this array in document order. The returned list is backed by this array and will reflect subsequent changes. It cannot be used to modify this array. Attempts to modify the returned list will result in an exception.
    
    返回:
    
    a list of the values in this array
  - iterator
```
public Iterator<JSONValue> iterator()
```
    Returns an iterator over the values of this array in document order. The returned iterator cannot be used to modify this array.
    
    指定者:
    
    iterator 在接口中 Iterable<JSONValue>
    
    返回:
    
    an iterator over the values of this array
  - isArray
```
public boolean isArray()
```
    从类复制的说明: JSONValue
    
    Detects whether this value represents a JSON array. If this is the case, this value is an instance of JSONArray.
    
    覆盖:
    
    isArray 在类中 JSONValue
    
    返回:
    
    true if this value is an instance of JsonArray
  - asArray
```
public JSONArray asArray()
```
    从类复制的说明: JSONValue
    
    Returns this JSON value as JSONArray, assuming that this value represents a JSON array. If this is not the case, an exception is thrown.
    
    覆盖:
    
    asArray 在类中 JSONValue
    
    返回:
    
    a JSONArray for this value
  - hashCode
```
public int hashCode()
```
    覆盖:
    
    hashCode 在类中 JSONValue
  - equals
```
public boolean equals(Object object)
```
    从类复制的说明: JSONValue
    
    Indicates whether some other object is "equal to" this one according to the contract specified in Object.equals(Object).
    Two JsonValues are considered equal if and only if they represent the same JSON text. As a consequence, two given JsonObjects may be different even though they contain the same set of names with the same values, but in a different order.
    
    覆盖:
    
    equals 在类中 JSONValue
    
    参数:
    
    object - the reference object with which to compare
    
    返回:
    
    true if this object is the same as the object argument; false otherwise

类 JSONArray

字段概要

从类继承的字段 blade.kit.json.JSONValue

构造器概要

方法概要

从类继承的方法 blade.kit.json.JSONValue

从类继承的方法 java.lang.Object

从接口继承的方法 java.lang.Iterable

构造器详细资料

JSONArray

JSONArray

方法详细资料

readFrom

readFrom

unmodifiableArray

add

add

add

add

add

add

add

set

set

set

set

set

set

set

remove

size

isEmpty

get

getJSONObject

getString

getInt

getLong

getDouble

getBoolean

values

iterator

isArray

asArray

hashCode

equals