CKTIS / Java
CompletableFuture.supplyAsync s explicitným executorom
Odovzdaním vlastného `Executor` určíš, ako sa úloha spustí. `Runnable::run` ju spustí ihneď vo volajúcom vlákne bez použitia spoločného fondu vlákien.
Verzia: Java SE 21
Syntax
public static <U> CompletableFuture<U> supplyAsync(Supplier<U> supplier, Executor executor)V Java SE 21 je CompletableFuture.supplyAsync(Supplier,Executor) statická metóda triedy java.util.concurrent.CompletableFuture. Prijíma java.util.function.Supplier<U>, ktorého metóda get() nemá žiadne argumenty a vracia hodnotu typu U, a java.util.concurrent.Executor. Zadá na vykonanie úlohu, ktorá zavolá get() a dokončí nový CompletableFuture<U> vrátenou hodnotou.
Preťažený variant s jedným argumentom, supplyAsync(supplier), používa ForkJoinPool.commonPool(). Ak tento fond nepodporuje úroveň paralelizmu aspoň 2, Java vytvorí pre každú úlohu nové vlákno. Podľa dokumentácie variant s dvoma argumentmi používa odovzdaný executor. V OpenJDK 21 platí výnimka: ak výslovne odovzdáš ForkJoinPool.commonPool() a úroveň paralelizmu tohto fondu je nižšia ako 2, metóda namiesto neho použije executor, ktorý pre každú úlohu vytvorí nové vlákno. Toto náhradné správanie variantu s dvoma argumentmi je detail implementácie, ktorý Java SE nezaručuje. Async nezaručuje iné vlákno ani okamžitý návrat z metódy.
Pri použití Executor sameThread = Runnable::run zavolá execute metódu run() úlohy ihneď vo volajúcom vlákne. V príklade výpočet skončí skôr, než sa supplyAsync vráti, takže join() získa 42 bez čakania. Pomalá alebo blokujúca úloha by zdržala volajúce vlákno, kým by sa nedokončila.
Ak get() vyhodí výnimku, future sa dokončí s výnimkou a join() vyhodí nekontrolovanú výnimku CompletionException. Ak však RejectedExecutionException vyhodí samotné execute, výnimka sa šíri priamo zo supplyAsync, ktoré v takom prípade nevráti žiadny future. Ani jeden argument nesmie byť null, ale hodnota vrátená metódou get() môže byť null.
Prí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ýsledok
before supplyAsync same thread: true after supplyAsync result: 42
Riadok `same thread: true` sa vypíše medzi `before supplyAsync` a `after supplyAsync`. Dodávateľ hodnoty teda beží vo volajúcom vlákne ešte pred návratom z metódy. Nie je tu žiadny fond vlákien, ktorý by bolo treba vypnúť.
Súvisiace lekcie
- Java · Lekcia 51 · Stredne pokročilá · Verzia: 2