com.atlassian.confluence.impl.vcache

Class VCacheRequestContextManager

java.lang.Object

com.atlassian.confluence.impl.vcache.VCacheRequestContextManager

All Implemented Interfaces:

VCacheRequestContextOperations

public class VCacheRequestContextManager
extends Object
implements VCacheRequestContextOperations

An implementation of VCacheRequestContextOperations, this class provides a single VCacheRequestContextOperations.doInRequestContext(Supplier, Action) method which handles the thread-local init/clear semantics internally.

Additionally, calls to the VCacheRequestContextOperations.doInRequestContext(Supplier, Action) method can be nested, allowing different levels of client code to ensure that the request context is initialized without worrying about whether or not it's already been done further up the call stack.

If getCurrentRequestContext() is invoked outside of the context of VCacheRequestContextOperations.doInRequestContext(Supplier, Action) this class will return a RequestContext which stubs out method calls, and which remembers no data. The RequestContext.partitionIdentifier() of this object will be the same "fallback" identifier passed as an argument to this class's constructor, and represents the "unknown tenant" state of code that hasn't initialised the context properly.

Since:

6.0

Nested Class Summary

Nested classes/interfaces inherited from interface com.atlassian.confluence.vcache.VCacheRequestContextOperations

VCacheRequestContextOperations.Action<T,X extends Throwable>

Constructor Summary

Constructors

Constructor and Description
VCacheRequestContextManager(VCachePartitionIdentifierProvider partitionIdentifierProvider)

Method Summary

Modifier and Type	Method and Description
<T,X extends Throwable> T	doInRequestContext(Supplier<String> partitionIdentiferSupplier, VCacheRequestContextOperations.Action<T,X> action) Executes the supplied action callback within a VCache RequestContext.
<T,X extends Throwable> T	doInRequestContext(VCacheRequestContextOperations.Action<T,X> action) Executes the supplied action callback within a VCache RequestContext, using the system default partition identifier.
com.atlassian.vcache.internal.RequestContext	getCurrentRequestContext() Returns a RequestContext for the current thread.
Runnable	initRequestContext()

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.atlassian.confluence.vcache.VCacheRequestContextOperations

doInRequestContext, withRequestContext, withRequestContext

Constructor Detail

VCacheRequestContextManager

public VCacheRequestContextManager(VCachePartitionIdentifierProvider partitionIdentifierProvider)

Method Detail

getCurrentRequestContext

@Nonnull
public com.atlassian.vcache.internal.RequestContext getCurrentRequestContext()

Returns a RequestContext for the current thread. If the thread is within a VCacheRequestContextOperations.doInRequestContext(Action) block, then a "real" context will be returned (i.e. one that memoizes context information). Otherwise, a "fake" context will be returned (i.e. one that does not memoize anything).

Returns:

the current thread's request context.

doInRequestContext

public <T,X extends Throwable> T doInRequestContext(VCacheRequestContextOperations.Action<T,X> action)
                                             throws X extends Throwable

Executes the supplied action callback within a VCache RequestContext, using the system default partition identifier.

Specified by:

doInRequestContext in interface VCacheRequestContextOperations

Type Parameters:

T - the return type of the callback

X - the exception type thrown by the callback

Parameters:

action - the callback to be executed within the request context

Returns:

the value returned by the callback

Throws:

X - the exception thrown by the callback

X extends Throwable

doInRequestContext

public <T,X extends Throwable> T doInRequestContext(Supplier<String> partitionIdentiferSupplier,
                                                    VCacheRequestContextOperations.Action<T,X> action)
                                             throws X extends Throwable

Executes the supplied action callback within a VCache RequestContext. If no request context is bound to the current thread, then one will be set up with the supplied partition identifier. Calls to this method may be nested. Nested calls will re-use the existing context bound by the first call. Nested calls must supply the same partition identifier as the first call.

Specified by:

doInRequestContext in interface VCacheRequestContextOperations

Type Parameters:

T - the return type of the callback

X - the exception type thrown by the callback

Parameters:

partitionIdentiferSupplier - the supplier for paritiotn identifier that will be used to create new request context, if necessary

action - the callback to be executed within the request context

Returns:

the value returned by the callback

Throws:

X - the exception thrown by the callback

X extends Throwable

initRequestContext

public Runnable initRequestContext()