hu.ibello.transform

Interface JsonDeserializer

All Known Subinterfaces:

JsonTransformer

public interface JsonDeserializer

Utility interface which transforms JSON to java object.

During the deserialization the JSON name of the fields will be the same as in java. To change that, you can use SerializedName annotation on the java field.

Author:

Kornél Simon

Method Summary

Modifier and Type	Method and Description
<T> T	fromJson(Reader json, Type typeOfT) This method deserializes the JSON read from the specified reader into an object of the specified type.
<T> T	fromJson(String json, Type typeOfT) This method deserializes the specified JSON into an object of the specified type.
<T> List<T>	fromJsonToList(Reader json, Class<T> typeOfT) This method deserializes the specified JSON into a list of objects of the specified type.
<T> List<T>	fromJsonToList(String json, Class<T> typeOfT) This method deserializes the specified JSON into a list of objects of the specified type.

Method Detail

fromJson

<T> T fromJson(String json,
               Type typeOfT)
        throws TransformerException

This method deserializes the specified JSON into an object of the specified type. This method automatically boxes field values into JAXBElement. If you have the Json in a Reader instead of a String, use fromJson(Reader, Type) instead.

Type Parameters:

T - the type of the desired object

Parameters:

json - the string from which the object is to be deserialized

typeOfT - the specific genericized type of json

Returns:

an object of type T from the string. Returns null if json is null.

Throws:

TransformerException - if json is not a valid representation for an object of type typeOfT

fromJson

<T> T fromJson(Reader json,
               Type typeOfT)
        throws TransformerException

This method deserializes the JSON read from the specified reader into an object of the specified type. This method automatically boxes field values into JAXBElement. If you have the JSON in a String form instead of a Reader, use fromJson(String, Type) instead.

Type Parameters:

T - the type of the desired object

Parameters:

json - the reader producing Json from which the object is to be deserialized

typeOfT - the specific genericized type of json

Returns:

an object of type T from the string. Returns null if json is null.

Throws:

TransformerException - if json is not a valid representation for an object of type typeOfT

fromJsonToList

<T> List<T> fromJsonToList(String json,
                           Class<T> typeOfT)
                    throws TransformerException

This method deserializes the specified JSON into a list of objects of the specified type. This method automatically boxes field values into JAXBElement. If you have the Json in a Reader instead of a String, use fromJsonToList(Reader, Class) instead.

Type Parameters:

T - the type of the desired objects

Parameters:

json - the string from which the object is to be deserialized

typeOfT - the type of the desired objects

Returns:

a list with objects of type T. Returns null if json is null.

Throws:

TransformerException - if json is not a valid representation for an object of type typeOfT

fromJsonToList

<T> List<T> fromJsonToList(Reader json,
                           Class<T> typeOfT)
                    throws TransformerException

This method deserializes the specified JSON into a list of objects of the specified type. This method automatically boxes field values into JAXBElement. If you have the JSON in a String form instead of a Reader, use fromJsonToList(String, Class) instead.

Type Parameters:

T - the type of the desired objects

Parameters:

json - the string from which the object is to be deserialized

typeOfT - the type of the desired objects

Returns:

a list with objects of type T. Returns null if json is null.

Throws:

TransformerException - if json is not a valid representation for an object of type typeOfT