org.openjax.json

Class JSON

java.lang.Object

org.openjax.json.JSON

public final class JSON
extends Object

Lightweight toString(...) functions for marshaling Map (JSON object) and List (JSON array) into JSON document representations.

Method Summary

Modifier and Type	Method and Description
static String	toString(List<?> array) Returns a JSON document encoding (with no indentation) of the specified List<?> representing a JSON array, or null if array is null.
static String	toString(List<?> array, int indent) Returns a JSON document encoding (with the specified indentation) of the specified List<?> representing a JSON array, or null if array is null.
static String	toString(Map<String,?> object) Returns a JSON document encoding of the specified Map<String,?> representing a JSON object.
static String	toString(Map<String,?> object, int indent) Returns a JSON document encoding of the specified Map<String,?> representing a JSON object.

Methods inherited from class java.lang.Object

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

Method Detail

toString

public static String toString(Map<String,?> object)

Returns a JSON document encoding of the specified Map<String,?> representing a JSON object.

NOTE: The property values of the specified map may only be instances of Boolean, Number, String, List, and Map. Objects of other classes will result in an IllegalArgumentException.

Parameters:

object - The JSON object, represented as a Map<String,?>.

Returns:

A JSON document encoding of the specified Map<String,?> representing a JSON object.

Throws:

IllegalArgumentException - If a property value of the specified map is of a class that is not one of Boolean, Number, String, List, or Map.

NullPointerException - If properties is null.

toString

public static String toString(Map<String,?> object,
                              int indent)

Returns a JSON document encoding of the specified Map<String,?> representing a JSON object.

NOTE: The property values of the specified map may only be instances of Boolean, Number, String, List, and Map. Objects of other classes will result in an IllegalArgumentException.

Parameters:

object - The JSON object, represented as a Map<String,?>.

indent - Number of spaces to indent child elements. If the specified indent value is greater than 0, child elements are indented and placed on a new line. If the indent value is 0, child elements are not indented, nor placed on a new line.

Returns:

A JSON document encoding of the specified Map<String,?> representing a JSON object.

Throws:

IllegalArgumentException - If a property value of the specified map is of a class that is not one of Boolean, Number, String, List, or Map; or if indent is negative.

NullPointerException - If properties is null.

toString

public static String toString(List<?> array)

Returns a JSON document encoding (with no indentation) of the specified List<?> representing a JSON array, or null if array is null.

NOTE: The member values of the specified list may only be instances of Boolean, Number, String, List, and Map. Objects of other classes will result in an IllegalArgumentException.

Parameters:

array - The JSON array, represented as a List<?>.

Returns:

A JSON document encoding of the specified List<?> representing a JSON array, or null if array is null.

Throws:

IllegalArgumentException - If a member of the specified list is of a class that is not one of Boolean, Number, String, List, or Map.

toString

public static String toString(List<?> array,
                              int indent)

Returns a JSON document encoding (with the specified indentation) of the specified List<?> representing a JSON array, or null if array is null.

NOTE: The member values of the specified list may only be instances of Boolean, Number, String, List, and Map. Objects of other classes will result in an IllegalArgumentException.

Parameters:

array - The JSON array, represented as a List<?>.

indent - Number of spaces to indent child elements. If the specified indent value is greater than 0, child elements are indented and placed on a new line. If the indent value is 0, child elements are not indented, nor placed on a new line.

Returns:

A JSON document encoding of the specified List<?> representing a JSON array, or null if array is null.

Throws:

IllegalArgumentException - If a member of the specified list is of a class that is not one of Boolean, Number, String, List, or Map; or if indent is negative.