com.blade.kit.json

类 JSONObject

java.lang.Object

com.blade.kit.json.JSONValue

com.blade.kit.json.JSONObject

所有已实现的接口:

Serializable, Iterable<JSONObject.Member>

public class JSONObject
extends JSONValue
implements Iterable<JSONObject.Member>

Represents a JSON object, a set of name/value pairs, where the names are strings and the values are JSON values.

Members can be added using the add(String, ...) methods which accept instances of JSONValue, strings, primitive numbers, and boolean values. To modify certain values of an object, use the set(String, ...) methods. Please note that the add methods are faster than set as they do not search for existing members. On the other hand, the add methods do not prevent adding multiple members with the same name. Duplicate names are discouraged but not prohibited by JSON.

Members can be accessed by their name using get(String). A list of all names can be obtained from the method names(). This class also supports iterating over the members in document order using an iterator() or an enhanced for loop:

 for (Member member : jsonObject) {
   String name = member.getName();
   JsonValue value = member.getValue();
   ...
 }
 

Even though JSON objects are unordered by definition, instances of this class preserve the order of members to allow processing in document order and to guarantee a predictable output.

Note that this class is not thread-safe. If multiple threads access a JsonObject instance concurrently, while at least one of these threads modifies the contents of this object, 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.

另请参阅:

序列化表格

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	JSONObject.Member Represents a member of a JSON object, a pair of a name and a value.

构造器概要

构造器

构造器和说明
JSONObject() Creates a new empty JsonObject.
JSONObject(JSONObject object) Creates a new JsonObject, initialized with the contents of the specified JSON object.

方法概要

限定符和类型	方法和说明
JSONObject	asJSONObject() Returns this JSON value as JSONObject, assuming that this value represents a JSON object.
boolean	contains(String name)
boolean	equals(Object obj) Indicates whether some other object is "equal to" this one according to the contract specified in Object.equals(Object).
JSONValue	get(String name) Returns the value of the member with the specified name in this object.
boolean	getBoolean(String name)
Boolean	getBoolean(String name, Boolean defaultValue) Returns the boolean value of the member with the specified name in this object.
Double	getDouble(String name)
Double	getDouble(String name, Double defaultValue) Returns the double value of the member with the specified name in this object.
Float	getFloat(String name)
Float	getFloat(String name, Float defaultValue) Returns the float value of the member with the specified name in this object.
Integer	getInt(String name)
Integer	getInt(String name, Integer defaultValue) Returns the int value of the member with the specified name in this object.
Long	getLong(String name)
Long	getLong(String name, Long defaultValue) Returns the long value of the member with the specified name in this object.
String	getString(String name)
String	getString(String name, String defaultValue) Returns the String value of the member with the specified name in this object.
int	hashCode()
boolean	isEmpty() Returns true if this object contains no members.
boolean	isObject() Detects whether this value represents a JSON object.
Iterator<JSONObject.Member>	iterator() Returns an iterator over the members of this object in document order.
JSONObject	merge(JSONObject object) Copies all members of the specified object into this object.
List<String>	names() Returns a list of the names in this object in document order.
JSONObject	put(String name, boolean value) Appends a new member to the end of this object, with the specified name and the JSON representation of the specified boolean value.
JSONObject	put(String name, double value) Appends a new member to the end of this object, with the specified name and the JSON representation of the specified double value.
JSONObject	put(String name, float value) Appends a new member to the end of this object, with the specified name and the JSON representation of the specified float value.
JSONObject	put(String name, int value) Appends a new member to the end of this object, with the specified name and the JSON representation of the specified int value.
JSONObject	put(String name, JSONValue value) Appends a new member to the end of this object, with the specified name and the specified JSON value.
JSONObject	put(String name, long value) Appends a new member to the end of this object, with the specified name and the JSON representation of the specified long value.
JSONObject	put(String name, Object value)
JSONObject	put(String name, String value) Appends a new member to the end of this object, with the specified name and the JSON representation of the specified string.
JSONObject	remove(String name) Removes a member with the specified name from this object.
JSONObject	set(String name, boolean value) Sets the value of the member with the specified name to the JSON representation of the specified boolean value.
JSONObject	set(String name, double value) Sets the value of the member with the specified name to the JSON representation of the specified double value.
JSONObject	set(String name, float value) Sets the value of the member with the specified name to the JSON representation of the specified float value.
JSONObject	set(String name, int value) Sets the value of the member with the specified name to the JSON representation of the specified int value.
JSONObject	set(String name, JSONValue value) Sets the value of the member with the specified name to the specified JSON value.
JSONObject	set(String name, long value) Sets the value of the member with the specified name to the JSON representation of the specified long value.
JSONObject	set(String name, String value) Sets the value of the member with the specified name to the JSON representation of the specified string.
int	size() Returns the number of members (name/value pairs) in this object.
static JSONObject	unmodifiableObject(JSONObject object) Returns an unmodifiable JsonObject for the specified one.

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

