de.iip_ecosphere.platform.support.iip_aas.json

Class JsonUtils

java.lang.Object

de.iip_ecosphere.platform.support.iip_aas.json.JsonUtils

public class JsonUtils
extends Object

Some JSON utility methods, also reading/writing of specific types.

Author:

Holger Eichelberger, SSE, Lemur Project (BSD License)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JsonUtils.OptionalFieldsDeserializationProblemHandler A handler for optional fields.

Constructor Summary

Constructors

Constructor and Description
JsonUtils()

Method Summary

Modifier and Type	Method and Description
static void	defineOptionals(com.fasterxml.jackson.databind.ObjectMapper mapper, Class<?> cls, String... fieldNames) Defines the given fieldNames as optional during deserialization.
static String	escape(String input) Escapes an input string for JSON.
static <R> R	fromJson(Object json, Class<R> cls) Reads an Object from a JSON string.
static de.iip_ecosphere.platform.support.ServerAddress	serverAddressFromJson(Object json) Reads a ServerAddress from a JSON string.
static String	toJson(Object obj) Turns a ServerAddress into JSON.
static String	toJson(de.iip_ecosphere.platform.support.ServerAddress address) Turns a ServerAddress into JSON.
static String	unescape(String input) Unescapes an input string from JSON.

Methods inherited from class java.lang.Object

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

Constructor Detail

JsonUtils

public JsonUtils()

Method Detail

serverAddressFromJson

public static de.iip_ecosphere.platform.support.ServerAddress serverAddressFromJson(Object json)

Reads a ServerAddress from a JSON string.

Parameters:

json - the JSON value, usually a String

Returns:

the server address or null if reading fails

See Also:

toJson(ServerAddress)

toJson

public static String toJson(de.iip_ecosphere.platform.support.ServerAddress address)

Turns a ServerAddress into JSON.

Parameters:

address - the address (may be null)

Returns:

the JSON string or an empty string in case of problems/no address

See Also:

serverAddressFromJson(Object)

toJson

public static String toJson(Object obj)

Turns a ServerAddress into JSON.

Parameters:

obj - the object (may be null), must have getters/setters for all attributes and a no-arg constructor no-arg constructor

Returns:

the JSON string or an empty string in case of problems/no address

See Also:

fromJson(Object, Class)

fromJson

public static <R> R fromJson(Object json,
                             Class<R> cls)

Reads an Object from a JSON string.

Type Parameters:

R - the object type, must have getters/setters for all attributes and a no-arg constructor

Parameters:

json - the JSON value (usually a String)

cls - the class of the type to read

Returns:

the server address or null if reading fails

See Also:

toJson(Object)

escape

public static String escape(String input)

Escapes an input string for JSON. Taken over from Stackoverflow and Lemur Project. The respective methods from Apache Commons Lang3 are too slow for our purpose.

Parameters:

input - the input string

Returns:

the escaped string

unescape

public static String unescape(String input)

Unescapes an input string from JSON. Taken over from Stackoverflow and Lemur Project. The respective methods from Apache Commons Lang3 are too slow for our purpose.

Parameters:

input - the input string

Returns:

the unescaped string

defineOptionals

public static void defineOptionals(com.fasterxml.jackson.databind.ObjectMapper mapper,
                                   Class<?> cls,
                                   String... fieldNames)

Defines the given fieldNames as optional during deserialization.

Parameters:

mapper - the mapper to define the optionals on

cls - the cls the class fieldNames are member of

fieldNames - the field names (names of Java fields)