W3cubDocs

/OpenJDK 25

Interface StructuredTaskScope.Configuration

Enclosing interface:
StructuredTaskScopePREVIEW<T,R>
public static sealed interface StructuredTaskScope.Configuration
Configuration is a preview API of the Java platform.
Programs can only use Configuration when preview features are enabled.
Preview features may be removed in a future release, or upgraded to permanent features of the Java platform.
Represents the configuration for a StructuredTaskScope.

The configuration for a StructuredTaskScope consists of a ThreadFactory to create threads, an optional name for the purposes of monitoring and management, and an optional timeout.

Creating a StructuredTaskScope with StructuredTaskScope.open()PREVIEW or StructuredTaskScope.open(Joiner)PREVIEW uses the default configuration. The default configuration consists of a thread factory that creates unnamed virtual threads, no name for monitoring and management purposes, and no timeout.

Creating a StructuredTaskScope with its 2-arg openPREVIEW method allows a different configuration to be used. The function specified to the open method is applied to the default configuration and returns the configuration for the StructuredTaskScope under construction. The function can use the with- prefixed methods defined here to specify the components of the configuration to use.

Unless otherwise specified, passing a null argument to a method in this class will cause a NullPointerException to be thrown.

Since:
25

Method Summary

Modifier and Type Method Description
StructuredTaskScope.ConfigurationPREVIEW withName(String name)
Returns a new Configuration object with the given name.
StructuredTaskScope.ConfigurationPREVIEW withThreadFactory(ThreadFactory threadFactory)
Returns a new Configuration object with the given thread factory.
StructuredTaskScope.ConfigurationPREVIEW withTimeout(Duration timeout)
Returns a new Configuration object with the given timeout.

Method Details

withThreadFactory

StructuredTaskScope.ConfigurationPREVIEW withThreadFactory(ThreadFactory threadFactory)
Returns a new Configuration object with the given thread factory. The other components are the same as this object. The thread factory is used by a scope to create threads when forkingPREVIEW subtasks.
API Note:
The thread factory will typically create virtual threads, maybe with names for monitoring purposes, an uncaught exception handler, or other properties configured.
Parameters:
threadFactory - the thread factory
Returns:
a new Configuration object with the given thread factory
See Also:

withName

StructuredTaskScope.ConfigurationPREVIEW withName(String name)
Returns a new Configuration object with the given name. The other components are the same as this object. A scope is optionally named for the purposes of monitoring and management.
Parameters:
name - the name
Returns:
a new Configuration object with the given name

withTimeout

StructuredTaskScope.ConfigurationPREVIEW withTimeout(Duration timeout)
Returns a new Configuration object with the given timeout. The other components are the same as this object.
API Note:
Applications using deadlines, expressed as an Instant, can use Duration.between(Instant.now(), deadline) to compute the timeout for this method.
Parameters:
timeout - the timeout
Returns:
a new Configuration object with the given timeout
See Also:

© 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