compact1, compact2, compact3

java.lang

Класс ThreadLocal <T>

java.lang. Объект

java.lang. ThreadLocal <T>

Прямые Известные Подклассы:

InheritableThreadLocal

public class ThreadLocal<T>
extends Object

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

Например, class ниже генерирует уникальные идентификаторы, локальные для каждого потока. Идентификатор потока присваивается в первый раз, когда он вызывает 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 экземпляр доступен; после того, как поток уходит, все его копии локальных для потока экземпляров подвергаются сборке "мусора" (если другие ссылки на эти копии не существуют).

С тех пор:

1.2

Сводка конструктора

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

Конструктор и Описание
ThreadLocal() Создает локальную переменную потока.

Сводка метода

Модификатор и Тип	Метод и Описание
T	get() Возвращает значение в копии текущего потока этой локальной переменной потока.
protected T	initialValue() Возвращает "начальное значение" текущего потока для этой локальной переменной потока.
void	remove() Удаляет значение текущего потока для этой локальной переменной потока.
void	set(T value) Устанавливает копию текущего потока этой локальной переменной потока к указанному значению.
static <T> ThreadLocal<T>	withInitial(Supplier<? extends T> supplier) Создает локальную переменную потока.

Методы, наследованные от class java.lang. Объект

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

Деталь конструктора

ThreadLocal

public ThreadLocal()

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

См. Также:

withInitial(java.util.function.Supplier)

Деталь метода

initialValue

protected T initialValue()

Возвращает "начальное значение" текущего потока для этой локальной переменной потока. Этот метод будет вызван в первый раз, когда поток получает доступ к переменной с get() метод, если поток, ранее вызванный set(T) метод, когда initialValue метод не будет вызван для потока. Обычно, этот метод вызывается самое большее однажды на поток, но это может быть вызвано снова в случае последующих вызовов remove() сопровождаемый get().

Эта реализация просто возвращается null; если программист требует, чтобы у локальных переменных потока было начальное значение кроме null, ThreadLocal должен быть разделен на подклассы, и этот переопределенный метод. Как правило, анонимный внутренний class будет использоваться.

Возвраты:

начальное значение для этого локального для потока

withInitial

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

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

Параметры:

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

Возвраты:

локальная переменная нового потока

Броски:

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

С тех пор:

1.8

добраться

public T get()

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

Возвраты:

значение текущего потока этого локального для потока

набор

public void set(T value)

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

Параметры:

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

удалить

public void remove()

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

С тех пор:

1.5