org.jboss.arquillian.warp.spi

Class LifecycleManagerStore

java.lang.Object

org.jboss.arquillian.warp.spi.LifecycleManagerStore

public abstract class LifecycleManagerStore
extends Object

Holds associations of LifecycleManager with arbitrary objects.

In order to store binding, one can need to use object and its class/interface as key.

Once the binding is stored, one can use that object together with key to restore associated LifecycleManager.

This way, LifecycleManager can be propagated to arbitrary contexts without need of shared store (particularly this principle avoids use of ThreadLocal store.

Storing current references:

Author:

Lukas Fryc

Constructor Summary

Constructors

Constructor and Description
LifecycleManagerStore()

Method Summary

Methods

Modifier and Type	Method and Description
protected abstract <T> void	bind(LifecycleManager manager, Class<T> clazz, T object) Provides implementation of binding a current LifecycleManager with given object of given class.
protected abstract <T> void	checkUnbound(LifecycleManager manager) Checks that given manager does not have any associations in context of current store.
static <T> LifecycleManager	get(Class<T> type, T boundObject) Retrieves instance of LifecycleManager for given instance of given class.
protected abstract <T> LifecycleManager	obtain(Class<T> clazz, T object) Provides implementation of obtaining LifecycleManager for given instance of given class.
protected abstract <T> void	unbind(LifecycleManager manager, Class<T> clazz, T object) Provides implementation of binding a LifecycleManager for given class and given object.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LifecycleManagerStore

public LifecycleManagerStore()

Method Detail

get

public static <T> LifecycleManager get(Class<T> type,
                       T boundObject)
                            throws ObjectNotAssociatedException

Retrieves instance of LifecycleManager for given instance of given class.

Parameters:

clazz - the class used as denominator during retrieval

boundObject - the object used as key for retriving LifecycleManager

Returns:

the bound instance of LifecycleManager

Throws:

ObjectNotAssociatedException - when instance of no such class and class' instance was associated with any LifecycleManager

bind

protected abstract <T> void bind(LifecycleManager manager,
            Class<T> clazz,
            T object)
                      throws ObjectAlreadyAssociatedException

Provides implementation of binding a current LifecycleManager with given object of given class.

Parameters:

clazz - the class to be bound

object - the object to be bound

Throws:

ObjectAlreadyAssociatedException - when there is already object bound with LifecycleManager for given class.

unbind

protected abstract <T> void unbind(LifecycleManager manager,
              Class<T> clazz,
              T object)
                        throws ObjectNotAssociatedException

Provides implementation of binding a LifecycleManager for given class and given object.

Parameters:

clazz - the bound class

object - the bound class

Throws:

ObjectNotAssociatedException - when no object bound with LifecycleManager.

checkUnbound

protected abstract <T> void checkUnbound(LifecycleManager manager)
                              throws StoreHasAssociatedObjectsException

Checks that given manager does not have any associations in context of current store.

It ensures that all managers associated with bind(LifecycleManager, Class, Object) was properly unbound with unbind(LifecycleManager, Class, Object).

Parameters:

manager -

Throws:

ObjectNotAssociatedException

StoreHasAssociatedObjectsException

obtain

protected abstract <T> LifecycleManager obtain(Class<T> clazz,
                          T object)
                                    throws ObjectNotAssociatedException

Provides implementation of obtaining LifecycleManager for given instance of given class.

Parameters:

clazz - the class used as denominator during retrieval

boundObject - the object used as key for retriving LifecycleManager

Returns:

the bound instance of LifecycleManager

Throws:

ObjectNotAssociatedException - when instance of no such class and class' instance was associated with any LifecycleManager