Интерфейс Thread.Builder

Все известные подинтерфейсы:: Thread.Builder.OfPlatform, Thread.Builder.OfVirtual

Вложенный класс:: Thread

public static sealed interface Thread.Builder permits Thread.Builder.OfPlatform, Thread.Builder.OfVirtual

Построитель объектов Thread и ThreadFactory.

Builder определяет методы для установки свойств Thread, таких как имя потока name. Это включает свойства, которые в противном случае были бы унаследованными. После установки создаётся Thread или ThreadFactory с помощью следующих методов:

Метод unstarted создаёт новый незапущенный Thread для выполнения задачи. Метод start Thread должен быть вызван для планирования потока для выполнения.
Метод start создаёт новый Thread для выполнения задачи и планирует выполнение потока.
Метод factory создаёт ThreadFactory.

Thread.Builder не является потокобезопасным. ThreadFactory, возвращаемый методом factory() построителя, является потокобезопасным.

Если не указано иное, передача null-аргумента методу в этом интерфейсе приводит к выбрасыванию NullPointerException.

С:

См. также:

Краткое описание вложенных классов

Модификатор и тип	Интерфейс	Описание
`static interface`	`Thread.Builder.OfPlatform`	Построитель для создания платформенного `Thread` или `ThreadFactory`, который создаёт платформенные потоки.
`static interface`	`Thread.Builder.OfVirtual`	Построитель для создания виртуального `Thread` или `ThreadFactory`, который создаёт виртуальные потоки.

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

Модификатор и тип	Метод	Описание
`ThreadFactory`	`factory()`	Возвращает `ThreadFactory` для создания потоков из текущего состояния построителя.
`Thread.Builder`	`inheritInheritableThreadLocals(boolean inherit)`	Устанавливает, унаследует ли поток начальные значения переменных inheritable-thread-local от потока-создателя.
`Thread.Builder`	`name(String name)`	Устанавливает имя потока.
`Thread.Builder`	`name(String prefix, long start)`	Устанавливает имя потока, которое является конкатенацией строкового префикса и строкового представления значения счётчика.
`Thread`	`start(Runnable task)`	Создаёт новый `Thread` из текущего состояния построителя и планирует его для выполнения.
`Thread.Builder`	`uncaughtExceptionHandler(Thread.UncaughtExceptionHandler ueh)`	Устанавливает обработчик необработанных исключений.
`Thread`	`unstarted(Runnable task)`	Создаёт новый `Thread` из текущего состояния построителя для выполнения заданной задачи.

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

name

Thread.Builder name(String name)

Устанавливает имя потока.

Параметры:: name - имя потока
Возвращает:: этот построитель

name

Thread.Builder name(String prefix, long start)

Устанавливает имя потока, которое является конкатенацией строкового префикса и строкового представления значения счётчика. Начальное значение счётчика — start. Оно увеличивается после создания Thread с помощью этого построителя, так что следующий поток получает имя с новым значением счётчика. ThreadFactory, созданный с помощью этого построителя, инициализируется текущим значением счётчика.


 ThreadFactory

увеличивает свою копию счётчика после того, как для создания Thread используется newThread.

Примечание API:

Следующий пример создаёт построитель, который вызывается дважды, чтобы запустить два потока с именами "worker-0" и "worker-1".

  Thread.Builder builder = Thread.ofPlatform().name("worker-", 0);
  Thread t1 = builder.start(task1);   // name "worker-0"
  Thread t2 = builder.start(task2);   // name "worker-1"

Параметры:

prefix - префикс имени потока

start - начальное значение счётчика

Возвращает:

этот построитель

Исключения:

IllegalArgumentException - если start отрицательно

inheritInheritableThreadLocals

Thread.Builder inheritInheritableThreadLocals(boolean inherit)

Устанавливает, унаследует ли поток начальные значения переменных inheritable-thread-local от потока-создателя. По умолчанию унаследует.

Параметры:: inherit - true унаследовать, false не унаследовать
Возвращает:: этот построитель

uncaughtExceptionHandler

Thread.Builder uncaughtExceptionHandler(Thread.UncaughtExceptionHandler ueh)

Устанавливает обработчик необработанных исключений.

Параметры:: ueh - обработчик необработанных исключений
Возвращает:: этот построитель

unstarted

Thread unstarted(Runnable task)

Создаёт новый Thread из текущего состояния построителя для выполнения заданной задачи. Метод start Thread должен быть вызван для планирования потока для выполнения.

Параметры:

task - объект, который будет выполнен при выполнении потока

Возвращает:

новый незапущенный поток

См. также:

start

Thread start(Runnable task)

Создаёт новый Thread из текущего состояния построителя и планирует его для выполнения.

Параметры:

task - объект, который будет выполнен при выполнении потока

Возвращает:

новый запущенный поток

См. также:

factory

ThreadFactory factory()

Возвращает ThreadFactory для создания потоков из текущего состояния построителя. Возвращаемый фабрика потоков безопасен для использования несколькими конкурирующими потоками.

Возвращает:: фабрика потоков для создания потоков

© 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/lang/Thread.Builder.html