Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

Izvori