net.minidev.json
Class JSONValue

java.lang.Object
  net.minidev.json.JSONValue

public class JSONValue
extends Object

JSONValue is the helper class In most of case you should use those static methode to user JSON-smart The most commonly use methode are parse(String) toJSONString(Object)

Author:

Uriel Chemouni

Field Summary

static JSONStyle

COMPRESSION Global default compression type

Constructor Summary

JSONValue()

Method Summary

static String	compress(String s) Compress Json input keeping element order
static String	compress(String input, JSONStyle style) Reformat Json input keeping element order
static String	escape(String s)
static void	escape(String s, Appendable ap)
static void	escape(String s, Appendable ap, JSONStyle compression)
static String	escape(String s, JSONStyle compression) Escape quotes, \, /, \r, \n, \b, \f, \t and other control characters (U+0000 through U+001F).
static boolean	isValidJson(Reader in) Check Json Syntax from input Reader
static boolean	isValidJson(String s) Check Json Syntax from input String
static boolean	isValidJsonStrict(Reader in) Check RFC4627 Json Syntax from input Reader
static boolean	isValidJsonStrict(String s) check RFC4627 Json Syntax from input String
static Object	parse(byte[] in) Parse JSON text into java object from the input source.
static Object	parse(InputStream in) Parse JSON text into java object from the input source.
static Object	parse(Reader in) Parse JSON text into java object from the input source.
static Object	parse(String s) Parse JSON text into java object from the input source.
static Object	parseKeepingOrder(byte[] in) Parse Json input to a java Object keeping element order
static Object	parseKeepingOrder(InputStream in) Parse Json input to a java Object keeping element order
static Object	parseKeepingOrder(Reader in) Parse Json input to a java Object keeping element order
static Object	parseKeepingOrder(String in) Parse Json input to a java Object keeping element order
static Object	parseStrict(byte[] s) Parse valid RFC4627 JSON text into java object from the input source.
static Object	parseStrict(InputStream in) Parse valid RFC4627 JSON text into java object from the input source.
static Object	parseStrict(Reader in) Parse valid RFC4627 JSON text into java object from the input source.
static Object	parseStrict(String s) Parse valid RFC4627 JSON text into java object from the input source.
static Object	parseWithException(byte[] in) Parse JSON text into java object from the input source.
static Object	parseWithException(InputStream in) Parse JSON text into java object from the input source.
static Object	parseWithException(Reader in) Parse JSON text into java object from the input source.
static Object	parseWithException(String s) Parse JSON text into java object from the input source.
static void	SAXParse(InputStream input, ContentHandler handler) Parse Json Using SAX event handler
static void	SAXParse(Reader input, ContentHandler handler) Parse Json Using SAX event handler
static void	SAXParse(String input, ContentHandler handler) Parse Json Using SAX event handler
static String	toJSONString(Object value) Encode an object into JSON text and write it to out.
static String	toJSONString(Object value, JSONStyle compression) Convert an object to JSON text.
static String	uncompress(String s) Compress Json input keeping element order
static void	writeJSONString(Object value, Appendable out) Encode an object into JSON text and write it to out.
static void	writeJSONString(Object value, Appendable out, JSONStyle compression) Encode an object into JSON text and write it to out.

Methods inherited from class java.lang.Object

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

Field Detail

COMPRESSION

public static JSONStyle COMPRESSION

Global default compression type

Constructor Detail

JSONValue

public JSONValue()

Method Detail

parse

public static Object parse(byte[] in)

Parse JSON text into java object from the input source. Please use parseWithException() if you don't want to ignore the exception. if you want strict input check use parseStrict()

Returns:

Instance of the following: JSONObject, JSONArray, String, java.lang.Number, java.lang.Boolean, null

Since:

1.0.9-2

See Also:

JSONParser.parse(Reader), parseWithException(Reader)

parse

public static Object parse(InputStream in)

Parse JSON text into java object from the input source. Please use parseWithException() if you don't want to ignore the exception. if you want strict input check use parseStrict()

