Интерфейс StructuredTaskScope.Configuration
- Внешний интерфейс:
StructuredTaskScopePREVIEW<T,R>
public static sealed interface StructuredTaskScope.Configuration
Configuration — это предварительная версия API платформы Java. StructuredTaskScope. Конфигурация для StructuredTaskScope состоит из ThreadFactory для создания потоков, необязательного имени для мониторинга и управления, а также необязательного времени ожидания.
При создании StructuredTaskScope с помощью StructuredTaskScope.open()PREVIEW или StructuredTaskScope.open(Joiner)PREVIEW используется конфигурация по умолчанию. Конфигурация по умолчанию включает фабрику потоков, создающую безымянные виртуальные потоки, не предусматривает имени для мониторинга и управления и не задаёт время ожидания.
При создании StructuredTaskScope с помощью его двухаргументного метода openPREVIEW можно использовать другую конфигурацию. Функция, указанная в методе open, применяется к конфигурации по умолчанию и возвращает конфигурацию для создаваемого StructuredTaskScope. Функция может использовать определённые здесь методы с префиксом with-, чтобы задать компоненты используемой конфигурации.
Если не указано иное, передача аргумента null методу этого класса приводит к возникновению исключения NullPointerException.
- Начиная с версии:
- 25
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
StructuredTaskScope.ConfigurationPREVIEW |
withName |
Возвращает новый объект Configuration с указанным именем. |
StructuredTaskScope.ConfigurationPREVIEW |
withThreadFactory |
Возвращает новый объект Configuration с указанной фабрикой потоков. |
StructuredTaskScope.ConfigurationPREVIEW |
withTimeout |
Возвращает новый объект 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/concurrent/StructuredTaskScope.Configuration.html
Configurationтолько при включённых предварительных функциях.