Класс ThreadLocal<T>

public class ThreadLocal<T>
extends Object

Этот класс предоставляет переменные, локальные для потока. Эти переменные отличаются от обычных тем, что каждый поток, который обращается к одной из них (через метод get или set), имеет свою собственную, независимо инициализированную копию переменной. ThreadLocal обычно являются частными статическими полями в классах, которые хотят связать состояние с потоком (например, идентификатор пользователя или идентификатор транзакции).

Например, класс ниже генерирует уникальные идентификаторы, локальные для каждого потока. Идентификатор потока назначается в первый раз при вызове ThreadId.get() и остается неизменным при последующих вызовах.

import java.util.concurrent.atomic.AtomicInteger;

 public class ThreadId {
     // Atomic integer containing the next thread ID to be assigned
     private static final AtomicInteger nextId = new AtomicInteger(0);

     // Thread local variable containing each thread's ID
     private static final ThreadLocal<Integer> threadId =
         new ThreadLocal<Integer>() {
             @Override protected Integer initialValue() {
                 return nextId.getAndIncrement();
         }
     };

     // Returns the current thread's unique ID, assigning it if necessary
     public static int get() {
         return threadId.get();
     }
 }

Каждый поток содержит неявную ссылку на свою копию переменной, локальной для потока, пока поток жив и экземпляр ThreadLocal доступен; после того, как поток завершится, все его копии экземпляров, локальных для потока, подлежат сборке мусора (если не существует других ссылок на эти копии).

Конструкторы

ThreadLocal

public ThreadLocal()

Создаёт локальную переменную потока.

См. также:

withInitial(java.util.function.Supplier)

Методы

initialValue

protected T initialValue()

Возвращает:

начальное значение для этой локальной переменной потока

withInitial

public static <S> ThreadLocal<S> withInitial(Supplier<? extends S> supplier)

Создаёт локальную переменную потока. Начальное значение переменной определяется путём вызова метода get на Supplier.

Параметры типа:

S - тип значения локальной переменной потока

Параметры:

supplier - поставщик, используемый для определения начального значения

Возвращает:

новую локальную переменную потока

Исключения:

NullPointerException - если указанный поставщик равен null

С:

1.8

get

public T get()

Возвращает значение в копии переменной, локальной для текущего потока. Если для текущего потока переменная не имеет значения, она сначала инициализируется значением, возвращаемым методом initialValue().

Возвращает:

значение текущего потока этой локальной переменной

set

public void set(T value)

Устанавливает копию переменной, локальной для текущего потока, в указанное значение. Большинству подклассов не требуется переопределять этот метод, полагаясь только на метод initialValue() для установки значений локальных переменных потоков.

Параметры:

value - значение, которое будет храниться в копии переменной, локальной для текущего потока.

remove

public void remove()

Удаляет значение текущего потока для этой локальной переменной. Если эта локальная переменная потока впоследствии читается текущим потоком, её значение будет повторно инициализировано путём вызова метода initialValue(), если её значение не будет установлено текущим потоком во временном промежутке. Это может привести к многократным вызовам метода initialValue в текущем потоке.

С:

1.5