org.jboss.weld.context.BoundContext Maven / Gradle / Ivy
package org.jboss.weld.context;
import javax.enterprise.context.spi.Context;
/**
*
* Allows a thread-based context to be bound to some external instance storage
* (such as an HttpSession).
*
*
*
* A context may be detachable in which case a call to
* {@link ManagedContext#invalidate()} will detach the context from it's
* associated storage. A detached context is still usable (instances may be
* added or removed) however changes will not be written through to the
* underlying data store.
*
*
*
* Normally, a detachable context will have it's underlying bean store attached
* on a call to {@link ManagedContext#activate()} and detached on a call to
* {@link ManagedContext#deactivate()} however a subtype of {@link BoundContext}
* may change this behavior.
*
*
*
* If you call {@link #associate(Object)} you must ensure that you call
* {@link #dissociate(Object)} in all cases, otherwise you risk memory leaks.
*
*
* @author Pete Muir
*
* @param the type of the external instance storage
* @see ManagedContext
*/
public interface BoundContext extends Context
{
/**
* Associate the context with the storage (for this thread). Once
* {@link #associate(Object)} has been called, further calls to
* {@link #associate(Object)} will be ignored, until the context has been
* subsequently {@link #dissociate(Object)} from the storage.
*
* @param storage the external storage
* @return true if the storage was attached, otherwise false
*/
public boolean associate(S storage);
/**
* Dissociate the context from the storage (for this thread). The context
* will only dissociate from the same storage it associated with.
*
* @param storage the external storage
* @return true if the storage was dissociated
*/
public boolean dissociate(S storage);
}