Spring Framework 6.1.4 · org.springframework.core.task.VirtualThreadTaskExecutor

A TaskExecutor implementation based on virtual threads in JDK 21+. The only configuration option is a thread name prefix.

For additional features such as concurrency limiting or task decoration, consider using SimpleAsyncTaskExecutor#setVirtualThreads instead.

Modifier and Type	Field and Description
private final ThreadFactory	virtualThreadFactory

Constructor Summary

Access	Constructor and Description
public	VirtualThreadTaskExecutor() Create a new `VirtualThreadTaskExecutor` without thread naming.
public	VirtualThreadTaskExecutor(String the prefix for thread names (e.g. "test-") threadNamePrefix) Create a new `VirtualThreadTaskExecutor` with thread names based on the given thread name prefix followed by a counter (e.g. "test-0").

Modifier and Type	Method and Description
public void	execute(Runnable the `Runnable` to execute (never `null`) task) Implements org.springframework.core.task.TaskExecutor.execute. Execute the given `task`.
public final ThreadFactory	getVirtualThreadFactory() Return the underlying virtual `ThreadFactory`.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

virtualThreadFactory	back to summary
private final ThreadFactory virtualThreadFactory

VirtualThreadTaskExecutor	back to summary
public VirtualThreadTaskExecutor() Create a new `VirtualThreadTaskExecutor` without thread naming.

VirtualThreadTaskExecutor back to summary

VirtualThreadTaskExecutor	back to summary
public VirtualThreadTaskExecutor(String threadNamePrefix) Create a new `VirtualThreadTaskExecutor` with thread names based on the given thread name prefix followed by a counter (e.g. "test-0"). Parameters threadNamePrefix:String the prefix for thread names (e.g. "test-")

public VirtualThreadTaskExecutor(String threadNamePrefix)

Create a new VirtualThreadTaskExecutor with thread names based on the given thread name prefix followed by a counter (e.g. "test-0").

Parameters

execute back to summary

execute	back to summary
public void execute(Runnable task) Implements org.springframework.core.task.TaskExecutor.execute. Doc from org.springframework.core.task.TaskExecutor.execute. Execute the given `task`. The call might return immediately if the implementation uses an asynchronous execution strategy, or might block in the case of synchronous execution. Parameters task:Runnable the `Runnable` to execute (never `null`) Annotations @Override

public void execute(Runnable task)

Execute the given task.

The call might return immediately if the implementation uses an asynchronous execution strategy, or might block in the case of synchronous execution.

Parameters

Annotations

getVirtualThreadFactory	back to summary
public final ThreadFactory getVirtualThreadFactory() Return the underlying virtual `ThreadFactory`. Can also be used for custom thread creation elsewhere.