org.datanucleus.api.rest

Class RESTUtils

java.lang.Object

org.datanucleus.api.rest.RESTUtils

public class RESTUtils
extends Object

Series of convenience methods for manipulating JSONObject objects.

Constructor Summary

Constructors

Constructor and Description
RESTUtils()

Method Summary

Modifier and Type	Method and Description
static Object	getIdentityForURLToken(org.datanucleus.metadata.AbstractClassMetaData cmd, String token, org.datanucleus.PersistenceNucleusContext nucCtx)
static JSONArray	getJSONArrayFromCollection(Collection coll, org.datanucleus.ExecutionContext ec) Method to convert the provided POJO into its equivalent JSONObject.
static JSONObject	getJSONObjectFromPOJO(Object obj, org.datanucleus.ExecutionContext ec) Method to convert the provided POJO into its equivalent JSONObject.
static Object	getNonPersistableObjectFromJSONObject(JSONObject jsonobj, Class cls, org.datanucleus.NucleusContext nucCtx) Deserialise from JSON to an object.
static Object	getObjectFromJSONObject(JSONObject jsonobj, String className, org.datanucleus.ExecutionContext ec) Method to convert the provided JSONObject into its equivalent object.

Methods inherited from class java.lang.Object

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

Constructor Detail

RESTUtils

public RESTUtils()

Method Detail

getJSONArrayFromCollection

public static JSONArray getJSONArrayFromCollection(Collection coll,
                                                   org.datanucleus.ExecutionContext ec)

Method to convert the provided POJO into its equivalent JSONObject.

Parameters:

coll - Collection of POJOs

ec - ExecutionContext

Returns:

The JSONObject

getJSONObjectFromPOJO

public static JSONObject getJSONObjectFromPOJO(Object obj,
                                               org.datanucleus.ExecutionContext ec)

Method to convert the provided POJO into its equivalent JSONObject.

Parameters:

obj - The object

ec - ExecutionContext

Returns:

The JSONObject

getObjectFromJSONObject

public static Object getObjectFromJSONObject(JSONObject jsonobj,
                                             String className,
                                             org.datanucleus.ExecutionContext ec)

Method to convert the provided JSONObject into its equivalent object. If it represents a POJO and the POJO is persistent then retrieves it and superimposes the JSONObject values. If it represents a POJO and the POJO is not yet persistent then creates it with the JSONObject values. Also allows some specific non-persistable object types. Throws ClassNotResolvedException when the class is not found. Throws JDOFatalUserException if other error occurred.

Parameters:

jsonobj - JSONObject

className - Name of the class

ec - ExecutionContext

Returns:

The Object being represented

getIdentityForURLToken

public static Object getIdentityForURLToken(org.datanucleus.metadata.AbstractClassMetaData cmd,
                                            String token,
                                            org.datanucleus.PersistenceNucleusContext nucCtx)

getNonPersistableObjectFromJSONObject

public static Object getNonPersistableObjectFromJSONObject(JSONObject jsonobj,
                                                           Class cls,
                                                           org.datanucleus.NucleusContext nucCtx)

Deserialise from JSON to an object. Used for non-persistable classes. TODO Remove this and make it pluggable so people can provide handlers for their own types. We need a way of going to JSON from one of these types too!

Parameters:

jsonobj - JSONObject

cls - The class

nucCtx - NucleusContext

Returns:

The object of the specified class