hu.elte.eserial

Class Eserial

java.lang.Object

hu.elte.eserial.Eserial

public class Eserial
extends java.lang.Object

The main interface for the library. Provides methods to serialize an object to JSON and to parse one from JSON format. Using inner classes of the library is highly discouraged as those only cover parts of the serialization/deserialization process.

Method Summary

Modifier and Type	Method and Description
static <T> T	fromJson(java.lang.Class<T> clazz, java.lang.String json) Builds an object of the given type from the given JSON formatted String.
static java.lang.String	toJson(java.lang.Object object) Converts an object to JSON format.

Methods inherited from class java.lang.Object

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

Method Detail

toJson

public static java.lang.String toJson(java.lang.Object object)

Converts an object to JSON format. Handles recursion to not produce infinitely long Strings, processes various EserialAnnotations to customize the output.

Parameters:

object - an arbitrary object

Returns:

a JSON formatted String representing the object.

Throws:

EserialException - if any issues occur during the mapping or serialization process

fromJson

public static <T> T fromJson(java.lang.Class<T> clazz,
                             java.lang.String json)

Builds an object of the given type from the given JSON formatted String. Processes various EserialAnnotations to customize the interpretation of the input.

Type Parameters:

T - the type of the object to build

Parameters:

clazz - the type class of the object to build

json - a JSON formatted String

Returns:

an object of the given type, initialized from the given json

Throws:

EserialException - if any issues occur during the parsing or building process