- Loading...
The easiest way to get started is to configure your IDE to use a recent Project Loom JDK 19 Early Access (EA) build and get familiar with using the java.lang.Thread API to create a virtual thread to execute some code. Virtual threads are just threads that are scheduled by the Java virtual machine JDK rather than the operating system. Virtual Virtual threads are best suited to executing code that spends most of its time blocked, maybe waiting for a data to arrive on a network socket . Virtual threads are not suited to running code that is compute bound.or waiting for an element in queue for example.
Many applications won't use the Thread API directly but instead will use the In addition to to the Thread API, the java.util.concurrent.ExecutorService and Executors APIs are have . The Executors API has been updated to make it easy to work with virtual threadswith new factory methods for ExecutorServices that start a new thread for each task. Virtual threads are cheap enough that a new virtual thread can be created for each task, no need for pooling of there should never be a need to pool virtual threads.
The following uses a static factory method to start a virtual thread. It invokes starts a virtual thread to print a message. It invokes the join method to wait for the thread to terminate.
| Code Block | ||
|---|---|---|
| ||
Thread thread = Thread.ofVirtual().startVirtualThreadstart(() -> System.out.println("Hello")); thread.join(); |
The Thread.Builder API can also be used to create virtual threads that are configured at build time. The first snippet below creates an un-started thread. The second snippet creates and starts a thread with name "bob"following is an example that start a virtual thread to put an element into a queue after sleeping. The main thread blocks on the queue, waiting for the element.
| Code Block | ||
|---|---|---|
| ||
Thread thread1 var queue = new Thread.builderSynchronousQueue<String>().virtual; Thread.ofVirtual().taskstart(() -> System.out.println("Hello")).build(); Thread thread2 = Thread.builder() { try { Thread.virtualsleep(Duration.ofSeconds(2)); .namequeue.put("bobdone"); } catch (InterruptedException e) { } .task(() -> System.out.println("I'm Bob!")) }); String msg .start= queue.take(); |
The Thread.Builder API can also be used to create a ThreadFactory. The ThreadFactory created by the following snippet will create virtual threads named "worker-0", "worker-1", "worker-2", ...
| Code Block | ||
|---|---|---|
| ||
ThreadFactory factory = Thread.builderofVirtual().virtual().name("worker", 0).factory(); |
The following example uses the Executors API to create an ExecutorService that runs starts a new virtual thread for each task in its own virtual thread. The example uses the try-with-resources construct to ensure that the ExecutorService has terminated before continuing. The example demonstrates the use of the submit methods (these methods do not block), and the invokeAll/invokeAny combinator methods
ExecutorService defines submit methods to execute tasks for execution. The submit methods don't block, instead they return a Future object that can be used to wait for the result or exception. The submit method that takes a collection of tasks returns a Stream is lazily populated with completed Future objects representing the results.
The example also uses the invokeAll and invokeAny combinator methods to execute several that execute tasks and wait them to complete.
| Code Block | ||
|---|---|---|
| ||
try (ExecutorService executor = Executors.newVirtualThreadExecutor()) {
// Submits a value-returning task and waits for the result
Future<String> future = executor.submit(() -> "foo");
String result = future.join();
// Submits two value-returning tasks to get a Stream that is lazily populated
// with completed Future objects as the tasks complete
Stream<Future<String>> stream = executor.submit(List.of(() -> "foo", () -> "bar"));
stream.filter(Future::isCompletedNormally)
.map(Future::join)
.forEach(System.out::println);
// Executes two value-returning tasks, waiting for both to complete
List<Future<String>> results1 = executor.invokeAll(List.of(() -> "foo", () -> "bar"));
// Executes two value-returning tasks, waiting for both to complete. If one of the
// tasks completes with an exception, the other is cancelled.
List<Future<String>> results2 = executor.invokeAll(List.of(() -> "foo", () -> "bar"), true/*waitAll*/ false);
// Executes two value-returning tasks, returning the result of the first to
// complete, cancelling the other.
String first = executor.invokeAny(List.of(() -> "foo", () -> "bar"));
} |
...