org.symphonyoss.s2.canon.runtime

Interface IEntityFactory<E extends IEntity,B extends IEntity,M extends IModel>

Type Parameters:

E - The type of the entity produced by this factory.

B - The base type of the entity.

M - The type of the model to which the enclosing entity type belongs.

All Known Implementing Classes:

EntityFactory

public interface IEntityFactory<E extends IEntity,B extends IEntity,M extends IModel>

A factory for an enclosing entity type.

Author:

Bruce Skingle

Method Summary

Modifier and Type	Method and Description
M	getModel() Return the model to which this factory belongs.
E	newInstance(org.symphonyoss.s2.common.dom.json.ImmutableJsonObject jsonObject) Return a new entity instance created from the given JSON serialization.
com.google.common.collect.ImmutableList<E>	newInstanceList(org.symphonyoss.s2.common.dom.json.ImmutableJsonArray jsonArray) Return a list of new entity instances created from the given JSON array.
com.google.common.collect.ImmutableSet<E>	newInstanceSet(org.symphonyoss.s2.common.dom.json.ImmutableJsonArray jsonArray) Return a set of new entity instances created from the given JSON array.

Method Detail

getModel

M getModel()

Return the model to which this factory belongs.

Returns:

the model to which this factory belongs.

newInstance

E newInstance(org.symphonyoss.s2.common.dom.json.ImmutableJsonObject jsonObject)
       throws org.symphonyoss.s2.common.exception.InvalidValueException

Return a new entity instance created from the given JSON serialization.

Parameters:

jsonObject - The JSON serialized form of the required entity.

Returns:

An instance of the entity represented by the given serialized form.

Throws:

org.symphonyoss.s2.common.exception.InvalidValueException - If the given JSON is not valid.

newInstanceList

com.google.common.collect.ImmutableList<E> newInstanceList(org.symphonyoss.s2.common.dom.json.ImmutableJsonArray jsonArray)
                                                    throws org.symphonyoss.s2.common.exception.InvalidValueException

Return a list of new entity instances created from the given JSON array.

Parameters:

jsonArray - An array of the JSON serialized form of the required entity.

Returns:

A list of instances of the entity represented by the given serialized form.

Throws:

org.symphonyoss.s2.common.exception.InvalidValueException - If the given JSON is not valid.

newInstanceSet

com.google.common.collect.ImmutableSet<E> newInstanceSet(org.symphonyoss.s2.common.dom.json.ImmutableJsonArray jsonArray)
                                                  throws org.symphonyoss.s2.common.exception.InvalidValueException

Return a set of new entity instances created from the given JSON array.

Parameters:

jsonArray - An array of the JSON serialized form of the required entity.

Returns:

A set of instances of the entity represented by the given serialized form.

Throws:

org.symphonyoss.s2.common.exception.InvalidValueException - If the given JSON is not valid.