de.alpharogroup.xml.json

Class JsonTransformer

java.lang.Object

de.alpharogroup.xml.json.JsonTransformer

public final class JsonTransformer
extends Object

The class JsonTransformer helps to transform json string to objects and back.

Method Summary

Modifier and Type	Method and Description
static com.fasterxml.jackson.databind.ObjectMapper	getObjectMapper() Gets the object mapper.
static com.fasterxml.jackson.databind.ObjectMapper	getObjectMapper(boolean newMapper) Gets the object mapper.
static <T> String	toJson(List<T> list) Creates from the given List to a json string.
static <T> String	toJson(T object) Creates from the given Object a json string.
static <T> String	toJson(T object, boolean newMapper) To json.
static <T> String	toJsonQuietly(T object) Creates from the given Object a json string.
static <T> T	toObject(String jsonString, Class<T> clazz) Transforms the given json string into a java object.
static <T> T	toObject(String jsonString, Class<T> clazz, boolean newMapper) Transforms the given json string into a java object.
static <T> T	toObject(String jsonString, Class<T> clazz, com.fasterxml.jackson.databind.Module... modules) Transforms the given json string into a java object.
static <T> List<T>	toObjectList(String jsonString, Class<T> clazz) Transforms the given json string into a java object list.

Methods inherited from class java.lang.Object

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

Method Detail

getObjectMapper

public static com.fasterxml.jackson.databind.ObjectMapper getObjectMapper()

Gets the object mapper.

Returns:

the object mapper

getObjectMapper

public static com.fasterxml.jackson.databind.ObjectMapper getObjectMapper(boolean newMapper)

Gets the object mapper.

Parameters:

newMapper - flag that indicates if a new ObjectMapper should be created. if true a new ObjectMapper will be created otherwise the ObjectMapper from this class will be returned.

Returns:

the object mapper

toJson

public static <T> String toJson(List<T> list)
                         throws com.fasterxml.jackson.core.JsonGenerationException,
                                com.fasterxml.jackson.databind.JsonMappingException,
                                IOException

Creates from the given List to a json string.

Type Parameters:

T - the generic type

Parameters:

list - the list

Returns:

the json string.

Throws:

com.fasterxml.jackson.core.JsonGenerationException - If an error occurs by writing json string

com.fasterxml.jackson.databind.JsonMappingException - the If an error occurs when mapping the string into Object

IOException - Signals that an I/O exception has occurred.

toJson

public static <T> String toJson(T object)
                         throws com.fasterxml.jackson.core.JsonProcessingException

Creates from the given Object a json string.

Type Parameters:

T - the generic type of the given argument

Parameters:

object - the object.

Returns:

the json string.

Throws:

com.fasterxml.jackson.core.JsonProcessingException - If an error occurs when converting object to String

toJson

public static <T> String toJson(T object,
                                boolean newMapper)
                         throws com.fasterxml.jackson.core.JsonProcessingException

To json.

Type Parameters:

T - the generic type

Parameters:

object - the object

newMapper - flag that indicates if a new ObjectMapper should be created. if true a new ObjectMapper will be created otherwise the ObjectMapper from this class will be returned.

Returns:

the string

Throws:

com.fasterxml.jackson.core.JsonProcessingException - If an error occurs when converting object to String

toJsonQuietly

public static <T> String toJsonQuietly(T object)

Creates from the given Object a json string. Note if an exception occurs null will be returned.

Type Parameters:

T - the generic type of the given argument

Parameters:

object - the object.

Returns:

the json string or null if an error occured by parsing.

toObject

public static <T> T toObject(String jsonString,
                             Class<T> clazz)
                      throws com.fasterxml.jackson.core.JsonParseException,
                             com.fasterxml.jackson.databind.JsonMappingException,
                             IOException

Transforms the given json string into a java object.

Type Parameters:

T - the generic type of the return type

Parameters:

jsonString - the json string

clazz - the clazz of the generic type

Returns:

the object

Throws:

com.fasterxml.jackson.core.JsonParseException - If an error occurs when parsing the string into Object

com.fasterxml.jackson.databind.JsonMappingException - the If an error occurs when mapping the string into Object

IOException - Signals that an I/O exception has occurred.

toObject

public static <T> T toObject(String jsonString,
                             Class<T> clazz,
                             boolean newMapper)
                      throws com.fasterxml.jackson.core.JsonParseException,
                             com.fasterxml.jackson.databind.JsonMappingException,
                             IOException

Transforms the given json string into a java object.

Type Parameters:

T - the generic type of the return type

Parameters:

jsonString - the json string

clazz - the clazz of the generic type

newMapper - flag that indicates if a new ObjectMapper should be created. if true a new ObjectMapper will be created otherwise the ObjectMapper from this class will be returned.

Returns:

the object

Throws:

com.fasterxml.jackson.core.JsonParseException - If an error occurs when parsing the string into Object

com.fasterxml.jackson.databind.JsonMappingException - the If an error occurs when mapping the string into Object

IOException - Signals that an I/O exception has occurred.

toObject

public static <T> T toObject(String jsonString,
                             Class<T> clazz,
                             com.fasterxml.jackson.databind.Module... modules)
                      throws com.fasterxml.jackson.core.JsonParseException,
                             com.fasterxml.jackson.databind.JsonMappingException,
                             IOException

Transforms the given json string into a java object.

Type Parameters:

T - the generic type of the return type

Parameters:

jsonString - the json string

clazz - the clazz of the generic type

modules - The modules to register for the mapper

Returns:

the object

Throws:

com.fasterxml.jackson.core.JsonParseException - If an error occurs when parsing the string into Object

com.fasterxml.jackson.databind.JsonMappingException - the If an error occurs when mapping the string into Object

IOException - Signals that an I/O exception has occurred.

toObjectList

public static <T> List<T> toObjectList(String jsonString,
                                       Class<T> clazz)
                                throws com.fasterxml.jackson.core.JsonParseException,
                                       com.fasterxml.jackson.databind.JsonMappingException,
                                       IOException

Transforms the given json string into a java object list.

Type Parameters:

T - the generic type of the return type

Parameters:

jsonString - the json string

clazz - the clazz of the generic type

Returns:

the list with the java objects.

Throws:

com.fasterxml.jackson.core.JsonParseException - If an error occurs when parsing the string into Object

com.fasterxml.jackson.databind.JsonMappingException - the If an error occurs when mapping the string into Object

IOException - Signals that an I/O exception has occurred.