Skip navigation links

oracle.adfmf.framework.api
Class JSONBeanSerializationHelper

java.lang.Object
oracle.adfmf.framework.api.JSONBeanSerializationHelper

public class JSONBeanSerializationHelper

extends java.lang.Object

JSONBeanSerializationHelper will (de)serialize objects in and out of a JSON object.

The following classes are used to support this functionality:

• JSONSerializable - allows object developer the ability to implement their own custom JSON serialization
• PostJSONSerializable - provides object developers a hook to alter the JSON post the JSON serialization process
• JSONDeserializable - allows object developer the ability to implement their own custom JSON deserialization
• PostJSONDeserializable - provides object developers a hook to alter the JSON post the JSON deserialization process

Supported types:

• primitives : boolean, byte, char, double, float, int, long, and short
• Boxed types : Boolean, Byte, Character, Double, Float, Integer, Long, and Short
• Base objects: ISO8601DateTime, BigDecimal, BigInteger, and Collection
• Null objects: JSON object with defined ".null" properties
• Beans : using standard Java Bean reflection rules
• NOTE: transient fields will be ignored in the serialization process

See Also:

JSONSerializable, PostJSONSerializable, JSONDeserializable, PostJSONDeserializable, ISO8601DateTimeUtil

Constructor Summary

JSONBeanSerializationHelper()

Method Summary

static java.lang.Object	fromJSON(java.lang.Class type, java.lang.Object json) Method used to deserialize the passed-in Object to Java object.
static java.lang.Object	fromJSON(java.lang.Class type, java.lang.String jsonString) Method used to deserialize the passed-in Object to Java object.
static boolean	getBoolean(java.lang.Object object) Used to coerce an object into a boolean if possible.
static byte	getByte(java.lang.Object object) Used to coerce an object into a byte if possible.
static char	getCharacter(java.lang.Object object) Used to coerce an object into a char if possible.
static double	getDouble(java.lang.Object object) Used to coerce an object into a double if possible.
static float	getFloat(java.lang.Object object) Used to coerce an object into a float if possible.
static int	getIdFromJSONObject(oracle.adfmf.json.JSONObject jsonObj) Gets id from the json object and returns the corresponding int value Internal Utility Function
static int	getInteger(java.lang.Object object) Used to coerce an object into a int if possible.
static long	getLong(java.lang.Object object) Used to coerce an object into a long if possible.
static short	getShort(java.lang.Object object) Used to coerce an object into a short if possible.
static java.lang.String	getString(java.lang.Object object) Used to coerce an object into a String if possible.
static boolean	isObjectNull(java.lang.Object json) Utility method to determine if the JSON object is null.
static void	removeBooleanFromJSON(oracle.adfmf.json.JSONObject jsonObj, boolean bValue, java.lang.String[] keys) Normalizes the JSON object by removing the objects which contain specified boolean value.
static void	removeNegativesFromJSON(oracle.adfmf.json.JSONObject jsonObj, java.lang.String[] keys) Normalizes the JSON object by removing the objects which contain value: -1.
static void	removeNullsFromJSON(oracle.adfmf.json.JSONObject jsonObj, java.lang.String[] keys) Normalizes the JSON object by removing the objects which contain null's.
static java.lang.Object	toJSON(java.lang.Object obj) Method used to serialize the passed in Java object to JSON.

Methods inherited from class java.lang.Object

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

Constructor Detail

JSONBeanSerializationHelper

public JSONBeanSerializationHelper()

Method Detail

fromJSON

public static java.lang.Object fromJSON(java.lang.Class type,
                                        java.lang.String jsonString)
                                 throws java.lang.Exception

Method used to deserialize the passed-in Object to Java object. This is the same as calling
JSONBeanSerializationHelper.fromJSON(type, new JSONObject(jsonString));

Parameters:

type - Class to which JSON Object should be deserialized to

jsonString - String representing a JSON object.

Throws:

java.lang.Exception

fromJSON

public static java.lang.Object fromJSON(java.lang.Class type,
                                        java.lang.Object json)
                                 throws java.lang.Exception

Method used to deserialize the passed-in Object to Java object.

Please refer to the following for more advanced ideas:

• JSONDeserializable - If the application developer wants to override the functionality of this method, he can implement JSONDeserializable and can add his custom deserialization code in JSONDeserializable.fromJSON().
• PostJSONDeserializable - If the application developer wants a hook to alter the object after the deserialization process, he can implement PostJSONDeserializable and add his custom code in PostJSONDeserializable.modifyObject().

The basic deserialize method provide the following out of the box conversions:

• Primitives --> Boxed
• BigDecimal, BigInteger --> BigDecimal
• ISO8601DateTime --> String representation of date
• Vector --> List
• JSONObject --> null, JSONObject, or an instance of the fully qualified class name specified by JSONTokens.TYPE_PROPERTY
• JSONArray --> Object Array

For additional details, please refer to JSONBeanSerializationHelper for details of all object types.

