com.xiaoleilu.hutool.json

类 JSONArray

java.lang.Object

com.xiaoleilu.hutool.getter.OptNullBasicTypeGetter<K>

com.xiaoleilu.hutool.getter.OptNullBasicTypeFromObjectGetter<K>

com.xiaoleilu.hutool.json.JSONGetter<Integer>

com.xiaoleilu.hutool.json.JSONArray

所有已实现的接口:

BasicTypeGetter<Integer>, OptBasicTypeGetter<Integer>, JSON, Iterable<Object>

public class JSONArray
extends JSONGetter<Integer>
implements JSON, Iterable<Object>

JSON数组

作者:

looly

构造器概要

构造器

构造器和说明
JSONArray() Construct an empty JSONArray.
JSONArray(JSONTokener x) Construct a JSONArray from a JSONTokener.
JSONArray(Object arrayOrCollection) Construct a JSONArray from an array or Collection
JSONArray(String source) Construct a JSONArray from a source JSON text.

方法概要

方法

限定符和类型	方法和说明
Object	get(int index) Get the optional object value associated with an index.
Object	getObj(Integer index, Object defaultValue) 获取Object属性值
boolean	isNull(int index) Determine if the value is null.
Iterator<Object>	iterator()
String	join(String separator) Make a string from the contents of this JSONArray.
int	length() Get the number of elements in the JSONArray, included nulls.
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) Remove an index and close the hole.
boolean	similar(Object other) Determine if two JSONArrays are similar.
JSONObject	toJSONObject(JSONArray names) Produce a JSONObject by combining a JSONArray of names with the values of this JSONArray.
String	toJSONString(int indentFactor) Make a prettyprinted JSON text of this JSONArray.
String	toString() Make a JSON text of this JSONArray.
Writer	write(Writer writer) 将JSON内容写入Writer，无缩进 Warning: This method assumes that the data structure is acyclical.
Writer	write(Writer writer, int indentFactor, int indent) 将JSON内容写入Writer Warning: This method assumes that the data structure is acyclical.

从类继承的方法 com.xiaoleilu.hutool.json.JSONGetter

getJSONArray, getJSONObject

从类继承的方法 com.xiaoleilu.hutool.getter.OptNullBasicTypeFromObjectGetter

getBigDecimal, getBigInteger, getBool, getByte, getChar, getDouble, getEnum, getFloat, getInt, getLong, getShort, getStr

从类继承的方法 com.xiaoleilu.hutool.getter.OptNullBasicTypeGetter

getBigDecimal, getBigInteger, getBool, getByte, getChar, getDouble, getEnum, getFloat, getInt, getLong, getObj, getShort, getStr

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造器详细资料

JSONArray

public JSONArray()

Construct an empty JSONArray.

JSONArray

public JSONArray(JSONTokener x)
          throws JSONException

Construct a JSONArray from a JSONTokener.

参数:

x - A JSONTokener

抛出:

JSONException - If there is a syntax error.

JSONArray

public JSONArray(String source)
          throws JSONException

Construct a JSONArray from a source JSON text.

参数:

source - A string that begins with [ (left bracket) and ends with ] (right bracket).

抛出:

JSONException - If there is a syntax error.

JSONArray

public JSONArray(Object arrayOrCollection)
          throws JSONException

Construct a JSONArray from an array or Collection

抛出:

JSONException - If not an array.

方法详细资料

iterator

public Iterator<Object> iterator()

指定者:

iterator 在接口中 Iterable<Object>

isNull

public boolean isNull(int index)

Determine if the value is null.

参数:

index - The index must be between 0 and length() - 1.

返回:

true if the value at the index is null, or if there is no value.

join

public String join(String separator)
            throws JSONException

Make a string from the contents of this JSONArray. The separator string is inserted between each element. Warning: This method assumes that the data structure is acyclical.

参数:

separator - A string that will be inserted between the elements.

返回:

a string.

抛出:

JSONException - If the array contains an invalid number.

length

public int length()

Get the number of elements in the JSONArray, included nulls.

返回:

The length (or size).

get

public Object get(int index)

Get the optional object value associated with an index.

参数:

index - The index must be between 0 and length() - 1.

返回:

An object value, or null if there is no object at that index.

getObj

public Object getObj(Integer index,
            Object defaultValue)

从接口复制的说明: OptBasicTypeGetter

获取Object属性值

指定者:

getObj 在接口中 OptBasicTypeGetter<Integer>

指定者:

getObj 在类中 OptNullBasicTypeFromObjectGetter<Integer>

参数:

index - 属性名

defaultValue - 默认值

返回:

属性值，无对应值返回defaultValue

put

public JSONArray put(Object value)

Append an object value. This increases the array's length by one.

参数:

value - An object value. The value should be a Boolean, Double, Integer, JSONArray, JSONObject, Long, or String, or the JSONNull.NULL object.

返回:

this.

put

public JSONArray put(int index,
            Object value)
              throws JSONException

加入或者替换JSONArray中指定Index的值，如果index大于JSONArray的长度，将在指定index设置值，之前的位置填充JSONNull.Null

参数:

index - 位置

value - 值对象. 可以是以下类型: Boolean, Double, Integer, JSONArray, JSONObject, Long, String, or the JSONNull.NULL.

返回:

this.

抛出:

JSONException - index < 0 或者非有限的数字

remove

public Object remove(int index)

Remove an index and close the hole.

参数:

index - The index of the element to be removed.

返回:

The value that was associated with the index, or null if there was no value.

similar

public boolean similar(Object other)

Determine if two JSONArrays are similar. They must contain similar sequences.

参数:

other - The other JSONArray

返回:

true if they are equal

toJSONObject

public JSONObject toJSONObject(JSONArray names)
                        throws JSONException

Produce a JSONObject by combining a JSONArray of names with the values of this JSONArray.

参数:

names - A JSONArray containing a list of key strings. These will be paired with the values.

返回:

A JSONObject, or null if there are no names or if this JSONArray has no values.

抛出:

JSONException - If any of the names are null.

toString

public String toString()

Make a JSON text of this JSONArray. For compactness, no unnecessary whitespace is added. If it is not possible to produce a syntactically correct JSON text then null will be returned instead. This could occur if the array contains an invalid number.

Warning: This method assumes that the data structure is acyclical.

覆盖:

toString 在类中 Object

返回:

a printable, displayable, transmittable representation of the array.

toJSONString

public String toJSONString(int indentFactor)
                    throws JSONException

Make a prettyprinted JSON text of this JSONArray. Warning: This method assumes that the data structure is acyclical.

指定者:

toJSONString 在接口中 JSON

参数:

indentFactor - The number of spaces to add to each level of indentation.

返回:

a printable, displayable, transmittable representation of the object, beginning with [ (left bracket) and ending with ] (right bracket).

抛出:

JSONException

write

public Writer write(Writer writer)
             throws JSONException

从接口复制的说明: JSON

将JSON内容写入Writer，无缩进
Warning: This method assumes that the data structure is acyclical.

指定者:

write 在接口中 JSON

参数:

writer - Writer

返回:

Writer

抛出:

JSONException

write

public Writer write(Writer writer,
           int indentFactor,
           int indent)
             throws JSONException

从接口复制的说明: JSON

将JSON内容写入Writer
Warning: This method assumes that the data structure is acyclical.

指定者:

write 在接口中 JSON

参数:

writer - writer

indentFactor - 每一级别的缩进量

indent - 顶级别缩进量

返回:

Writer

抛出:

JSONException