Package pl.morgwai.base.guice.scopes

Class TrackableContext<ContextT extends TrackableContext<ContextT>>

java.lang.Object

pl.morgwai.base.guice.scopes.InjectionContext

pl.morgwai.base.guice.scopes.TrackableContext<ContextT>

All Implemented Interfaces:

Serializable

public abstract class TrackableContext<ContextT extends TrackableContext<ContextT>>
extends InjectionContext

An InjectionContext that can execute tasks within itself, so that it can be tracked across Threads using its associated ContextTracker.

Subclasses must use themselves as ContextT type argument.

See Also:

Serialized Form

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	TrackableContext(ContextTracker<ContextT> tracker)

Method Summary

Modifier and Type	Method	Description
static void	executeWithinAll(List<TrackableContext<?>> contexts, Runnable task)	Variant of executeWithinAll(List, Callable) for Runnable tasks.
static <T> T	executeWithinAll(List<TrackableContext<?>> contexts, Callable<T> task)	Executes task synchronously on the current Thread within all contexts.
void	executeWithinSelf(Runnable task)	Variant of executeWithinSelf(Callable) for Runnable tasks.
<T> T	executeWithinSelf(Callable<T> task)	Asks the associated ContextTracker to set this Context as the current one for the calling Thread and executes task synchronously.
protected void	setTracker(ContextTracker<ContextT> tracker)	Sets a ContextTracker that will be used for tracking this Context.

Methods inherited from class pl.morgwai.base.guice.scopes.InjectionContext

prepareForSerialization, produceIfAbsent, removeScopedObject, restoreAfterDeserialization

Methods inherited from class java.lang.Object

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

Constructor Detail

TrackableContext

protected TrackableContext(ContextTracker<ContextT> tracker)

Method Detail

executeWithinSelf

public <T> T executeWithinSelf(Callable<T> task)
                        throws Exception

Asks the associated ContextTracker to set this Context as the current one for the calling Thread and executes task synchronously. Afterwards clears the current context.

Throws:

Exception

See Also:

executeWithinAll(List, Callable)

executeWithinSelf

public void executeWithinSelf(Runnable task)

Variant of executeWithinSelf(Callable) for Runnable tasks.

executeWithinAll

public static <T> T executeWithinAll(List<TrackableContext<?>> contexts,
                                     Callable<T> task)
                              throws Exception

Executes task synchronously on the current Thread within all contexts. Used to transfer Contexts saved with ContextTracker.getActiveContexts(List) after dispatching to another Thread.

Throws:

Exception

executeWithinAll

public static void executeWithinAll(List<TrackableContext<?>> contexts,
                                    Runnable task)

Variant of executeWithinAll(List, Callable) for Runnable tasks.

setTracker

protected void setTracker(ContextTracker<ContextT> tracker)

Sets a ContextTracker that will be used for tracking this Context. This method must be called once immediately after each deserialization of this Context.

Throws:

IllegalStateException - if a tracker for this Context has already been set.