org.fossnova.json

Class JsonValueFactory

java.lang.Object

org.fossnova.json.JsonValueFactory

public abstract class JsonValueFactory
extends java.lang.Object

JSON values factory. Defines an abstract implementation of a factory for creating JSON values. All JSON values returned by this factory are not thread safe.

Author:

Richard Opalka

See Also:

JsonArray, JsonBoolean, JsonNumber, JsonObject, JsonString

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	JsonValueFactory() All implementations must provide public default constructor overriding this one.

Method Summary

Modifier and Type	Method and Description
static JsonValueFactory	getInstance() Returns JSON value factory instance.
abstract JsonArray	newJsonArray() Creates new JSON array.
abstract JsonBoolean	newJsonBoolean(java.lang.Boolean value) Creates new JSON boolean.
abstract JsonNumber	newJsonNumber(java.lang.Number value) Creates new JSON number.
abstract JsonObject	newJsonObject() Creates new JSON object.
abstract JsonString	newJsonString(java.lang.String value) Creates new JSON string.
abstract JsonValue	readFrom(java.io.InputStream input) Creates either JSON array or object instance using UTF-8 character set.
abstract JsonValue	readFrom(java.io.InputStream data, java.nio.charset.Charset charset) Creates either JSON array or object instance using specified character set.
abstract JsonValue	readFrom(JsonReader input) Creates either JSON array or object instance.
abstract JsonValue	readFrom(java.io.Reader input) Creates either JSON array or object instance.
abstract JsonValue	readFrom(java.lang.String input) Creates either JSON array or object instance.

Methods inherited from class java.lang.Object

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

Constructor Detail

JsonValueFactory

protected JsonValueFactory()

All implementations must provide public default constructor overriding this one.

Method Detail

getInstance

public static JsonValueFactory getInstance()

Returns JSON value factory instance.

Returns:

JSON value factory instance

newJsonObject

public abstract JsonObject newJsonObject()

Creates new JSON object.

Returns:

JSON object instance

newJsonArray

public abstract JsonArray newJsonArray()

Creates new JSON array.

Returns:

JSON array instance

newJsonBoolean

public abstract JsonBoolean newJsonBoolean(java.lang.Boolean value)

Creates new JSON boolean.

Parameters:

value - boolean value

Returns:

JSON boolean instance

newJsonNumber

public abstract JsonNumber newJsonNumber(java.lang.Number value)

Creates new JSON number.

Parameters:

value - number value

Returns:

JSON number instance

newJsonString

public abstract JsonString newJsonString(java.lang.String value)

Creates new JSON string.

Parameters:

value - string value

Returns:

JSON string instance

readFrom

public abstract JsonValue readFrom(JsonReader input)
                            throws java.io.IOException,
                                   JsonException

Creates either JSON array or object instance.

Parameters:

input - to read JSON from

Returns:

JSON array or object instance

Throws:

java.io.IOException - if some I/O error occurs

JsonException - if wrong JSON is detected

readFrom

public abstract JsonValue readFrom(java.io.Reader input)
                            throws java.io.IOException,
                                   JsonException

Creates either JSON array or object instance.

Parameters:

input - to read JSON from

Returns:

JSON array or object instance

Throws:

java.io.IOException - if some I/O error occurs

JsonException - if wrong JSON is detected

readFrom

public abstract JsonValue readFrom(java.lang.String input)
                            throws java.io.IOException,
                                   JsonException

Creates either JSON array or object instance.

Parameters:

input - to read JSON from

Returns:

JSON array or object instance

Throws:

java.io.IOException - if some I/O error occurs

JsonException - if wrong JSON is detected

readFrom

public abstract JsonValue readFrom(java.io.InputStream input)
                            throws java.io.IOException,
                                   JsonException

Creates either JSON array or object instance using UTF-8 character set.

Parameters:

input - to read JSON from

Returns:

JSON array or object instance

Throws:

java.io.IOException - if some I/O error occurs

JsonException - if wrong JSON is detected

readFrom

public abstract JsonValue readFrom(java.io.InputStream data,
                                   java.nio.charset.Charset charset)
                            throws java.io.IOException,
                                   JsonException

Creates either JSON array or object instance using specified character set.

Parameters:

data - JSON available via input stream

charset - character set

Returns:

JSON array or object instance

Throws:

java.io.IOException - if some I/O error occurs

JsonException - if wrong JSON is detected