Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

CompletableFuture.supplyAsync z izrecno podanim izvajalnikom

Podaj lasten `Executor`, da določiš način izvajanja opravila. `Runnable::run` ga izvede takoj v klicni niti, ne da bi uporabil skupni nabor niti.

Različica: Java SE 21

Sintaksa

public static <U> CompletableFuture<U> supplyAsync(Supplier<U> supplier, Executor executor)

V Java SE 21 je CompletableFuture.supplyAsync(Supplier,Executor) statična metoda razreda java.util.concurrent.CompletableFuture. Sprejme java.util.function.Supplier<U>, katerega metoda get() ne sprejme argumentov in vrne vrednost tipa U, ter java.util.concurrent.Executor. V izvajanje odda opravilo, ki pokliče get() in zaključi nov CompletableFuture<U> z vrnjeno vrednostjo.

Različica z enim argumentom, supplyAsync(supplier), uporabi ForkJoinPool.commonPool(). Če ta nabor niti ne podpira stopnje vzporednosti vsaj 2, Java za vsako opravilo ustvari novo nit. V skladu z dokumentacijo različica z dvema argumentoma uporabi podani izvajalnik. V OpenJDK 21 velja izjema: če izrecno podaš ForkJoinPool.commonPool() in je njegova stopnja vzporednosti manjša od 2, metoda namesto njega uporabi izvajalnik, ki za vsako opravilo ustvari novo nit. To nadomestno vedenje različice z dvema argumentoma je podrobnost implementacije, ki je Java SE ne zagotavlja. Async ne zagotavlja izvajanja v drugi niti ali takojšnje vrnitve iz metode.

Pri Executor sameThread = Runnable::run metoda execute takoj pokliče run() opravila v klicni niti. V primeru se izračun zaključi, preden se supplyAsync vrne, zato join() brez čakanja vrne 42. Počasno ali blokirajoče opravilo bi zadržalo klicno nit do konca izvajanja.

Če get() sproži izjemo, se future zaključi z izjemo, join() pa sproži nepreverjano izjemo CompletionException. Če RejectedExecutionException sproži sam execute, se izjema razširi neposredno iz supplyAsync, ki v tem primeru ne vrne objekta future. Noben argument ne sme biti null, vrednost, ki jo vrne get(), pa je lahko null.

Primeri

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

Vrstica `same thread: true` se izpiše med `before supplyAsync` in `after supplyAsync`. Dobavitelj vrednosti torej teče v klicni niti, preden se metoda vrne. Nobenega nabora niti ni treba zaustaviti.

Povezane lekcije

  • Java · Lekcija 51 · Srednja · Različica: 2

Viri