asArray, asBoolean, asDouble, asFloat, asInt, asLong, asString, isArray, isBean, isBoolean, isFalse, isLong, isNull, isNumber, isString, isTrue, toString, toString, writeTo, writeTo

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

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

forEach, spliterator

构造器详细资料

JSONObject

public JSONObject()

Creates a new empty JsonObject.

JSONObject

public JSONObject(JSONObject object)

Creates a new JsonObject, initialized with the contents of the specified JSON object.

参数:

object - the JSON object to get the initial contents from, must not be null

方法详细资料

unmodifiableObject

public static JSONObject unmodifiableObject(JSONObject object)

Returns an unmodifiable JsonObject for the specified one. This method allows to provide read-only access to a JsonObject.

The returned JsonObject is backed by the given object and reflect changes that happen to it. Attempts to modify the returned JsonObject result in an UnsupportedOperationException.

参数:

object - the JsonObject for which an unmodifiable JsonObject is to be returned

返回:

an unmodifiable view of the specified JsonObject

put

public JSONObject put(String name,
                      int value)

Appends a new member to the end of this object, with the specified name and the JSON representation of the specified int value.

This method does not prevent duplicate names. Calling this method with a name that already exists in the object will append another member with the same name. In order to replace existing members, use the method set(name, value) instead. However, add is much faster than set (because it does not need to search for existing members). Therefore add should be preferred when constructing new objects.

参数:

name - the name of the member to add

value - the value of the member to add

返回:

the object itself, to enable method chaining

put

public JSONObject put(String name,
                      Object value)

put

public JSONObject put(String name,
                      long value)

Appends a new member to the end of this object, with the specified name and the JSON representation of the specified long value.

This method does not prevent duplicate names. Calling this method with a name that already exists in the object will append another member with the same name. In order to replace existing members, use the method set(name, value) instead. However, add is much faster than set (because it does not need to search for existing members). Therefore add should be preferred when constructing new objects.

参数:

name - the name of the member to add

value - the value of the member to add

返回:

the object itself, to enable method chaining

put

public JSONObject put(String name,
                      float value)

Appends a new member to the end of this object, with the specified name and the JSON representation of the specified float value.

This method does not prevent duplicate names. Calling this method with a name that already exists in the object will append another member with the same name. In order to replace existing members, use the method set(name, value) instead. However, add is much faster than set (because it does not need to search for existing members). Therefore add should be preferred when constructing new objects.

参数:

name - the name of the member to add

value - the value of the member to add

返回:

the object itself, to enable method chaining

put

public JSONObject put(String name,
                      double value)

Appends a new member to the end of this object, with the specified name and the JSON representation of the specified double value.

This method does not prevent duplicate names. Calling this method with a name that already exists in the object will append another member with the same name. In order to replace existing members, use the method set(name, value) instead. However, add is much faster than set (because it does not need to search for existing members). Therefore add should be preferred when constructing new objects.

参数:

name - the name of the member to add

value - the value of the member to add

返回:

the object itself, to enable method chaining

put

public JSONObject put(String name,
                      boolean value)

Appends a new member to the end of this object, with the specified name and the JSON representation of the specified boolean value.

This method does not prevent duplicate names. Calling this method with a name that already exists in the object will append another member with the same name. In order to replace existing members, use the method set(name, value) instead. However, add is much faster than set (because it does not need to search for existing members). Therefore add should be preferred when constructing new objects.

参数:

name - the name of the member to add

value - the value of the member to add

返回:

the object itself, to enable method chaining

put

public JSONObject put(String name,
                      String value)

Appends a new member to the end of this object, with the specified name and the JSON representation of the specified string.

This method does not prevent duplicate names. Calling this method with a name that already exists in the object will append another member with the same name. In order to replace existing members, use the method set(name, value) instead. However, add is much faster than set (because it does not need to search for existing members). Therefore add should be preferred when constructing new objects.

参数:

name - the name of the member to add

value - the value of the member to add

返回:

the object itself, to enable method chaining

put

public JSONObject put(String name,
                      JSONValue value)

Appends a new member to the end of this object, with the specified name and the specified JSON value.

