com.googlecode.fascinator.common

Class StorageDataUtil

java.lang.Object

com.googlecode.fascinator.common.StorageDataUtil

public class StorageDataUtil
extends Object

Utility class for stored data in JSON format

Author:

Linda Octalina, Andrew Brazzatti, Jianfeng Li

Constructor Summary

Constructors

Constructor and Description
StorageDataUtil()

Method Summary

Methods

Modifier and Type	Method and Description
String	encodeJson(String value) Safely escape the supplied string for use in JSON.
String	encodeXml(String value) Safely escape the supplied string for use in XML.
String	get(JsonSimple json, Object... field) Trivial wrapper for call into JSON Library.
String	getDateTime(String dateTime, String format) Cleanup the supplied datetime value into a W3C format.
String	getDefaultValueIfNull(JsonSimple json, String defaultValue, Object... field) Similar to get Method but return a string supplied by caller if cannot get the field
String	getEmptyIfNull(JsonSimple json, Object... field) Similar to get Method but return empty string instead of null
List<JsonObject>	getJavaList(JsonSimple json, String baseKey) getJavaList method to reconstruct an list of JSONObjects of a key from a JsonSimple object
Map<String,Object>	getList(JsonSimple json, String baseKey) Getlist method to get the values of key from the sourceMap
Map<String,Object>	getList(Map<String,Object> sourceMap, String baseKey) Getlist method to get the values of key from the sourceMap
String	getMetadata(DigitalObject object, String field) Utility method for accessing object properties.
JsonSimple	getPayloadJsonSimple(Payload payload) Get a playload in JsonSimple format from the payload instance
JsonSimple	getPayloadJsonSimple(Storage storage, String oid, String payloadName) Get a playload in JsonSimple format in the specified Storage instance by its object ID and the name of payload.
List<String>	getStringList(JsonSimple json, String baseKey) getStringList method to reconstruct an list of String of a key from a JsonSimple object
String	getW3CDateTime(String dateTime) Cleanup the supplied datetime value into a W3C format.

Methods inherited from class java.lang.Object

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

Constructor Detail

StorageDataUtil

public StorageDataUtil()

Method Detail

getPayloadJsonSimple

public JsonSimple getPayloadJsonSimple(Storage storage,
                              String oid,
                              String payloadName)

Get a playload in JsonSimple format in the specified Storage instance by its object ID and the name of payload. Useful for loading payloads which are in JSON format

Parameters:

storage - : Storage object

oid - : object ID

payloadName - : name of palyload

Returns:

JsonSimple or null

getPayloadJsonSimple

public JsonSimple getPayloadJsonSimple(Payload payload)

Get a playload in JsonSimple format from the payload instance

Parameters:

payload - : Payload object

Returns:

JsonSimple or null

getList

public Map<String,Object> getList(Map<String,Object> sourceMap,
                         String baseKey)

Getlist method to get the values of key from the sourceMap

Parameters:

sourceMap - Map container

baseKey - field to searchclass

Returns:

list of value based on baseKey

getList

public Map<String,Object> getList(JsonSimple json,
                         String baseKey)

Getlist method to get the values of key from the sourceMap

Parameters:

sourceMap - Map container

baseKey - field to search

Returns:

list of value based on baseKey

getJavaList

public List<JsonObject> getJavaList(JsonSimple json,
                           String baseKey)

getJavaList method to reconstruct an list of JSONObjects of a key from a JsonSimple object

Parameters:

json: - JsonSimple object of source

baseKey: - field to search

Returns:

List: a list of JsonObject based on baseKey

getStringList

public List<String> getStringList(JsonSimple json,
                         String baseKey)

getStringList method to reconstruct an list of String of a key from a JsonSimple object

Parameters:

json: - JsonSimple object of source

baseKey: - field to search

Returns:

List: a List of JsonObject based on baseKey

get

public String get(JsonSimple json,
         Object... field)

Trivial wrapper for call into JSON Library. Removes the difficulty of dealing with a null argument and a vararg from Velocity.

Parameters:

json: - The JSON object to get from

field: - The field in the JSON object to get

Returns:

String: The data in the field, possibly NULL

getEmptyIfNull

public String getEmptyIfNull(JsonSimple json,
                    Object... field)

Similar to get Method but return empty string instead of null

Parameters:

json: - The JSON object to get from

field: - The field in the JSON object to get

Returns:

String: The data in the field, possibly NULL

getDefaultValueIfNull

public String getDefaultValueIfNull(JsonSimple json,
                           String defaultValue,
                           Object... field)

Similar to get Method but return a string supplied by caller if cannot get the field

Parameters:

json: - The JSON object to get from

defaultValue: - The default value of the field

field: - The field in the JSON object to get

Returns:

String: The data in the field, possibly NULL

getW3CDateTime

public String getW3CDateTime(String dateTime)
                      throws ParseException

Cleanup the supplied datetime value into a W3C format.

Parameters:

dateTime - Datetime to clean

Returns:

String The cleaned value

Throws:

ParseException - if and incorrect input is supplied

getDateTime

public String getDateTime(String dateTime,
                 String format)
                   throws ParseException

Cleanup the supplied datetime value into a W3C format.

Parameters:

dateTime - Datetime to clean

Returns:

String The cleaned value

Throws:

ParseException - if and incorrect input is supplied

getMetadata

public String getMetadata(DigitalObject object,
                 String field)

Utility method for accessing object properties. Since null testing is awkward in velocity, an unset property is changed to en empty string ie. ("").

Parameters:

object: - The object to extract the property from

field: - The field name of the property

Returns:

String: The value of the property, or and empty string.

encodeXml

public String encodeXml(String value)

Safely escape the supplied string for use in XML.

Parameters:

value: - The string to escape

Returns:

String: The escaped string

encodeJson

public String encodeJson(String value)

Safely escape the supplied string for use in JSON.

Parameters:

value: - The string to escape

Returns:

String: The escaped string