Parameters:

type - Class to which JSON Object should be deserialized to

json - Object to be deserialized

Returns:

Java Object for the corresponding object passed in. (This java object is of type 'class' passed in.)

Throws:

java.lang.Exception

See Also:

JSONDeserializable, PostJSONDeseralizable, JSONBeanSerializationHelper, ISO8601DateTimeUtil

toJSON

public static java.lang.Object toJSON(java.lang.Object obj)
                               throws java.lang.Exception

Method used to serialize the passed in Java object to JSON.

Please refer to the following for more advanced ideas:

• JSONSerializable - If the application developer wants to override the functionality of this method, he can implement JSONSerializable and can add his custom serialization code in JSONSerializable.toJSON(). In that case, he bears the complete responsibility for detecting and avoiding cyclic objects as well.
• PostJSONSerializable - If the application developer wants a hook to alter the JSON after the JSON serialization process, he can implement PostJSONSerializable and add his custom code in PostJSONSerializable.modifyJSON(). In that case, he bears the complete responsibility for detecting and avoiding cyclic objects for his code.

The basic deserialize method provide the following out of the box conversions:

• Primitives --> Boxed
• BigDecimal --> Double (If the object value is outside the boundaries of what Double can hold or is a NaN, we throw an IllegalArgumentException)
• BigInteger --> Long (If the object value is outside the boundaries of Long, it flips the sign-bit and returns the corresponding value within the boundary)
• java.util.Date --> ISO8601DateTime (@see ISO8601DateTimeUtil)
• List --> Vector
• null, Map, GenericType, Class Instance Object --> JSONObject
• Arrays --> JSONArray
• NOTE: transient fields will be ignored in the serialization process

For additional details, please refer to JSONBeanSerializationHelper for details of all object types.

Parameters:

obj - Object to be serialized

Returns:

Object

Throws:

java.lang.Exception

See Also:

JSONSerializable, PostJSONSerializable

isObjectNull

public static boolean isObjectNull(java.lang.Object json)

Utility method to determine if the JSON object is null. Internal Utility Function

removeNullsFromJSON

public static void removeNullsFromJSON(oracle.adfmf.json.JSONObject jsonObj,
                                       java.lang.String[] keys)

Normalizes the JSON object by removing the objects which contain null's. Internal Utility Function

removeNegativesFromJSON

public static void removeNegativesFromJSON(oracle.adfmf.json.JSONObject jsonObj,
                                           java.lang.String[] keys)

Normalizes the JSON object by removing the objects which contain value: -1. Internal Utility Function

removeBooleanFromJSON

public static void removeBooleanFromJSON(oracle.adfmf.json.JSONObject jsonObj,
                                         boolean bValue,
                                         java.lang.String[] keys)

Normalizes the JSON object by removing the objects which contain specified boolean value. Internal Utility Function

getIdFromJSONObject

public static int getIdFromJSONObject(oracle.adfmf.json.JSONObject jsonObj)
                               throws oracle.adfmf.json.JSONException

Gets id from the json object and returns the corresponding int value Internal Utility Function

Throws:

oracle.adfmf.json.JSONException

getBoolean

public static boolean getBoolean(java.lang.Object object)
                          throws java.lang.Exception

Used to coerce an object into a boolean if possible.

Parameters:

object - to coerce

Returns:

the coerced value

Throws:

java.lang.Exception

getByte

public static byte getByte(java.lang.Object object)

Used to coerce an object into a byte if possible.

Parameters:

object - to coerce

Returns:

the coerced value

Throws:

java.lang.Exception

getCharacter

public static char getCharacter(java.lang.Object object)

Used to coerce an object into a char if possible.

Parameters:

object - to coerce

Returns:

the coerced value

Throws:

java.lang.Exception

getDouble

public static double getDouble(java.lang.Object object)

Used to coerce an object into a double if possible.

Parameters:

object - to coerce

Returns:

the coerced value

Throws:

java.lang.Exception

getFloat

public static float getFloat(java.lang.Object object)

Used to coerce an object into a float if possible.

Parameters:

object - to coerce

Returns:

the coerced value

Throws:

java.lang.Exception

getInteger

public static int getInteger(java.lang.Object object)

Used to coerce an object into a int if possible.

Parameters:

object - to coerce

Returns:

the coerced value

Throws:

java.lang.Exception

getLong

public static long getLong(java.lang.Object object)

Used to coerce an object into a long if possible.

Parameters:

object - to coerce

Returns:

the coerced value

Throws:

java.lang.Exception

getShort

public static short getShort(java.lang.Object object)

Used to coerce an object into a short if possible.

Parameters:

object - to coerce

Returns:

the coerced value

Throws:

java.lang.Exception

getString

public static java.lang.String getString(java.lang.Object object)

Used to coerce an object into a String if possible.

Parameters:

object - to coerce

Returns:

the coerced value

Throws:

java.lang.Exception

Skip navigation links