This method does not prevent duplicate names. Calling this method with a name that already exists in the object will append another member with the same name. In order to replace existing members, use the method set(name, value) instead. However, add is much faster than set (because it does not need to search for existing members). Therefore add should be preferred when constructing new objects.

参数:

name - the name of the member to add

value - the value of the member to add, must not be null

返回:

the object itself, to enable method chaining

set

public JSONObject set(String name,
                      int value)

Sets the value of the member with the specified name to the JSON representation of the specified int value. If this object does not contain a member with this name, a new member is added at the end of the object. If this object contains multiple members with this name, only the last one is changed.

This method should only be used to modify existing objects. To fill a new object with members, the method add(name, value) should be preferred which is much faster (as it does not need to search for existing members).

参数:

name - the name of the member to replace

value - the value to set to the member

返回:

the object itself, to enable method chaining

set

public JSONObject set(String name,
                      long value)

Sets the value of the member with the specified name to the JSON representation of the specified long value. If this object does not contain a member with this name, a new member is added at the end of the object. If this object contains multiple members with this name, only the last one is changed.

This method should only be used to modify existing objects. To fill a new object with members, the method add(name, value) should be preferred which is much faster (as it does not need to search for existing members).

参数:

name - the name of the member to replace

value - the value to set to the member

返回:

the object itself, to enable method chaining

set

public JSONObject set(String name,
                      float value)

Sets the value of the member with the specified name to the JSON representation of the specified float value. If this object does not contain a member with this name, a new member is added at the end of the object. If this object contains multiple members with this name, only the last one is changed.

This method should only be used to modify existing objects. To fill a new object with members, the method add(name, value) should be preferred which is much faster (as it does not need to search for existing members).

参数:

name - the name of the member to add

value - the value of the member to add

返回:

the object itself, to enable method chaining

set

public JSONObject set(String name,
                      double value)

Sets the value of the member with the specified name to the JSON representation of the specified double value. If this object does not contain a member with this name, a new member is added at the end of the object. If this object contains multiple members with this name, only the last one is changed.

This method should only be used to modify existing objects. To fill a new object with members, the method add(name, value) should be preferred which is much faster (as it does not need to search for existing members).

参数:

name - the name of the member to add

value - the value of the member to add

返回:

the object itself, to enable method chaining

set

public JSONObject set(String name,
                      boolean value)

Sets the value of the member with the specified name to the JSON representation of the specified boolean value. If this object does not contain a member with this name, a new member is added at the end of the object. If this object contains multiple members with this name, only the last one is changed.

This method should only be used to modify existing objects. To fill a new object with members, the method add(name, value) should be preferred which is much faster (as it does not need to search for existing members).

参数:

name - the name of the member to add

value - the value of the member to add

返回:

the object itself, to enable method chaining

set

public JSONObject set(String name,
                      String value)

Sets the value of the member with the specified name to the JSON representation of the specified string. If this object does not contain a member with this name, a new member is added at the end of the object. If this object contains multiple members with this name, only the last one is changed.

This method should only be used to modify existing objects. To fill a new object with members, the method add(name, value) should be preferred which is much faster (as it does not need to search for existing members).

参数:

name - the name of the member to add

value - the value of the member to add

返回:

the object itself, to enable method chaining

set

public JSONObject set(String name,
                      JSONValue value)

Sets the value of the member with the specified name to the specified JSON value. If this object does not contain a member with this name, a new member is added at the end of the object. If this object contains multiple members with this name, only the last one is changed.

This method should only be used to modify existing objects. To fill a new object with members, the method add(name, value) should be preferred which is much faster (as it does not need to search for existing members).

参数:

name - the name of the member to add

value - the value of the member to add, must not be null

返回:

the object itself, to enable method chaining

remove

public JSONObject remove(String name)

Removes a member with the specified name from this object. If this object contains multiple members with the given name, only the last one is removed. If this object does not contain a member with the specified name, the object is not modified.

参数:

name - the name of the member to remove

返回:

the object itself, to enable method chaining

merge

public JSONObject merge(JSONObject object)

Copies all members of the specified object into this object. When the specified object contains members with names that also exist in this object, the existing values in this object will be replaced by the corresponding values in the specified object.

参数:

object - the object to merge

返回:

the object itself, to enable method chaining

get

public JSONValue get(String name)

Returns the value of the member with the specified name in this object. If this object contains multiple members with the given name, this method will return the last one.

参数:

name - the name of the member whose value is to be returned

返回:

the value of the last member with the specified name, or null if this object does not contain a member with that name

contains

public boolean contains(String name)

getInt

public Integer getInt(String name,
                      Integer defaultValue)

