org.symphonyoss.s2.canon.runtime

Interface IEntityFactory<E extends IEntity,S extends IEntity,B extends EntityBuilder>

Type Parameters:

E - The type of the entity produced by this factory, i.e. the facade.

S - The super type of the entity, i.e. the generated super class.

B - The builder type of the entity.

All Known Implementing Classes:

EntityFactory

public interface IEntityFactory<E extends IEntity,S extends IEntity,B extends EntityBuilder>

A factory for an enclosing entity type.

Author:

Bruce Skingle

Method Summary

Modifier and Type	Method and Description
B	newBuilder() Create a new builder with all fields initialized to default values.
B	newBuilder(S initial) Create a new builder with all fields initialized from the given builder.
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.
E	newInstance(S builder) Return a new entity instance created from the given other instance.
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

newBuilder

B newBuilder()

Create a new builder with all fields initialized to default values.

Returns:

A new builder.

newBuilder

B newBuilder(S initial)

Create a new builder with all fields initialized from the given builder. Values are copied so that subsequent changes to initial will not be reflected in the returned builder.

Parameters:

initial - A builder or instance whose values are copied into a new builder.

Returns:

A new builder.

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.

newInstance

E newInstance(S builder)
       throws org.symphonyoss.s2.common.exception.InvalidValueException

Return a new entity instance created from the given other instance. This is used to construct an entity from its builder as the builder also implements the interface of the entity.

Parameters:

builder - a builder containing values of all fields for the required entity.

Returns:

An instance of the entity represented by the given values.

Throws:

org.symphonyoss.s2.common.exception.InvalidValueException - If the given values are 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.