Returns:

Instance of the following: JSONObject, JSONArray, String, java.lang.Number, java.lang.Boolean, null

Since:

1.0.9-2

See Also:

JSONParser.parse(Reader), parseWithException(Reader)

parse

public static Object parse(Reader in)

Parse JSON text into java object from the input source. Please use parseWithException() if you don't want to ignore the exception. if you want strict input check use parseStrict()

Returns:

Instance of the following: JSONObject, JSONArray, String, java.lang.Number, java.lang.Boolean, null

See Also:

JSONParser.parse(Reader), parseWithException(Reader)

parse

public static Object parse(String s)

Parse JSON text into java object from the input source. Please use parseWithException() if you don't want to ignore the exception. if you want strict input check use parseStrict()

Returns:

Instance of the following: JSONObject, JSONArray, String, java.lang.Number, java.lang.Boolean, null

See Also:

JSONParser.parse(String), parseWithException(String)

parseKeepingOrder

public static Object parseKeepingOrder(byte[] in)

Parse Json input to a java Object keeping element order

Since:

1.0.9-2

parseKeepingOrder

public static Object parseKeepingOrder(InputStream in)

Parse Json input to a java Object keeping element order

Since:

1.0.9-2

parseKeepingOrder

public static Object parseKeepingOrder(Reader in)

Parse Json input to a java Object keeping element order

Since:

1.0.6.1

parseKeepingOrder

public static Object parseKeepingOrder(String in)

Parse Json input to a java Object keeping element order

Since:

1.0.6.1

SAXParse

public static void SAXParse(InputStream input,
                            ContentHandler handler)
                     throws ParseException,
                            IOException

Parse Json Using SAX event handler

Throws:

ParseException

IOException

Since:

1.0.9-2

SAXParse

public static void SAXParse(Reader input,
                            ContentHandler handler)
                     throws ParseException,
                            IOException

Parse Json Using SAX event handler

Throws:

ParseException

IOException

Since:

1.0.6.2

SAXParse

public static void SAXParse(String input,
                            ContentHandler handler)
                     throws ParseException

Parse Json Using SAX event handler

Throws:

ParseException

Since:

1.0.6.2

compress

public static String compress(String input,
                              JSONStyle style)

Reformat Json input keeping element order

Since:

1.0.6.2

compress

public static String compress(String s)

Compress Json input keeping element order

Since:

1.0.6.1

uncompress

public static String uncompress(String s)

Compress Json input keeping element order

Since:

1.0.6.1

parseWithException

public static Object parseWithException(byte[] in)
                                 throws IOException,
                                        ParseException

Parse JSON text into java object from the input source.

Returns:

Instance of the following: JSONObject, JSONArray, String, java.lang.Number, java.lang.Boolean, null

Throws:

IOException

ParseException

Since:

1.0.9-2

See Also:

JSONParser

parseWithException

public static Object parseWithException(InputStream in)
                                 throws IOException,
                                        ParseException

Parse JSON text into java object from the input source.

Returns:

Instance of the following: JSONObject, JSONArray, String, java.lang.Number, java.lang.Boolean, null

Throws:

IOException

ParseException

Since:

1.0.9-2

See Also:

JSONParser

parseWithException

public static Object parseWithException(Reader in)
                                 throws IOException,
                                        ParseException

Parse JSON text into java object from the input source.

Returns:

Instance of the following: JSONObject, JSONArray, String, java.lang.Number, java.lang.Boolean, null

Throws:

IOException

ParseException

See Also:

JSONParser

parseWithException

public static Object parseWithException(String s)
                                 throws ParseException

Parse JSON text into java object from the input source.

Returns:

Instance of the following: JSONObject, JSONArray, String, java.lang.Number, java.lang.Boolean, null

Throws:

ParseException

See Also:

JSONParser

parseStrict

public static Object parseStrict(InputStream in)
                          throws IOException,
                                 ParseException

