Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

CompletableFuture: sastavljanje faza, vremenska ograničenja i izvršitelji

Sastavljajte faze u Java SE 21, oporavite se od pogrešaka, uskladite više objekata future i izričito odaberite izvršitelje asinkronih zadataka.

Verzija: 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 pripada paketu java.util.concurrent. Statička metoda completedFuture(value) stvara objekt future koji je već uspješno dovršen. thenApply pretvara uspješan rezultat u vrijednost u novoj fazi. Upotrijebite thenCompose ako funkcija vraća CompletionStage: nova faza preuzima ishod vraćene faze umjesto da tu fazu sadrži kao vrijednost. thenCombine poziva funkciju s oba rezultata tek kada obje faze uspiju; ne pokreće nijednu od njih.

completeExceptionally(cause) dovršava isti objekt future iznimkom i vraća true samo ako ga je dovršio upravo taj poziv. exceptionally stvara novu fazu koja prosljeđuje uspješan rezultat ili iz iznimke izračunava zamjensku vrijednost. join() po potrebi blokira i vraća rezultat, u slučaju pogreške baca neprovjeravanu iznimku CompletionException, a u slučaju otkazivanja objekta future baca CancellationException. Radije pozovite join() na granici programa nego da blokirate radne dretve unutar lanca.

Statička metoda allOf vraća CompletableFuture<Void> koji čeka da se svi ulazi dovrše, čak i ako neki ne uspije. Ako neki ulaz ne uspije, ne uspijeva ni objedinjeni objekt future. Ne prikuplja vrijednosti; nakon uspjeha očitajte ih pojedinačno. Bez ulaza već je dovršen s vrijednošću null. Statička metoda anyOf vraća CompletableFuture<Object> koji se dovršava rezultatom ili iznimkom jednog od ulaza kada se utvrdi da je taj ulaz dovršen. Ako je pri pozivu već dovršeno više ulaza, API ne jamči odabir onoga koji je dovršen najranije. Ne čeka prvi uspjeh i ne otkazuje ostale ulaze. Bez ulaza ostaje nedovršen.

Ako objekt future još nije dovršen kad istekne rok, completeOnTimeout(value, timeout, unit) uspješno ga dovršava zamjenskom vrijednošću, a orTimeout(timeout, unit) dovršava ga iznimkom TimeoutException. Obje su metode dostupne od Java 9. Konfiguriraju i vraćaju isti objekt, ne mijenjaju već utvrđeni ishod i ne prekidaju računanje. Rok se odnosi na dovršetak objekta future, a ne samo na čekanje pozivatelja u join().

supplyAsync(supplier, io) pokreće funkciju koja pribavlja vrijednost putem izvršitelja io, a thenApplyAsync(fn, cpu) nakon uspjeha izvodi pretvorbu putem cpu. Sljedeće faze ne nasljeđuju te izvršitelje. Bez izričitog Executor, CompletableFuture u pravilu koristi ForkJoinPool.commonPool() ili novu dretvu za svaki zadatak ako skup ne podržava paralelizam od najmanje dva. Podklase mogu promijeniti zadani izvršitelj za metode instance. Metode bez Async, kao što je thenCombine, ne jamče određenog izvršitelja ni dretvu i mogu se izvršiti izravno ako su ulazi spremni. Za odabir izvršitelja spajanja upotrijebite thenCombineAsync(other, fn, executor).

Primjeri

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 faza u prvom sastavljanju koristi već dostupne rezultate. Objekte future s vremenskim ograničenjem ne dovršava nijedan zadatak, pa ishod ne ovisi o utrci s računanjem. `io` i `cpu` zasebni su izvršitelji za demonstraciju; try-with-resources zatvara oba. Ne pretpostavljajte određeno proteklo vrijeme ni dretvu za `thenCombine`.

Povezane lekcije

  • Java · Lekcija 41 · Napredno · Verzija: 2
  • Java · Lekcija 42 · Napredno · Verzija: 2

Izvori