org.json

Class AbstractUnmodifiableJSONObject

java.lang.Object

org.json.AbstractUnmodifiableJSONObject

All Implemented Interfaces:

JSONComponent, JSONObject

Direct Known Subclasses:

UnmodifiableJSONObject

Deprecated.

@Deprecated
public abstract class AbstractUnmodifiableJSONObject
extends java.lang.Object
implements JSONObject

Abstract implementation of JSONObject that only implements final versions of all the methods that change the state of the JSONOBject all of which are implemented as throwing an exception.

Field Summary

Fields inherited from interface org.json.JSONObject

EMPTY

Constructor Summary

Constructors

Constructor and Description
AbstractUnmodifiableJSONObject() Deprecated.

Method Summary

Modifier and Type	Method and Description
JSONObject	put(java.lang.String key, boolean value) Deprecated. Put a key/boolean pair in the JSONObject.
JSONObject	put(java.lang.String key, double value) Deprecated. Put a key/double pair in the JSONObject.
JSONObject	put(java.lang.String key, int value) Deprecated. Put a key/int pair in the JSONObject.
JSONObject	put(java.lang.String key, long value) Deprecated. Put a key/long pair in the JSONObject.
JSONObject	put(java.lang.String key, java.lang.Object value) Deprecated. Put a key/value pair in the JSONObject.
JSONObject	putOnce(java.lang.String key, java.lang.Object value) Deprecated. Put a key/value pair in the JSONObject, but only if the key and the value are both non-null, and only if there is not already a member with that name.
JSONObject	putOpt(java.lang.String key, java.lang.Object value) Deprecated. Put a key/value pair in the JSONObject, but only if the key and the value are both non-null.
java.lang.Object	remove(java.lang.String key) Deprecated. Remove a name and its value, if present.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.json.JSONObject

clone, equalsMap, get, getBoolean, getDouble, getDoubleObj, getInt, getJSONArray, getJSONObject, getLong, getString, has, isNull, keys, length, opt, optBoolean, optBoolean, optDouble, optDouble, optDoubleObj, optInt, optInt, optInteger, optInteger, optJSONArray, optJSONObject, optLong, optLong, optString, optString, sortedKeys

Methods inherited from interface org.json.JSONComponent

toString, toString, toString, write

Constructor Detail

AbstractUnmodifiableJSONObject

public AbstractUnmodifiableJSONObject()

Deprecated.

Method Detail

put

public final JSONObject put(java.lang.String key,
                            boolean value)
                     throws JSONException

Deprecated.

Description copied from interface: JSONObject

Put a key/boolean pair in the JSONObject.

Specified by:

put in interface JSONObject

Parameters:

key - A key string.

value - A boolean which is the value.

Returns:

this.

Throws:

JSONException - If the key is null.

put

public final JSONObject put(java.lang.String key,
                            double value)
                     throws JSONException

Deprecated.

Description copied from interface: JSONObject

Put a key/double pair in the JSONObject.

Specified by:

put in interface JSONObject

Parameters:

key - A key string.

value - A double which is the value.

Returns:

this.

Throws:

JSONException - If the key is null or if the number is invalid.

put

public final JSONObject put(java.lang.String key,
                            int value)
                     throws JSONException

Deprecated.

Description copied from interface: JSONObject

Put a key/int pair in the JSONObject.

Specified by:

put in interface JSONObject

Parameters:

key - A key string.

value - An int which is the value.

Returns:

this.

Throws:

JSONException - If the key is null.

put

public final JSONObject put(java.lang.String key,
                            long value)
                     throws JSONException

Deprecated.

Description copied from interface: JSONObject

Put a key/long pair in the JSONObject.

Specified by:

put in interface JSONObject

Parameters:

key - A key string.

value - A long which is the value.

Returns:

this.

Throws:

JSONException - If the key is null.

put

public final JSONObject put(java.lang.String key,
                            java.lang.Object value)
                     throws JSONException

Deprecated.

Description copied from interface: JSONObject

Put a key/value pair in the JSONObject. If the value is null, then the key will be removed from the JSONObject if it is present.

Specified by:

put in interface JSONObject

Parameters:

key - A key string.

value - An object which is the value. It should be of one of these types: Boolean, Double, Integer, JSONArray, JSONObject, Long, String, or the JSONObject.NULL object.

Returns:

this.

Throws:

JSONException - If the value is non-finite number or if the key is null.

putOnce

public final JSONObject putOnce(java.lang.String key,
                                java.lang.Object value)
                         throws JSONException

Deprecated.

Description copied from interface: JSONObject

Put a key/value pair in the JSONObject, but only if the key and the value are both non-null, and only if there is not already a member with that name.

Specified by:

putOnce in interface JSONObject

Returns:

his.

Throws:

JSONException - if the key is a duplicate

putOpt

public final JSONObject putOpt(java.lang.String key,
                               java.lang.Object value)
                        throws JSONException

Deprecated.

Description copied from interface: JSONObject

Put a key/value pair in the JSONObject, but only if the key and the value are both non-null.

Specified by:

putOpt in interface JSONObject

Parameters:

key - A key string.

value - An object which is the value. It should be of one of these types: Boolean, Double, Integer, JSONArray, JSONObject, Long, String, or the JSONObject.NULL object.

Returns:

this.

Throws:

JSONException - If the value is a non-finite number.

remove

public final java.lang.Object remove(java.lang.String key)

Deprecated.

Description copied from interface: JSONObject

Remove a name and its value, if present.

Specified by:

remove in interface JSONObject

Parameters:

key - The name to be removed.

Returns:

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