openconnector

Class JsonUtil

java.lang.Object

openconnector.JsonUtil

public class JsonUtil
extends java.lang.Object

Utility class for rendering and parsing JSON.

Dates are rendered as strings, but they do not parse back as dates.

There are other utilities for this but they all seem to be way over-engineered for my taste. I just want to get a generic Map/List/String model through JSON. If you want to reflectively serialize arbitrary Java classes then use something else.

NOTE: This is part of the standalone integration jar and must have NO dependencies to IIQ classes other than the ones in this package, and it must NOT use JDK 1.5 features.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DATE_FORMAT Date format we render.
static boolean	SortMapKeys A global flag controlling whether we sort map keys before rendering.

Constructor Summary

Constructors

Constructor and Description
JsonUtil()

Method Summary

Modifier and Type	Method and Description
static java.util.Map<java.lang.String,java.lang.Object>	jsonToMap(JSONObject json) This method returns HashMap from JSON object
static java.lang.Object	parse(java.lang.String json) Public interface for parsing JSON that conforms to our restrictions.
static java.lang.String	render(java.lang.Object o) Public interface to rendering something as a JSON string.
static java.util.List<java.lang.Object>	toList(JSONArray array) Method to return list of Object from JSONArray

Methods inherited from class java.lang.Object

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

Field Detail

SortMapKeys

public static boolean SortMapKeys

A global flag controlling whether we sort map keys before rendering. This is normally false. It is intended for the unit tests that want to compare JSON renderings with previous renderings stored in files. Changes in JVMs can change the interaction order of map entries. In particular 1.5 Hashmap order appears to be random, but in 1.6 the keys come out sorted. By forcing them to render sorted we can use the same test files with different JVMs.

It probably wouldn't hurt to leave this on all the time, we shouldn't have many large maps?

DATE_FORMAT

public static final java.lang.String DATE_FORMAT

Date format we render. !! Need to think more about the canonical syntax.

See Also:

Constant Field Values

Constructor Detail

JsonUtil

public JsonUtil()

Method Detail

render

public static java.lang.String render(java.lang.Object o)
                               throws java.lang.Exception

Public interface to rendering something as a JSON string. A null value returns a null String, not the JSON string "null".

Throws:

java.lang.Exception

parse

public static java.lang.Object parse(java.lang.String json)

Public interface for parsing JSON that conforms to our restrictions.

jsonToMap

public static java.util.Map<java.lang.String,java.lang.Object> jsonToMap(JSONObject json)
                                                                  throws JSONException

This method returns HashMap from JSON object

Parameters:

json -

Returns:

Throws:

JSONException

toList

public static java.util.List<java.lang.Object> toList(JSONArray array)
                                               throws JSONException

Method to return list of Object from JSONArray

Parameters:

array -

Returns:

Throws:

JSONException