CKTIS / Java
CompletableFuture.supplyAsync s explicitním executorem
Předáním vlastního `Executor` určíš, jak se úloha spustí. `Runnable::run` ji spustí ihned ve volajícím vlákně, aniž by použil sdílený fond vláken.
Verze: Java SE 21
Syntaxe
public static <U> CompletableFuture<U> supplyAsync(Supplier<U> supplier, Executor executor)V Java SE 21 je CompletableFuture.supplyAsync(Supplier,Executor) statická metoda třídy java.util.concurrent.CompletableFuture. Přijímá java.util.function.Supplier<U>, jehož metoda get() nemá žádné argumenty a vrací hodnotu typu U, a java.util.concurrent.Executor. Zadá k provedení úlohu, která zavolá get() a dokončí nový CompletableFuture<U> vrácenou hodnotou.
Přetížená varianta s jedním argumentem, supplyAsync(supplier), používá ForkJoinPool.commonPool(). Pokud tento fond nepodporuje úroveň paralelismu alespoň 2, Java vytvoří pro každou úlohu nové vlákno. Podle dokumentace varianta se dvěma argumenty používá předaný executor. OpenJDK 21 má výjimku: pokud výslovně předáš ForkJoinPool.commonPool() a úroveň paralelismu tohoto fondu je menší než 2, metoda místo něj použije executor, který pro každou úlohu vytvoří nové vlákno. Toto náhradní chování varianty se dvěma argumenty je detail implementace, který Java SE nezaručuje. Async nezaručuje jiné vlákno ani okamžitý návrat z metody.
Při použití Executor sameThread = Runnable::run zavolá execute metodu run() úlohy ihned ve volajícím vlákně. Ve zdejším příkladu výpočet skončí dříve, než se supplyAsync vrátí, takže join() získá 42 bez čekání. Pomalá nebo blokující úloha by volající vlákno zdržela až do svého dokončení.
Pokud get() vyhodí výjimku, future skončí výjimkou a join() vyhodí nekontrolovanou výjimku CompletionException. Pokud však RejectedExecutionException vyhodí samotné execute, výjimka se šíří přímo z supplyAsync, které v takovém případě žádný future nevrátí. Ani jeden argument nesmí být null, ale hodnota vrácená metodou get() být null může.
Příklady
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());
}
}Výsledek
before supplyAsync same thread: true after supplyAsync result: 42
Řádek `same thread: true` se vypíše mezi `before supplyAsync` a `after supplyAsync`. Dodavatel hodnoty tedy běží ve volajícím vlákně ještě před návratem z metody. Není tu žádný fond vláken, který by bylo třeba vypnout.
Související lekce
- Java · Lekce 51 · Středně pokročilá · Verze: 2