nl.talsmasoftware.context

Class ContextManagers

java.lang.Object

nl.talsmasoftware.context.ContextManagers

public final class ContextManagers
extends Object

Utility class to allow concurrent systems to take snapshots of all contexts from known ContextManager implementations.

Such a snapshot can be passed to a background task to allow the context to be reactivated in that background thread, until it gets closed again (preferably in a try-with-resources construct).

Author:

Sjoerd Talsma

Method Summary

Modifier and Type	Method and Description
static ContextSnapshot	createContextSnapshot() This method is able to create a 'snapshot' from the current active context from all known ContextManager implementations.

Methods inherited from class java.lang.Object

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

Method Detail

createContextSnapshot

public static ContextSnapshot createContextSnapshot()

This method is able to create a 'snapshot' from the current active context from all known ContextManager implementations.

This snapshot is returned as a single object that can be temporarily reactivated. Don't forget to close the reactivated context once you're done, preferably in a try-with-resources construct.

Note about propagation accross physical node boundaries: ContextSnapshot instances can be serialized to and reactivated on another node under strict conditions:

1. All context values must be serializable.
2. All ContextManager implementations that contain active contexts must be registered on the target node as well (but need not be serializable themselves).

Returns:

A new snapshot that can be reactivated elsewhere (e.g. a background thread or even another node) within a try-with-resources construct.