Package nl.talsmasoftware.context

Interface ContextManager<T>

public interface ContextManager<T>

This interface defines the contract for a ContextManager Service.

Concrete implementations can be registered by providing an implementation class with a default constructor, along with a class declaration in a service file called:
"/META-INF/services/nl.talsmasoftware.context.ContextManager"

That will take care of any active context being captured in ContextSnapshot instances managed by the ContextManagers utility class.

Author:

Sjoerd Talsma

Method Summary

Modifier and Type	Method	Description
Context<T>	getActiveContext()	This method returns the current context, or null if no context is currently active.
Context<T>	initializeNewContext(T value)	This method initializes a new context containing the specified value.

Method Detail

initializeNewContext

Context<T> initializeNewContext(T value)

This method initializes a new context containing the specified value.

Whether the value is allowed to be null is up to the implementation.

Parameters:

value - The value to initialize a new context for.

Returns:

The new active context containing the specified value which should be closed by the caller at the end of its lifecycle.

getActiveContext

Context<T> getActiveContext()

This method returns the current context, or null if no context is currently active.

Returns:

The active context or null if there is no context currently active.