Spec-Zone.ru › OpenJDK 21

Класс InheritableThreadLocal<T>

java.lang.Object
java.lang.ThreadLocal<T>
java.lang.InheritableThreadLocal<T>
Параметры типа:
T - тип значения наследуемого потокового локального хранилища
public class InheritableThreadLocal<T> extends ThreadLocal<T>
Этот класс расширяет ThreadLocal, чтобы обеспечить наследование значений от родительского потока к дочернему потоку: когда создается дочерний поток, дочерний поток получает начальные значения для всех наследуемых потоковых локальных переменных, для которых у родительского потока есть значения. Обычно значения дочернего потока будут идентичны значениям родительского потока; однако, значение дочернего потока может быть произвольной функцией значения родительского потока путем переопределения метода childValue в этом классе.

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

Примечание: во время создания нового thread возможно отказаться от получения начальных значений для наследуемых потоковых локальных переменных.

С тех пор:
1.2
См. также:
  • ThreadLocal
  • Thread.Builder.inheritInheritableThreadLocals(boolean)

Краткое описание конструкторов

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

Краткое описание методов

Модификатор и тип Метод Описание
protected T childValue(T parentValue)
Вычисляет начальное значение дочернего потока для этой наследуемой потоковой локальной переменной как функцию от значения родительского потока в момент создания дочернего потока.

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

get, initialValue, remove, set, withInitial

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

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

Подробное описание конструкторов

InheritableThreadLocal

public InheritableThreadLocal()
Создает наследуемую потоковую локальную переменную.

Подробное описание методов

childValue

protected T childValue(T parentValue)
Вычисляет начальное значение дочернего потока для этой наследуемой потоковой локальной переменной как функцию от значения родительского потока в момент создания дочернего потока. Этот метод вызывается внутри родительского потока перед запуском дочернего потока.

Этот метод просто возвращает свой входной аргумент и должен быть переопределен, если требуется другое поведение.

Параметры:
parentValue - значение родительского потока
Возвращает:
начальное значение дочернего потока

© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/InheritableThreadLocal.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API