com.haulmont.cuba.core.app.serialization

Interface EntitySerializationAPI

All Known Implementing Classes:

EntitySerialization

public interface EntitySerializationAPI

Class that is used for serialization and deserialization of entities to JSON.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ENTITY_NAME_PROP
static java.lang.String	INSTANCE_NAME_PROP
static java.lang.String	NAME

Method Summary

Modifier and Type	Method and Description
<T extends Entity> java.util.Collection<T>	entitiesCollectionFromJson(java.lang.String json, MetaClass metaClass, EntitySerializationOption... options) Deserializes a JSON array of objects to entities collection
<T extends Entity> T	entityFromJson(java.lang.String json, MetaClass metaClass, EntitySerializationOption... options) Deserializes a JSON object to the entity.
<T> T	objectFromJson(java.lang.String json, java.lang.Class<T> clazz, EntitySerializationOption... options) Deserializes an object of any class from JSON.
java.lang.String	objectToJson(java.lang.Object object, EntitySerializationOption... options) Serializes any custom POJO or collection of POJOs or JSON.
java.lang.String	toJson(java.util.Collection<? extends Entity> entities) An overloaded version of the toJson(Collection, View, EntitySerializationOption...) method with a null view parameter and with no serialization options.
java.lang.String	toJson(java.util.Collection<? extends Entity> entities, View view, EntitySerializationOption... options) Serializes a collection of entities to the JSON array.
java.lang.String	toJson(Entity entity) An overloaded version of the toJson(Entity, View, EntitySerializationOption...) method with a null view parameter and with no serialization options.
java.lang.String	toJson(Entity entity, View view, EntitySerializationOption... options) Serializes a single entity to the JSON object graph.

Field Detail

NAME

static final java.lang.String NAME

See Also:

Constant Field Values

ENTITY_NAME_PROP

static final java.lang.String ENTITY_NAME_PROP

See Also:

Constant Field Values

INSTANCE_NAME_PROP

static final java.lang.String INSTANCE_NAME_PROP

See Also:

Constant Field Values

Method Detail

toJson

java.lang.String toJson(Entity entity,
                        @Nullable
                        View view,
                        EntitySerializationOption... options)

Serializes a single entity to the JSON object graph.

If the view parameter is null then all loaded entity properties will be presented in JSON, otherwise only loaded properties that are in the view will be in the JSON object.

The options parameter specify some additional options for the serialization process. For example, repeated entities may be replaced with the object with the only "id" property, making the result JSON more compact. See EntitySerializationOption for details.

Additionally, an "_entityName" property is added to the JSON objects that represent an entity.

Parameters:

entity - an entity to be serialized

view - a view that defines which entity properties should be added to the result JSON object

options - options specifying how an entity should be serialized

Returns:

a string that represents a JSON object

toJson

java.lang.String toJson(java.util.Collection<? extends Entity> entities,
                        @Nullable
                        View view,
                        EntitySerializationOption... options)

Serializes a collection of entities to the JSON array. Method works like the toJson(Entity, View, EntitySerializationOption...), but return a JSON array as a result.

Parameters:

entities - a list of entities to be serialized

view - a view that defines which entity properties should be added to the result JSON object

options - options specifying how an entity should be serialized

Returns:

a string that represents a JSON array of objects.

toJson

java.lang.String toJson(Entity entity)

An overloaded version of the toJson(Entity, View, EntitySerializationOption...) method with a null view parameter and with no serialization options.

Parameters:

entity - an entity to be serialized

Returns:

a string that represents a JSON object

toJson

java.lang.String toJson(java.util.Collection<? extends Entity> entities)

An overloaded version of the toJson(Collection, View, EntitySerializationOption...) method with a null view parameter and with no serialization options.

Parameters:

entities - a collection of entities to be serialized

Returns:

a string that represent a JSON array which contains entity objects

objectToJson

java.lang.String objectToJson(java.lang.Object object,
                              EntitySerializationOption... options)

Serializes any custom POJO or collection of POJOs or JSON. If some field in POJO is an entity then this field will be serialized according to entity serialization rules. Date fields are serialized according to the format of the DateTimeDatatype.

Parameters:

object - any POJO or collection of POJOs

options - options specifying how a JSON object graph for fields with type 'Entity' will be serialized

Returns:

a string that represents a JSON object or JSON array

entityFromJson

<T extends Entity> T entityFromJson(java.lang.String json,
                                    @Nullable
                                    MetaClass metaClass,
                                    EntitySerializationOption... options)

Deserializes a JSON object to the entity.

The metaClass parameter defines a result entity metaClass. It is optional. It must be defined if the JSON object doesn't contain an "_entityName" property.

An entity may be serialized to the JSON in slightly different formats. The format is defined by the options parameter. See EntitySerializationOption for details.

Parameters:

json - a string that represents a JSON object

metaClass - a metaClass of the entity that will be created

options - options specifying how a JSON object graph was serialized

Returns:

an entity

entitiesCollectionFromJson

<T extends Entity> java.util.Collection<T> entitiesCollectionFromJson(java.lang.String json,
                                                                      @Nullable
                                                                      MetaClass metaClass,
                                                                      EntitySerializationOption... options)

Deserializes a JSON array of objects to entities collection

Parameters:

json - a string that represents a JSON array of objects

metaClass - a metaClass of the entities that will be created

options - options specifying how a JSON object graph was serialized

Returns:

an entities collection

objectFromJson

<T> T objectFromJson(java.lang.String json,
                     java.lang.Class<T> clazz,
                     EntitySerializationOption... options)

Deserializes an object of any class from JSON. Date fields are deserialized according to the DateTimeDatatype format, entities object and fields of Entity type are deserialized like in the entityFromJson(String, MetaClass, EntitySerializationOption...) method

Parameters:

json - a string that represents an object

clazz - java class of the object

options - options specifying how a JSON object graph was serialized

Returns:

deserialized object