nl.talsmasoftware.context

Interface ContextSnapshot

public interface ContextSnapshot

Interface for a 'snapshot' that can capture the (then-) 'active context' from all known registered ContextManager implementations.
Obtain a new snapshot by calling ContextManagers.createContextSnapshot() which will include a snapshot for all supported Context types through their respective managers.

This allows for a generic method to:

1. Create a new snapshot of the active context (for all registered ContextManagers).
2. Pass the returned ContextSnapshot along to a background job.
3. Allow the background job to (temporary) reactivate the snapshot for some required code path.
4. The reactivation is also a Context of its own. Although it does not return any specific value, it must be closed when the work requiring the context snapshot is done. This prevents context values leaking in case the used threads are returned to some pool.

Author:

Sjoerd Talsma

Method Summary

Modifier and Type	Method and Description
Context<Void>	reactivate() This method activates all contained values by the snapshot in their respective Context implementations.

Method Detail

reactivate

Context<Void> reactivate()

This method activates all contained values by the snapshot in their respective Context implementations.

These reactivated contexts can all be closed at once by closing the returned Void context. The resulting context is Void, because it does not contain any value itself.

Returns:

A new reactivationcontext with the snapshot values that will be valid until closed (or new values are registered).