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

CKTIS / Java

CompletableFuture: sestavljanje stopenj, časovne omejitve in izvajalniki

Sestavljajte stopnje v Java SE 21, okrevajte po napakah, usklajujte več objektov future in izrecno izberite izvajalnike za asinhrono delo.

Različica: Java SE 21

Sintaksa

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 je v paketu java.util.concurrent. Statična metoda completedFuture(value) ustvari že uspešno zaključen objekt future. thenApply preslika uspešen rezultat v vrednost v novi stopnji. Če funkcija vrne CompletionStage, uporabite thenCompose: nova stopnja prevzame izid vrnjene stopnje, namesto da bi to stopnjo vsebovala kot vrednost. thenCombine pokliče funkcijo z obema rezultatoma le, če obe stopnji uspeta; ne zažene nobene od njiju.

completeExceptionally(cause) zaključi isti objekt future z izjemo in vrne true samo, če ga je zaključil ta klic. exceptionally ustvari novo stopnjo, ki posreduje uspešen rezultat ali iz izjeme izračuna nadomestno vrednost. join() po potrebi blokira in vrne rezultat, ob napaki sproži nepreverjano izjemo CompletionException, ob preklicu objekta future pa CancellationException. join() raje pokličite na meji programa, kot da bi v verigi blokirali delovne niti.

Statična metoda allOf vrne CompletableFuture<Void>, ki počaka na zaključek vseh vhodov, tudi če kateri odpove. Če kateri odpove, se tudi skupni objekt future zaključi z napako; vrednosti ne zbira. Po uspehu jih preberite iz posameznih vhodov. Brez vhodov je že zaključen z vrednostjo null. Statična metoda anyOf vrne CompletableFuture<Object>, ki se zaključi z rezultatom ali izjemo enega od vhodov, ko zazna njegov zaključek. Če je ob klicu že zaključenih več vhodov, API ne zagotavlja izbire tistega, ki se je zaključil najprej. Ne čaka na prvi uspeh in ne prekliče preostalih vhodov. Brez vhodov ostane nezaključen.

Če objekt future ob izteku časovne omejitve še ni zaključen, ga completeOnTimeout(value, timeout, unit) uspešno zaključi z nadomestno vrednostjo, orTimeout(timeout, unit) pa ga zaključi z izjemo TimeoutException. Obe metodi sta na voljo od Java 9. Nastavita in vrneta isti objekt, ne spremenita že določenega izida in ne prekineta izračuna. Omejitev velja za zaključek objekta future, ne le za čakanje klicatelja v join().

supplyAsync(supplier, io) zažene funkcijo, ki priskrbi vrednost, prek io, thenApplyAsync(fn, cpu) pa po uspehu izvede preslikavo prek cpu. Naslednje stopnje teh izvajalnikov ne podedujejo. Brez izrecnega Executor uporablja CompletableFuture privzeto ForkJoinPool.commonPool() ali novo nit za vsako opravilo, če sklad niti ne podpira vzporednosti vsaj dve. Podrazredi lahko spremenijo privzetega izvajalnika za metode primerka. Metode brez Async, kot je thenCombine, ne zagotavljajo določenega izvajalnika ali niti in se lahko izvedejo neposredno, ko so vhodi pripravljeni. Za izbiro izvajalnika združevanja uporabite thenCombineAsync(other, fn, executor).

Primeri

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());
        }
    }
}

Rezultat

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

Večina stopenj v prvi sestavi uporablja že razpoložljive rezultate. Objektov future s časovno omejitvijo ne zaključuje nobeno opravilo, zato izid ni odvisen od tekme z izračunom. `io` in `cpu` sta ločena demonstracijska izvajalnika; try-with-resources zapre oba. Ne predpostavljajte določenega pretečenega časa ali niti za `thenCombine`.

Povezane lekcije

  • Java · Lekcija 41 · Napredna · Različica: 2
  • Java · Lekcija 42 · Napredna · Različica: 2

Viri