org.json

Class JSONBuilder<A extends JSONArray,O extends JSONObject>

java.lang.Object

org.json.JSONBuilder<A,O>

Direct Known Subclasses:

ImmutableJSON, WritableJSON

public abstract class JSONBuilder<A extends JSONArray,O extends JSONObject>
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
JSONBuilder(java.lang.Class<A> jsonArrayClass, java.lang.Class<O> jsonObjectClass)

Method Summary

Modifier and Type	Method and Description
abstract A	cast(JSONArray source)
abstract O	cast(JSONObject source)
java.lang.Object	cast(java.lang.Object object)
A	clone(JSONArray source)
O	clone(JSONObject source)
abstract JSONArrayBuilder<A>	createJSONArrayBuilder()
abstract JSONObjectBuilder<O>	createJSONObjectBuilder()
A	emptyJSONArray() Create an empty JSONArray.
O	emptyJSONObject() Create an empty JSONObject.
java.lang.Class<A>	getJSONArrayClass()
java.lang.Class<O>	getJSONObjectClass()
A	toJSONArray(java.lang.Iterable<?> values)
A	toJSONArray(JSONArray source)
A	toJSONArray(JSONTokener<A,O> source)
A	toJSONArray(java.io.Reader source)
A	toJSONArray(java.lang.String source)
O	toJSONObject(JSONObject source)
O	toJSONObject(JSONTokener<A,O> source)
O	toJSONObject(java.io.Reader source)
O	toJSONObject(java.lang.String source)
java.lang.Object	wrap(java.lang.Object object) Wrap an object, if necessary.

Methods inherited from class java.lang.Object

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

Constructor Detail

JSONBuilder

public JSONBuilder(java.lang.Class<A> jsonArrayClass,
                   java.lang.Class<O> jsonObjectClass)

Method Detail

getJSONArrayClass

public final java.lang.Class<A> getJSONArrayClass()

getJSONObjectClass

public final java.lang.Class<O> getJSONObjectClass()

createJSONArrayBuilder

public abstract JSONArrayBuilder<A> createJSONArrayBuilder()

createJSONObjectBuilder

public abstract JSONObjectBuilder<O> createJSONObjectBuilder()

cast

public java.lang.Object cast(java.lang.Object object)
                      throws JSONException

Throws:

JSONException

wrap

public java.lang.Object wrap(java.lang.Object object)
                      throws JSONException

Wrap an object, if necessary. If the object is null, return the NULL object. If it is an array or collection, wrap it in a JSONArray. If it is a map, wrap it in a JSONObject. If it is a standard property (Double, String, et al) then it is already wrapped. Otherwise, if it comes from one of the java packages, turn it into a string. And if it doesn't, try to wrap it in a JSONObject. If the wrapping fails, then null is returned.

Parameters:

object - The object to wrap

Returns:

The wrapped value

Throws:

JSONException

clone

public A clone(JSONArray source)
        throws JSONException

Throws:

JSONException

cast

public abstract A cast(JSONArray source)

cast

public abstract O cast(JSONObject source)

emptyJSONArray

public A emptyJSONArray()

Create an empty JSONArray. If this JSONBuilder creates immutable implementations then this can be overridden with a singleton return.

toJSONArray

public A toJSONArray(java.lang.Iterable<?> values)

toJSONArray

public A toJSONArray(JSONArray source)

toJSONArray

public A toJSONArray(JSONTokener<A,O> source)
              throws JSONException

Throws:

JSONException

toJSONArray

public A toJSONArray(java.io.Reader source)
              throws JSONException

Throws:

JSONException

toJSONArray

public A toJSONArray(java.lang.String source)
              throws JSONException

Throws:

JSONException

clone

public O clone(JSONObject source)
        throws JSONException

Throws:

JSONException

emptyJSONObject

public O emptyJSONObject()

Create an empty JSONObject. If this JSONBuilder creates immutable implementations then this can be overridden with a singleton return.

toJSONObject

public O toJSONObject(JSONObject source)

toJSONObject

public O toJSONObject(JSONTokener<A,O> source)
               throws JSONException

Throws:

JSONException

toJSONObject

public O toJSONObject(java.io.Reader source)
               throws JSONException

Throws:

JSONException

toJSONObject

public O toJSONObject(java.lang.String source)
               throws JSONException

Throws:

JSONException