Package nl.talsmasoftware.concurrency.context

Class LegacyContext<T>

java.lang.Object

nl.talsmasoftware.concurrency.context.LegacyContext<T>

All Implemented Interfaces:

Closeable, AutoCloseable, Context<T>, nl.talsmasoftware.context.Context<T>

Deprecated.

This only exists to allows old ContextManagers to delegate to new implementations.

public class LegacyContext<T>
extends Object
implements Context<T>, nl.talsmasoftware.context.Context<T>

Author:

Sjoerd Talsma

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	LegacyContext(nl.talsmasoftware.context.Context<T> wrapped)	Deprecated.

Method Summary

Modifier and Type	Method	Description
void	close()	Deprecated. Closes this context and restores any context changes made by this object to the way things were before it got created.
T	getValue()	Deprecated. Returns the value associated with this context.
String	toString()	Deprecated.
static <T> Context<T>	wrap(nl.talsmasoftware.context.Context<T> ctx)	Deprecated.

Methods inherited from class java.lang.Object

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

Constructor Detail

LegacyContext

protected LegacyContext(nl.talsmasoftware.context.Context<T> wrapped)

Deprecated.

Method Detail

wrap

public static <T> Context<T> wrap(nl.talsmasoftware.context.Context<T> ctx)

Deprecated.

getValue

public T getValue()

Deprecated.

Description copied from interface: Context

Returns the value associated with this context.

Implementors should explicitly document the behaviour of this method after Context.close() was called. For example, it may be useful to always return null after a Context has been closed. Contrary, it may in some cases be useful to retain the existing value after the context is closed, so clients that have kept a reference can still have access to it.

Normally, for security-related contexts, it is wise to always return null from closed contexts.

Specified by:

getValue in interface Context<T>

Specified by:

getValue in interface nl.talsmasoftware.context.Context<T>

Returns:

The value associated with this context.

close

public void close()

Deprecated.

Description copied from interface: Context

Closes this context and restores any context changes made by this object to the way things were before it got created.

It must be possible to call this method multiple times. It is the responsibility of the implementor of this context to make sure that closing an already-closed context has no unwanted side-effects. A simple way to achieve this is by using an AtomicBoolean to make sure the 'closing' transition is executed only once.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Specified by:

close in interface Context<T>

Specified by:

close in interface nl.talsmasoftware.context.Context<T>

toString

public String toString()

Deprecated.

Overrides:

toString in class Object