JSONObject

NULL

Object NULL

标记值用于明确定义没有值的名称。 与null不同，名称具有此值：

• show up in the names() array
• show up in the keys() iterator
• return true for has(String)
• do not throw on get(String)
• are included in the encoded JSON string.

此值违反的总承包equals(Object)通过时相比，返回true null 。 它的toString()方法返回“null”。

JSONObject

JSONObject ()

创建一个没有名称/值映射的 JSONObject 。

JSONObject

JSONObject (Map copyFrom)

通过复制给定映射中的所有名称/值映射来创建新的 JSONObject 。

JSONObject

JSONObject (JSONTokener readFrom)

创建一个新 JSONObject与从tokener的下一个对象的名称/值映射。

JSONObject

JSONObject (String json)

使用来自JSON字符串的名称/值映射创建新的 JSONObject 。

JSONObject

JSONObject (JSONObject copyFrom, 
                String[] names)

通过复制给定对象中所列名称的映射来创建新的JSONObject 。 不在copyFrom中的copyFrom将被跳过。

accumulate

JSONObject accumulate (String name, 
                Object value)

将value附加到已映射到name的阵列。 如果此对象没有映射name ， name插入一个新的映射。 如果映射存在但其值不是数组，则现有值和新值name顺序插入到新映射到name数组中。 总的来说，这允许将值一次添加到映射中。

请注意， append(String, Object)提供了更好的语义。 特别是， name的映射将始终为JSONArray 。 使用accumulate将导致JSONArray或其类型为value类型的映射，具体取决于对其的调用次数。

get

Object get (String name)

返回由 name映射的值，或者如果不存在这样的映射则抛出。

getBoolean

boolean getBoolean (String name)

如果它存在且返回值为 name则该值为布尔值或可强制为布尔值，否则返回。

getDouble

double getDouble (String name)

如果它存在且返回值为 name ，则为double，或者可以强制为double，否则返回。

getInt

int getInt (String name)

如果它存在且返回值为 name则该值为int或可强制为int，否则返回。

getJSONArray

JSONArray getJSONArray (String name)

返回 name映射的值（如果它存在且为 JSONArray ，否则返回。

getJSONObject

JSONObject getJSONObject (String name)

如果它存在并且是 JSONObject ，则返回由 name映射的值，否则返回。

getLong

long getLong (String name)

如果它存在且返回由name映射的值， name该值长或可被强制为long，否则返回。 请注意，JSON表示数字为双打，所以这是lossy ; 使用字符串通过JSON传输数字。

getString

String getString (String name)

如果存在，则返回由 name映射的值，如有必要则强制该值，如果不存在此映射，则返回该值。

has

boolean has (String name)

如果此对象具有name的映射，则返回true。 映射可以是NULL 。

isNull

boolean isNull (String name)

如果这个对象有没有映射，则返回true name ，或者如果它有一个映射，其值是 NULL 。

keys

Iterator<String> keys ()

返回此对象中String名称的迭代器。 返回的迭代器支持remove ，它将从该对象中删除相应的映射。 如果在迭代器返回后修改该对象，则迭代器的行为是未定义的。 密钥的顺序是未定义的。

length

int length ()

返回此对象中的名称/值映射的数量。

names

JSONArray names ()

返回包含此对象中字符串名称的数组。 如果此对象不包含映射，则此方法返回null。

numberToString

String numberToString (Number number)

将数字编码为JSON字符串。

opt

Object opt (String name)

返回由 name映射的值，如果不存在这样的映射，则返回null。

optBoolean

boolean optBoolean (String name, 
                boolean fallback)

如果它存在并且是布尔值，则返回由 name映射的值，或者可以强制为布尔值，否则 fallback 。

optBoolean

boolean optBoolean (String name)

如果它存在并且是布尔值，则返回由 name映射的值，或者可以强制为布尔值，否则返回false。

optDouble

double optDouble (String name, 
                double fallback)

返回 name映射的值（如果它存在并且是双 name值或可以强制为双 fallback否则 fallback 。

optDouble

double optDouble (String name)

返回 name映射的值（如果它存在且为双 name值或可以强制为双 NaN否则 NaN 。

optInt

int optInt (String name, 
                int fallback)

返回 name映射的值（如果它存在并且是一个int或可以强制为int），否则 fallback 。

optInt

int optInt (String name)

如果它存在且返回值为 name则该值为int或可强制为int，否则返回0。

optJSONArray

JSONArray optJSONArray (String name)

返回 name映射的值（如果它存在且为 JSONArray ，否则返回null。

optJSONObject

JSONObject optJSONObject (String name)

返回 name映射的值（如果它存在且为 JSONObject ，否则返回null。

optLong

long optLong (String name)

返回name映射的值，如果它存在并且很长或可以强制为长name ，否则返回0。 请注意，JSON表示数字为双打，所以这是lossy ; 使用字符串通过JSON传输数字。

optLong

long optLong (String name, 
                long fallback)

返回name映射的值（如果它存在并且很长或可以强制为长fallback否则fallback 。 请注意，JSON表示数字为双打，所以这是lossy ; 使用字符串通过JSON传输数字。

optString

String optString (String name, 
                String fallback)

如果存在，则返回由 name映射的值，如有必要则强制 name该值，如果不存在此类映射，则 fallback 。

optString

String optString (String name)

如果存在，则返回由 name映射的值，如有必要则强制 name该值，如果不存在此类映射，则返回空字符串。

put

JSONObject put (String name, 
                double value)

映射 name到 value ，用相同的名称对任何现有名称/值映射进行破坏。

put

JSONObject put (String name, 
                boolean value)

映射 name到 value ，用相同的名称对任何现有的名称/值映射进行破坏。

put

JSONObject put (String name, 
                int value)

地图 name至 value ，使用相同名称对所有现有的名称/值映射进行破坏。

put

JSONObject put (String name, 
                long value)

地图 name至 value ，以同名的名称对所有现有名称/值映射进行破坏。

put

JSONObject put (String name, 
                Object value)

地图name至value ，使用相同名称对所有现有的名称/值映射进行破坏。 如果该值是null ，对于任何现有映射name被去除。

putOpt

JSONObject putOpt (String name, 
                Object value)

相当于put(name, value)当两个参数都非空时; 否则什么也不做。

quote

String quote (String data)

将data编码为JSON字符串。 这适用于引号和任何必要的字符转义。

remove

Object remove (String name)

删除指定的映射（如果存在）; 否则什么也不做。

toJSONArray

JSONArray toJSONArray (JSONArray names)

返回值为names的数组。 该数组对于未映射的名称包含空值。 如果names为null或空，则此方法返回null。

toString

String toString ()

将此对象编码为紧凑的JSON字符串，例如：

{"query":"Pizza","locations":[94043,90210]}

toString

String toString (int indentSpaces)

将此对象编码为用于调试的可读JSON字符串，例如：

 {
     "query": "Pizza",
     "locations": [
         94043,
         90210
     ]
 }

wrap

Object wrap (Object o)

必要时包裹给定的对象。

如果该对象为空或返回NULL 。 如果对象是JSONArray或JSONObject ，则不需要换行。 如果对象是NULL ，则不需要包装。 如果对象是数组或Collection ，则返回等效的JSONArray 。 如果对象是Map ，则返回相应的JSONObject 。 如果该对象是基本包装类型或String ，则返回该对象。 否则，如果对象来自java包，则返回toString的结果。 如果包装失败，则返回null。