org.apache.polygene.api.composite

Interface TransientBuilderFactory

All Known Subinterfaces:

Module, ModuleSpi

public interface TransientBuilderFactory

This factory creates TransientComposites and the TransientBuilders. TransientComposite instances are very flexible in what it can reference, but are restricted in where they can be used. So, TransientComposites are mainly recommended where Values, Entities and Services can not be used, but they can also not be used to store state, be serialized across a network or have automatic equals/hashCode calculations.

Method Summary

Modifier and Type	Method and Description
<T> T	newTransient(Class<T> mixinType, Object... uses) Instantiate a TransientComposite of the given type.
<T> TransientBuilder<T>	newTransientBuilder(Class<T> mixinType) Create a builder for creating new TransientComposites that implements the given TransientComposite type.

Method Detail

newTransientBuilder

<T> TransientBuilder<T> newTransientBuilder(Class<T> mixinType)
                                     throws NoSuchTransientTypeException

Create a builder for creating new TransientComposites that implements the given TransientComposite type.

Type Parameters:

T - Transient type

Parameters:

mixinType - an interface that describes the TransientComposite to be instantiated

Returns:

a TransientBuilder for creation of TransientComposites implementing the interface

Throws:

NoSuchTransientTypeException - if no composite extending the mixinType has been registered

newTransient

<T> T newTransient(Class<T> mixinType,
                   Object... uses)
            throws NoSuchTransientTypeException,
                   ConstructionException

Instantiate a TransientComposite of the given type.

Type Parameters:

T - Transient type

Parameters:

mixinType - the TransientComposite type to instantiate

uses - The objects that can be injected into mixins

Returns:

a new TransientComposite instance

Throws:

NoSuchTransientTypeException - if no composite extending the mixinType has been registered

ConstructionException - if the composite could not be instantiated