Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

CompletableFuture: skládání kroků, časové limity a executory

Skládejte kroky v Java SE 21, zotavujte se z chyb, koordinujte více objektů future a explicitně vybírejte executory pro asynchronní práci.

Verze: Java SE 21

Syntaxe

import java.util.concurrent.CompletableFuture;

CompletableFuture.completedFuture(value)
future.thenApply(value -> mappedValue)
future.thenCompose(value -> nextStage)
future.thenCombine(otherStage, (left, right) -> combinedValue)
future.completeExceptionally(cause)
future.exceptionally(cause -> fallbackValue)
CompletableFuture.allOf(future1, future2)
CompletableFuture.anyOf(future1, future2)
future.completeOnTimeout(fallbackValue, timeout, unit)
future.orTimeout(timeout, unit)
CompletableFuture.supplyAsync(() -> value)
CompletableFuture.supplyAsync(() -> value, io)
future.thenApplyAsync(value -> mappedValue)
future.thenApplyAsync(value -> mappedValue, cpu)
future.join()

CompletableFuture patří do balíčku java.util.concurrent. Statická metoda completedFuture(value) vytvoří objekt future, který už úspěšně skončil. thenApply převede úspěšný výsledek na hodnotu v novém kroku. Pokud funkce vrací CompletionStage, použijte thenCompose: nový krok převezme výsledek vráceného kroku, včetně případného selhání, namísto toho, aby jej obsahoval jako hodnotu. thenCombine zavolá funkci s oběma výsledky, jen když oba kroky uspějí; žádný z nich nespouští.

completeExceptionally(cause) dokončí stejný objekt future výjimkou a vrátí true, pouze pokud jej dokončilo právě toto volání. exceptionally vytvoří nový krok, který předá úspěšný výsledek nebo spočítá náhradní hodnotu z výjimky. join() podle potřeby blokuje a vrátí výsledek, při selhání vyhodí nekontrolovanou výjimku CompletionException nebo při zrušení objektu future vyhodí CancellationException. join() volejte raději na hranici programu, než abyste uvnitř řetězce blokovali pracovní vlákna.

Statická metoda allOf vrací CompletableFuture<Void>, který čeká na dokončení všech vstupů, i když některý selže. Pokud některý selže, selže také, a hodnoty neshromažďuje. Po úspěchu čtěte hodnoty ze vstupů jednotlivě. Bez vstupů je už dokončený s hodnotou null. Statická metoda anyOf vrací CompletableFuture<Object>, který se dokončí s výsledkem nebo výjimkou jednoho ze vstupů, jakmile je zjištěno jeho dokončení. Pokud je při volání dokončeno už více vstupů, API nezaručuje výběr toho, který se dokončil nejdříve. Nečeká na první úspěch a ostatní vstupy neruší. Bez vstupů zůstává nedokončený.

Pokud future po uplynutí časového limitu stále není dokončený, completeOnTimeout(value, timeout, unit) jej úspěšně dokončí s náhradní hodnotou, zatímco orTimeout(timeout, unit) jej dokončí s výjimkou TimeoutException. Obě metody jsou dostupné od Java 9. Nastavují a vracejí tentýž objekt, nemění již určený výsledek a nepřerušují výpočet. Limit se vztahuje na dokončení objektu future, ne jen na čekání volajícího v join().

supplyAsync(supplier, io) spustí dodavatele prostřednictvím executoru io; thenApplyAsync(fn, cpu) po úspěchu provede transformaci prostřednictvím cpu. Navazující kroky tyto executory nedědí. Bez explicitního Executor používá CompletableFuture běžně ForkJoinPool.commonPool(), nebo nové vlákno na úlohu, pokud fond nepodporuje paralelismus alespoň dva. Podtřídy mohou výchozí executor instančních metod předefinovat. Metody bez Async, jako thenCombine, nezaručují konkrétní executor ani vlákno a mohou se provést přímo, jsou-li vstupy hotové. Chcete-li zvolit executor pro spojení, použijte thenCombineAsync(other, fn, executor).

Příklady

import java.util.concurrent.CompletableFuture;
import java.util.concurrent.CompletionException;
import java.util.concurrent.Executors;
import java.util.concurrent.TimeUnit;

public class Main {
    public static void main(String[] args) {
        var composed = CompletableFuture.completedFuture(2)
                .thenApply(n -> n + 1)
                .thenCompose(n -> CompletableFuture.completedFuture(n * 2))
                .thenCombine(CompletableFuture.completedFuture(4), Integer::sum);
        System.out.println("composed=" + composed.join());

        var failed = new CompletableFuture<Integer>();
        failed.completeExceptionally(new IllegalStateException("unavailable"));
        System.out.println("recovered=" + failed.exceptionally(error -> -1).join());

        var ready = CompletableFuture.completedFuture("ready");
        var pending = new CompletableFuture<String>();
        System.out.println("any=" + CompletableFuture.anyOf(ready, pending).join());
        var all = CompletableFuture.allOf(ready, pending);
        pending.complete("done");
        all.join();
        System.out.println("all=" + ready.join() + "," + pending.join());

        var fallback = new CompletableFuture<Integer>();
        var same = fallback.completeOnTimeout(0, 10, TimeUnit.MILLISECONDS);
        System.out.println("fallback=" + same.join() + ", same=" + (same == fallback));
        var deadline = new CompletableFuture<Integer>();
        try {
            deadline.orTimeout(10, TimeUnit.MILLISECONDS).join();
        } catch (CompletionException error) {
            System.out.println("timeout=" + error.getCause().getClass().getSimpleName());
        }

        try (var io = Executors.newSingleThreadExecutor();
             var cpu = Executors.newSingleThreadExecutor()) {
            var loaded = CompletableFuture.supplyAsync(() -> 7, io);
            var offset = CompletableFuture.supplyAsync(() -> 3, io);
            var total = loaded.thenApplyAsync(n -> n * 2, cpu)
                    .thenCombine(offset, Integer::sum);
            System.out.println("async=" + total.join());
        }
    }
}

Výsledek

composed=10
recovered=-1
any=ready
all=ready,done
fallback=0, same=true
timeout=TimeoutException
async=17

Většina kroků v první kompozici využívá již dostupné výsledky. Objekty future s časovým limitem nemají úlohu, která by je dokončila, takže výsledek nezávisí na závodu s výpočtem. `io` a `cpu` jsou dva různé ukázkové executory; try-with-resources oba uzavře. Nepředpokládejte konkrétní dobu čekání ani vlákno pro `thenCombine`.

Související lekce

  • Java · Lekce 41 · Pokročilá · Verze: 2
  • Java · Lekce 42 · Pokročilá · Verze: 2

Zdroje