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.
com.google.common.collect.ImmutableList<E>	newImmutableList(org.symphonyoss.s2.common.dom.json.JsonArray<?> jsonArray) Return a list of new entity instances created from the given JSON array.
com.google.common.collect.ImmutableSet<E>	newImmutableSet(org.symphonyoss.s2.common.dom.json.JsonArray<?> jsonArray) Return a set of new entity instances created from the given JSON array.
E	newInstance(org.symphonyoss.s2.common.dom.json.ImmutableJsonObject jsonObject) Return a new entity instance created from the given JSON serialization.
List<E>	newMutableList(org.symphonyoss.s2.common.dom.json.JsonArray<?> jsonArray) Return a list of new entity instances created from the given JSON array.
Set<E>	newMutableSet(org.symphonyoss.s2.common.dom.json.JsonArray<?> 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.

newMutableList

List<E> newMutableList(org.symphonyoss.s2.common.dom.json.JsonArray<?> 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.

newMutableSet

Set<E> newMutableSet(org.symphonyoss.s2.common.dom.json.JsonArray<?> 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.

newImmutableList

com.google.common.collect.ImmutableList<E> newImmutableList(org.symphonyoss.s2.common.dom.json.JsonArray<?> 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.

newImmutableSet

com.google.common.collect.ImmutableSet<E> newImmutableSet(org.symphonyoss.s2.common.dom.json.JsonArray<?> 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.