W3cubDocs

/OpenJDK 21

Interface Thread.Builder.OfVirtual

All Superinterfaces:
Thread.Builder
Enclosing interface:
Thread.Builder
public static sealed interface Thread.Builder.OfVirtual extends Thread.Builder
A builder for creating a virtual Thread or ThreadFactory that creates virtual threads.

Unless otherwise specified, passing a null argument to a method in this interface causes a NullPointerException to be thrown.

Since:
21
See Also:

Nested Class Summary

Nested classes/interfaces declared in interface java.lang.Thread.Builder

Thread.Builder.OfPlatform, Thread.Builder.OfVirtual

Method Summary

Modifier and Type Method Description
Thread.Builder.OfVirtual inheritInheritableThreadLocals(boolean inherit)
Sets whether the thread inherits the initial values of inheritable-thread-local variables from the constructing thread.
Thread.Builder.OfVirtual name(String name)
Sets the thread name.
Thread.Builder.OfVirtual name(String prefix, long start)
Sets the thread name to be the concatenation of a string prefix and the string representation of a counter value.
Thread.Builder.OfVirtual uncaughtExceptionHandler(Thread.UncaughtExceptionHandler ueh)
Sets the uncaught exception handler.

Methods declared in interface java.lang.Thread.Builder

factory, start, unstarted

Method Details

name

Thread.Builder.OfVirtual name(String name)
Description copied from interface: Thread.Builder
Sets the thread name.
Specified by:
name in interface Thread.Builder
Parameters:
name - thread name
Returns:
this builder

name

Thread.Builder.OfVirtual name(String prefix, long start)
Description copied from interface: Thread.Builder
Sets the thread name to be the concatenation of a string prefix and the string representation of a counter value. The counter's initial value is start. It is incremented after a Thread is created with this builder so that the next thread is named with the new counter value. A ThreadFactory created with this builder is seeded with the current value of the counter. The ThreadFactory increments its copy of the counter after newThread is used to create a Thread.
Specified by:
name in interface Thread.Builder
Parameters:
prefix - thread name prefix
start - the starting value of the counter
Returns:
this builder
Throws:
IllegalArgumentException - if start is negative

inheritInheritableThreadLocals

Thread.Builder.OfVirtual inheritInheritableThreadLocals(boolean inherit)
Description copied from interface: Thread.Builder
Sets whether the thread inherits the initial values of inheritable-thread-local variables from the constructing thread. The default is to inherit.
Specified by:
inheritInheritableThreadLocals in interface Thread.Builder
Parameters:
inherit - true to inherit, false to not inherit
Returns:
this builder

uncaughtExceptionHandler

Thread.Builder.OfVirtual uncaughtExceptionHandler(Thread.UncaughtExceptionHandler ueh)
Description copied from interface: Thread.Builder
Sets the uncaught exception handler.
Specified by:
uncaughtExceptionHandler in interface Thread.Builder
Parameters:
ueh - uncaught exception handler
Returns:
this builder

© 1993, 2023, 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/21/docs/api/java.base/java/lang/Thread.Builder.OfVirtual.html