CKTIS / Java
CompletableFuture.supplyAsync s izričito zadanim izvršiteljem
Predaj vlastiti `Executor` da odrediš kako će se zadatak izvršiti. `Runnable::run` izvršava ga odmah u pozivajućoj dretvi, bez upotrebe zajedničkog skupa dretvi.
Verzija: Java SE 21
Sintaksa
public static <U> CompletableFuture<U> supplyAsync(Supplier<U> supplier, Executor executor)U izdanju Java SE 21 CompletableFuture.supplyAsync(Supplier,Executor) statička je metoda klase java.util.concurrent.CompletableFuture. Prima java.util.function.Supplier<U>, čija metoda get() ne prima argumente i vraća vrijednost tipa U, te java.util.concurrent.Executor. Na izvršavanje predaje zadatak koji poziva get() i dovršava novi CompletableFuture<U> vraćenom vrijednošću.
Preopterećena verzija s jednim argumentom, supplyAsync(supplier), koristi ForkJoinPool.commonPool(). Ako taj skup dretvi ne podržava razinu paralelizma od najmanje 2, Java za svaki zadatak stvara novu dretvu. Prema dokumentaciji, verzija s dva argumenta koristi predanog izvršitelja. U OpenJDK-u 21 postoji iznimka: ako izričito predaš ForkJoinPool.commonPool(), a razina paralelizma tog skupa manja je od 2, metoda umjesto njega koristi izvršitelja koji za svaki zadatak stvara novu dretvu. To zamjensko ponašanje verzije s dva argumenta detalj je implementacije koji Java SE ne jamči. Async ne jamči drugu dretvu ni trenutačni povratak iz metode.
Uz Executor sameThread = Runnable::run, execute odmah poziva run() zadatka u pozivajućoj dretvi. U primjeru izračun završava prije nego što se supplyAsync vrati, pa join() vraća 42 bez čekanja. Spor ili blokirajući zadatak zadržao bi pozivajuću dretvu dok ne završi.
Ako get() baci iznimku, future se dovršava s iznimkom, a join() baca neprovjeravanu iznimku CompletionException. Ako sam execute baci RejectedExecutionException, iznimka se propagira izravno iz supplyAsync, koji tada ne vraća future. Nijedan od dva argumenta ne smije biti null, ali vrijednost koju vraća get() smije biti null.
Primjeri
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());
}
}Rezultat
before supplyAsync same thread: true after supplyAsync result: 42
Redak `same thread: true` pojavljuje se između `before supplyAsync` i `after supplyAsync`. To pokazuje da se dobavljač vrijednosti izvršava u pozivajućoj dretvi prije povratka iz metode. Nema skupa dretvi koji treba ugasiti.
Povezane lekcije
- Java · Lekcija 51 · Srednje · Verzija: 2