Spec-Zone.ru › OpenJDK 25

Class 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)
Вычисляет начальное значение этой унаследуемой локальной переменной потока для дочернего потока как функцию значения родительского потока на момент создания дочернего потока.

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

get, initialValue, remove, set, withInitial

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

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

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

InheritableThreadLocal

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

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

childValue

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

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

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

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, концептуальные обзоры, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, 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/25/docs/api/java.base/java/lang/InheritableThreadLocal.html

Spec-Zone.ru

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