com.atlassian.vcache.internal.core

Class ThreadLocalRequestContextSupplier

java.lang.Object

com.atlassian.vcache.internal.core.ThreadLocalRequestContextSupplier

All Implemented Interfaces:

Supplier<RequestContext>

public class ThreadLocalRequestContextSupplier
extends Object
implements Supplier<RequestContext>

Implementation of Supplier for RequestContext that manages an instance per thread.

Notes:

• This class scopes thread-local variables to the instance. So two instances of ThreadLocalRequestContextSupplier will have separate instances of ThreadLocal.
• Using a lenient supplier will break TransactionalExternalCaches. So bewarned.
• Before a thread can call get(), the method initThread(String) must have been called, unless a lenient supplier is created.
• The methods initThread(String) and clearThread() are not re-entrant. Each call to initThread(String) must be paired with a subsequent call to clearThread().

Since:

1.0.0

Method Summary

Modifier and Type	Method and Description
void	clearThread() Clears the thread's RequestContext.
RequestContext	get()
void	initThread(String partitionId) Initialises the thread's RequestContext.
static ThreadLocalRequestContextSupplier	lenientSupplier(Supplier<String> partitionIdSupplier) Returns a lenient supplier, which will break TransactionalExternalCaches.
static ThreadLocalRequestContextSupplier	strictSupplier() Returns a strict supplier.

Methods inherited from class java.lang.Object

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

Method Detail

strictSupplier

public static ThreadLocalRequestContextSupplier strictSupplier()

Returns a strict supplier.

lenientSupplier

public static ThreadLocalRequestContextSupplier lenientSupplier(Supplier<String> partitionIdSupplier)

Returns a lenient supplier, which will break TransactionalExternalCaches.

Parameters:

partitionIdSupplier - the supplier of partitionId's.

get

public RequestContext get()

Specified by:

get in interface Supplier<RequestContext>

initThread

public void initThread(String partitionId)

Initialises the thread's RequestContext.

Parameters:

partitionId - the identifier for the partition. Will be validated using NameValidator.requireValidPartitionIdentifier(String).

clearThread

public void clearThread()

Clears the thread's RequestContext.