Интерфейс StructuredTaskScope.Configuration

Внешний интерфейс:: StructuredTaskScope^PREVIEW<T, R, R_X extends Throwable>

public static sealed interface StructuredTaskScope.Configuration

Configuration — это предварительная версия API платформы Java.

Программы могут использовать Configuration только при включённых предварительных функциях.

Предварительные функции могут быть удалены в одном из будущих выпусков или стать постоянными функциями платформы Java.

Представляет конфигурацию для StructuredTaskScope.

Конфигурация для StructuredTaskScope состоит из ThreadFactory для создания потоков, необязательного имени области и необязательного времени ожидания. Имя предназначено для мониторинга и управления.

Создание StructuredTaskScope с помощью метода open(UnaryOperator)^PREVIEW или open(Joiner, UnaryOperator)^PREVIEW позволяет использовать другую конфигурацию. Оператор, указанный для метода open, применяется к конфигурации по умолчанию и возвращает конфигурацию создаваемой StructuredTaskScope. Оператор может использовать определённые здесь методы с префиксом with-, чтобы указать компоненты конфигурации.

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

Начиная с версии:: 25

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

Модификатор и тип	Метод	Описание
`StructuredTaskScope.Configuration^PREVIEW`	`withName(String name)`	Возвращает новый объект `Configuration` с указанным именем области.
`StructuredTaskScope.Configuration^PREVIEW`	`withThreadFactory(ThreadFactory threadFactory)`	Возвращает новый объект `Configuration` с указанной фабрикой потоков.
`StructuredTaskScope.Configuration^PREVIEW`	`withTimeout(Duration timeout)`	Возвращает новый объект `Configuration` с указанным временем ожидания.

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

withThreadFactory

StructuredTaskScope.ConfigurationPREVIEW withThreadFactory(ThreadFactory threadFactory)

Возвращает новый объект Configuration с указанной фабрикой потоков. Остальные компоненты совпадают с компонентами этого объекта. Область использует фабрику потоков для создания потоков при запуске^PREVIEW подзадач.

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

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

Параметры:

threadFactory — фабрика потоков

Возвращает:

новый объект Configuration с указанной фабрикой потоков

См. также:

withName

StructuredTaskScope.ConfigurationPREVIEW withName(String name)

Возвращает новый объект Configuration с указанным именем области. Остальные компоненты совпадают с компонентами этого объекта. Области можно присваивать имя для мониторинга и управления.

Параметры:: name — имя
Возвращает:: новый объект Configuration с указанным именем области

withTimeout

StructuredTaskScope.ConfigurationPREVIEW withTimeout(Duration timeout)

Возвращает новый объект Configuration с указанным временем ожидания. Остальные компоненты совпадают с компонентами этого объекта.

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

Приложения, использующие крайние сроки, заданные как Instant, могут использовать Duration.between(Instant.now(), deadline) для вычисления времени ожидания для этого метода.

Параметры:

timeout — время ожидания

Возвращает:

новый объект Configuration с указанным временем ожидания

См. также:

© 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.