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:

• Thread.ofVirtual()

Nested Class Summary

Nested classes/interfaces declared in interface Thread.Builder

Thread.Builder.OfPlatform, Thread.Builder.OfVirtual

Modifier and Type	Interface	Description
static interface	Thread.Builder.OfPlatform	A builder for creating a platform Thread or ThreadFactory that creates platform threads.
static interface	Thread.Builder.OfVirtual	A builder for creating a virtual Thread or ThreadFactory that creates virtual threads.

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 Thread.Builder

factory, start, unstarted

Modifier and Type	Method	Description
ThreadFactory	factory()	Returns a ThreadFactory to create threads from the current state of the builder.
Thread	start(Runnable task)	Creates a new Thread from the current state of the builder and schedules it to execute.
Thread	unstarted(Runnable task)	Creates a new Thread from the current state of the builder to run the given task.

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