CKTIS / Java
CompletableFuture.supplyAsync z jawnym executorem
Przekaż własny `Executor`, aby określić sposób wykonania zadania. `Runnable::run` uruchamia je od razu w wątku wywołującym, bez korzystania ze wspólnej puli.
Wersja: Java SE 21
Składnia
public static <U> CompletableFuture<U> supplyAsync(Supplier<U> supplier, Executor executor)W Java SE 21 CompletableFuture.supplyAsync(Supplier,Executor) to statyczna metoda klasy java.util.concurrent.CompletableFuture. Przyjmuje java.util.function.Supplier<U>, którego metoda get() nie przyjmuje argumentów i zwraca wartość typu U, oraz java.util.concurrent.Executor. Metoda zleca wykonanie zadania, które wywołuje get() i kończy nowy CompletableFuture<U> zwróconą wartością.
Wersja jednoargumentowa, supplyAsync(supplier), korzysta z ForkJoinPool.commonPool(). Jeśli wspólna pula nie zapewnia poziomu równoległości co najmniej 2, Java tworzy osobny wątek dla każdego zadania. Wersja dwuargumentowa zgodnie z dokumentacją korzysta z przekazanego executora. W OpenJDK 21 jest jednak wyjątek: jeśli jawnie przekażesz ForkJoinPool.commonPool(), a poziom równoległości tej puli jest mniejszy niż 2, metoda użyje zamiast niej executora tworzącego osobny wątek dla każdego zadania. To szczegół implementacji, którego Java SE nie gwarantuje dla wersji dwuargumentowej. Nazwa Async nie gwarantuje ani użycia innego wątku, ani natychmiastowego powrotu z metody.
W zapisie Executor sameThread = Runnable::run wywołanie execute od razu uruchamia run() zadania w wątku wywołującym. W przykładzie obliczenie kończy się, zanim supplyAsync zwróci wynik, więc join() odczytuje 42 bez czekania. Długie lub blokujące zadanie zatrzymałoby wątek wywołujący na czas wykonania.
Jeśli get() zgłosi wyjątek, future zakończy się wyjątkowo, a join() zgłosi niekontrolowany wyjątek CompletionException. Jeśli natomiast sam execute zgłosi RejectedExecutionException, wyjątek wychodzi bezpośrednio z supplyAsync, które nie zwraca wtedy future. Żaden z dwóch argumentów nie może być null, ale wynik zwrócony przez get() może nim być.
Przykłady
import java.util.concurrent.CompletableFuture;
import java.util.concurrent.Executor;
public class Main {
public static void main(String[] args) {
Executor sameThread = Runnable::run;
Thread caller = Thread.currentThread();
System.out.println("before supplyAsync");
CompletableFuture<Integer> future = CompletableFuture.supplyAsync(() -> {
System.out.println("same thread: " + (Thread.currentThread() == caller));
return 42;
}, sameThread);
System.out.println("after supplyAsync");
System.out.println("result: " + future.join());
}
}Wynik
before supplyAsync same thread: true after supplyAsync result: 42
Wiersz `same thread: true` pojawia się między `before supplyAsync` a `after supplyAsync`. Potwierdza to, że kod dostawcy działa w wątku wywołującym jeszcze przed powrotem z metody. Nie ma puli do zamknięcia.
Powiązane lekcje
- Java · Lekcja 51 · Średniozaawansowany · Wersja: 2