java.lang

Класс ThreadLocal <T>

java.lang. Объект

java.lang. ThreadLocal <T>

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

InheritableThreadLocal

public class ThreadLocal<T>
extends Object

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

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

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

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

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

ThreadLocal

public ThreadLocal()

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

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

initialValue

protected T initialValue()

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

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

Возвраты:

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

добраться

public T get()

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

Возвраты:

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

набор

public void set(T value)

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

Параметры:

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

удалить

public void remove()

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

С тех пор:

1.5