Returns the int value of the member with the specified name in this object. If this object does not contain a member with this name, the given default value is returned. If this object contains multiple members with the given name, the last one will be picked. If this member's value does not represent a JSON number or if it cannot be interpreted as Java int, an exception is thrown.

参数:

name - the name of the member whose value is to be returned

defaultValue - the value to be returned if the requested member is missing

返回:

the value of the last member with the specified name, or the given default value if this object does not contain a member with that name

getInt

public Integer getInt(String name)

getLong

public Long getLong(String name,
                    Long defaultValue)

Returns the long value of the member with the specified name in this object. If this object does not contain a member with this name, the given default value is returned. If this object contains multiple members with the given name, the last one will be picked. If this member's value does not represent a JSON number or if it cannot be interpreted as Java long, an exception is thrown.

参数:

name - the name of the member whose value is to be returned

defaultValue - the value to be returned if the requested member is missing

返回:

the value of the last member with the specified name, or the given default value if this object does not contain a member with that name

getLong

public Long getLong(String name)

getFloat

public Float getFloat(String name,
                      Float defaultValue)

Returns the float value of the member with the specified name in this object. If this object does not contain a member with this name, the given default value is returned. If this object contains multiple members with the given name, the last one will be picked. If this member's value does not represent a JSON number or if it cannot be interpreted as Java float, an exception is thrown.

参数:

name - the name of the member whose value is to be returned

defaultValue - the value to be returned if the requested member is missing

返回:

the value of the last member with the specified name, or the given default value if this object does not contain a member with that name

getFloat

public Float getFloat(String name)

getDouble

public Double getDouble(String name,
                        Double defaultValue)

Returns the double value of the member with the specified name in this object. If this object does not contain a member with this name, the given default value is returned. If this object contains multiple members with the given name, the last one will be picked. If this member's value does not represent a JSON number or if it cannot be interpreted as Java double, an exception is thrown.

参数:

name - the name of the member whose value is to be returned

defaultValue - the value to be returned if the requested member is missing

返回:

the value of the last member with the specified name, or the given default value if this object does not contain a member with that name

getDouble

public Double getDouble(String name)

getBoolean

public Boolean getBoolean(String name,
                          Boolean defaultValue)

Returns the boolean value of the member with the specified name in this object. If this object does not contain a member with this name, the given default value is returned. If this object contains multiple members with the given name, the last one will be picked. If this member's value does not represent a JSON true or false value, an exception is thrown.

参数:

name - the name of the member whose value is to be returned

defaultValue - the value to be returned if the requested member is missing

返回:

the value of the last member with the specified name, or the given default value if this object does not contain a member with that name

getBoolean

public boolean getBoolean(String name)

getString

public String getString(String name,
                        String defaultValue)

Returns the String value of the member with the specified name in this object. If this object does not contain a member with this name, the given default value is returned. If this object contains multiple members with the given name, the last one is picked. If this member's value does not represent a JSON string, an exception is thrown.

参数:

name - the name of the member whose value is to be returned

defaultValue - the value to be returned if the requested member is missing

返回:

the value of the last member with the specified name, or the given default value if this object does not contain a member with that name

getString

public String getString(String name)

size

public int size()

Returns the number of members (name/value pairs) in this object.

返回:

the number of members in this object

isEmpty

public boolean isEmpty()

Returns true if this object contains no members.

返回:

true if this object contains no members

names

public List<String> names()

Returns a list of the names in this object in document order. The returned list is backed by this object and will reflect subsequent changes. It cannot be used to modify this object. Attempts to modify the returned list will result in an exception.

返回:

a list of the names in this object

iterator

public Iterator<JSONObject.Member> iterator()

Returns an iterator over the members of this object in document order. The returned iterator cannot be used to modify this object.

指定者:

iterator 在接口中 Iterable<JSONObject.Member>

返回:

an iterator over the members of this object

isObject

public boolean isObject()

从类复制的说明: JSONValue

Detects whether this value represents a JSON object. If this is the case, this value is an instance of JSONObject.

覆盖:

isObject 在类中 JSONValue

返回:

true if this value is an instance of JsonObject

asJSONObject

public JSONObject asJSONObject()

从类复制的说明: JSONValue

Returns this JSON value as JSONObject, assuming that this value represents a JSON object. If this is not the case, an exception is thrown.

覆盖:

asJSONObject 在类中 JSONValue

返回:

a JSONObject for this value

hashCode

public int hashCode()

覆盖:

hashCode 在类中 JSONValue

equals

public boolean equals(Object obj)

从类复制的说明: 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

参数:

obj - the reference object with which to compare

返回:

true if this object is the same as the object argument; false otherwise