Package it.tidalwave.role.spi

Class DefaultContextManager

java.lang.Object

it.tidalwave.role.spi.DefaultContextManager

All Implemented Interfaces:

ContextManager

public class DefaultContextManager
extends java.lang.Object
implements ContextManager

Author:

Fabrizio Giudici

Nested Class Summary

Nested classes/interfaces inherited from interface it.tidalwave.role.ContextManager

ContextManager.Locator, ContextManager.Supplier<V>

Constructor Summary

Constructors

Constructor	Description
DefaultContextManager()

Method Summary

Modifier and Type	Method	Description
void	addGlobalContext(java.lang.Object context)	Adds a global context.
void	addLocalContext(java.lang.Object context)	Adds a local context.
<T> T	findContextOfType(java.lang.Class<T> contextType)	Finds a current context instance of the given type.
java.util.List<java.lang.Object>	getContexts()	Returns the list of current contexts, ordered by their priority.
void	removeGlobalContext(java.lang.Object context)	Removes a global context.
void	removeLocalContext(java.lang.Object context)	Removes a local context.
<V> V	runWithContext(java.lang.Object context, ContextManager.Supplier<V> task)	Runs a task associated with a new local context.
<V,T extends java.lang.Throwable> V	runWithContext(java.lang.Object context, Task<V,T> task)	Runs a Task associated with a new local context.
<V> V	runWithContexts(java.util.List<java.lang.Object> contexts, ContextManager.Supplier<V> task)	Runs a task associated with a new bunch of local contexts.
<V,T extends java.lang.Throwable> V	runWithContexts(java.util.List<java.lang.Object> contexts, Task<V,T> task)	Runs a Task associated with a new bunch of local contexts.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultContextManager

public DefaultContextManager()

Method Detail

getContexts

@Nonnull
public java.util.List<java.lang.Object> getContexts()

Returns the list of current contexts, ordered by their priority.

Specified by:

getContexts in interface ContextManager

Returns:

the list of current contexts

findContextOfType

@Nonnull
public <T> T findContextOfType(@Nonnull
                               java.lang.Class<T> contextType)
                        throws NotFoundException

Finds a current context instance of the given type.

Specified by:

findContextOfType in interface ContextManager

Type Parameters:

T - the static context type

Parameters:

contextType - the dynamic context type

Returns:

the requested context

Throws:

NotFoundException - if no context of that type is found

addGlobalContext

public void addGlobalContext(@Nonnull
                             java.lang.Object context)

Adds a global context.

Specified by:

addGlobalContext in interface ContextManager

Parameters:

context - the new context

removeGlobalContext

public void removeGlobalContext(@Nonnull
                                java.lang.Object context)

Removes a global context.

Specified by:

removeGlobalContext in interface ContextManager

Parameters:

context - the context

addLocalContext

public void addLocalContext(@Nonnull
                            java.lang.Object context)

Adds a local context.

Specified by:

addLocalContext in interface ContextManager

Parameters:

context - the new context

removeLocalContext

public void removeLocalContext(@Nonnull
                               java.lang.Object context)

Removes a local context.

Specified by:

removeLocalContext in interface ContextManager

Parameters:

context - the context

runWithContext

@Nonnull
public <V,T extends java.lang.Throwable> V runWithContext(@Nonnull
                                                                java.lang.Object context,
                                                                @Nonnull
                                                                Task<V,T> task)
                                                         throws T extends java.lang.Throwable

Runs a Task associated with a new local context.

Specified by:

runWithContext in interface ContextManager

Type Parameters:

V - the type of the returned value

T - the type of the exception that can be thrown

Parameters:

context - the context

task - the task

Returns:

the value produced by the task

Throws:

T - the exception(s) thrown by the task

T extends java.lang.Throwable

runWithContexts

@Nonnull
public <V,T extends java.lang.Throwable> V runWithContexts(@Nonnull
                                                                 java.util.List<java.lang.Object> contexts,
                                                                 @Nonnull
                                                                 Task<V,T> task)
                                                          throws T extends java.lang.Throwable

Runs a Task associated with a new bunch of local contexts.

Specified by:

runWithContexts in interface ContextManager

Type Parameters:

V - the type of the returned value

T - the type of the exception that can be thrown

Parameters:

contexts - the contexts

task - the task

Returns:

the value produced by the task

Throws:

T - the exception(s) thrown by the task

T extends java.lang.Throwable

runWithContext

public <V> V runWithContext(@Nonnull
                            java.lang.Object context,
                            @Nonnull
                            ContextManager.Supplier<V> task)

Runs a task associated with a new local context. This variant fits functional interfaces.

Specified by:

runWithContext in interface ContextManager

Type Parameters:

V - the type of the returned value of the task

Parameters:

context - the context

task - the task

Returns:

the value produced by the task

runWithContexts

public <V> V runWithContexts(@Nonnull
                             java.util.List<java.lang.Object> contexts,
                             @Nonnull
                             ContextManager.Supplier<V> task)

Runs a task associated with a new bunch of local contexts. This variant fits functional interfaces.

Specified by:

runWithContexts in interface ContextManager

Type Parameters:

V - the type of the returned value

Parameters:

contexts - the context

task - the task

Returns:

the value produced by the task