Parse valid RFC4627 JSON text into java object from the input source.

Returns:

Instance of the following: JSONObject, JSONArray, String, java.lang.Number, java.lang.Boolean, null

Throws:

IOException

ParseException

Since:

1.0.9-2

See Also:

JSONParser

parseStrict

public static Object parseStrict(Reader in)
                          throws IOException,
                                 ParseException

Parse valid RFC4627 JSON text into java object from the input source.

Returns:

Instance of the following: JSONObject, JSONArray, String, java.lang.Number, java.lang.Boolean, null

Throws:

IOException

ParseException

See Also:

JSONParser

parseStrict

public static Object parseStrict(String s)
                          throws ParseException

Parse valid RFC4627 JSON text into java object from the input source.

Returns:

Instance of the following: JSONObject, JSONArray, String, java.lang.Number, java.lang.Boolean, null

Throws:

ParseException

See Also:

JSONParser

parseStrict

public static Object parseStrict(byte[] s)
                          throws ParseException

Parse valid RFC4627 JSON text into java object from the input source.

Returns:

Instance of the following: JSONObject, JSONArray, String, java.lang.Number, java.lang.Boolean, null

Throws:

ParseException

See Also:

JSONParser

isValidJsonStrict

public static boolean isValidJsonStrict(Reader in)
                                 throws IOException

Check RFC4627 Json Syntax from input Reader

Returns:

if the input is valid

Throws:

IOException

isValidJsonStrict

public static boolean isValidJsonStrict(String s)

check RFC4627 Json Syntax from input String

Returns:

if the input is valid

isValidJson

public static boolean isValidJson(Reader in)
                           throws IOException

Check Json Syntax from input Reader

Returns:

if the input is valid

Throws:

IOException

isValidJson

public static boolean isValidJson(String s)

Check Json Syntax from input String

Returns:

if the input is valid

writeJSONString

public static void writeJSONString(Object value,
                                   Appendable out)
                            throws IOException

Encode an object into JSON text and write it to out.

If this object is a Map or a List, and it's also a JSONStreamAware or a JSONAware, JSONStreamAware or JSONAware will be considered firstly.

Throws:

IOException

See Also:

JSONObject.writeJSON(Map, Appendable), JSONArray.writeJSONString(List, Appendable)

writeJSONString

public static void writeJSONString(Object value,
                                   Appendable out,
                                   JSONStyle compression)
                            throws IOException

Encode an object into JSON text and write it to out.

If this object is a Map or a List, and it's also a JSONStreamAware or a JSONAware, JSONStreamAware or JSONAware will be considered firstly.

Throws:

IOException

See Also:

JSONObject.writeJSON(Map, Appendable), JSONArray.writeJSONString(List, Appendable)

toJSONString

public static String toJSONString(Object value)

Encode an object into JSON text and write it to out.

If this object is a Map or a List, and it's also a JSONStreamAware or a JSONAware, JSONStreamAware or JSONAware will be considered firstly.

See Also:

JSONObject.writeJSON(Map, Appendable), JSONArray.writeJSONString(List, Appendable)

toJSONString

public static String toJSONString(Object value,
                                  JSONStyle compression)

Convert an object to JSON text.

If this object is a Map or a List, and it's also a JSONAware, JSONAware will be considered firstly.

DO NOT call this method from toJSONString() of a class that implements both JSONAware and Map or List with "this" as the parameter, use JSONObject.toJSONString(Map) or JSONArray.toJSONString(List) instead.

Returns:

JSON text, or "null" if value is null or it's an NaN or an INF number.

See Also:

JSONObject.toJSONString(Map), JSONArray.toJSONString(List)

escape

public static String escape(String s)

escape

public static String escape(String s,
                            JSONStyle compression)

Escape quotes, \, /, \r, \n, \b, \f, \t and other control characters (U+0000 through U+001F).

escape

public static void escape(String s,
                          Appendable ap)

escape

public static void escape(String s,
                          Appendable ap,
                          JSONStyle compression)