CKTIS / Java
CompletableFuture: składanie etapów, limity czasu i executory
Składaj etapy w Java SE 21, odzyskuj wynik po błędzie, koordynuj wiele obiektów future i jawnie wybieraj executory dla operacji asynchronicznych.
Wersja: Java SE 21
Składnia
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 należy do java.util.concurrent. Statyczna metoda completedFuture(value) tworzy obiekt future już zakończony poprawnie. thenApply przekształca poprawny wynik w wartość w nowym etapie. thenCompose przyjmuje funkcję zwracającą CompletionStage i spłaszcza wynik: nowy etap odzwierciedla zakończenie zwróconego etapu, zamiast zawierać go jako wartość. thenCombine wywołuje funkcję z dwoma wynikami dopiero, gdy oba etapy zakończą się poprawnie; sam ich nie uruchamia.
completeExceptionally(cause) kończy ten sam obiekt future wyjątkiem; zwraca true tylko wtedy, gdy to wywołanie go zakończyło. exceptionally tworzy nowy etap: przekazuje poprawny wynik bez zmian albo wylicza wartość zastępczą na podstawie wyjątku. join() blokuje w razie potrzeby, zwraca wynik albo zgłasza niekontrolowany CompletionException w przypadku błędu lub CancellationException, jeśli obiekt future został anulowany. Wywołuj join() na granicy programu zamiast blokować wątki robocze wewnątrz łańcucha.
Statyczna metoda allOf zwraca CompletableFuture<Void>: czeka na zakończenie wszystkich wejść, nawet gdy jedno zawiedzie, i nie zbiera ich wartości. Po sukcesie odczytaj je osobno. Bez argumentów wynik jest już zakończony wartością null. Statyczna metoda anyOf zwraca CompletableFuture<Object>, który kończy się wynikiem lub wyjątkiem jednego z wejść, gdy zostanie wykryte jego zakończenie. Jeśli w chwili wywołania kilka wejść jest już zakończonych, API nie gwarantuje wyboru tego, które zakończyło się najwcześniej. Metoda nie czeka na pierwszy sukces ani nie anuluje pozostałych wejść. Bez argumentów zwrócony obiekt future pozostaje niezakończony.
completeOnTimeout(value, timeout, unit) kończy obiekt future poprawnie wartością zastępczą, a orTimeout(timeout, unit) kończy go wyjątkiem TimeoutException, jeśli do tego czasu wciąż nie jest zakończony. Obie metody, dostępne od Java 9, konfigurują i zwracają ten sam obiekt, nie przerywają obliczeń i nie zmieniają ustalonego wcześniej wyniku. To limit zakończenia obiektu future, nie tylko oczekiwania w join().
supplyAsync(supplier, io) uruchamia dostawcę za pośrednictwem executora io; thenApplyAsync(fn, cpu) po poprawnym wyniku przekazuje przekształcenie do cpu. Executor nie jest dziedziczony przez kolejne etapy. Bez jawnego Executor standardowy CompletableFuture używa ForkJoinPool.commonPool(), a gdy pula nie obsługuje równoległości co najmniej dwóch, tworzy nowy wątek dla każdego zadania. Podklasy mogą zmienić domyślny executor metod instancji. Wariant bez Async, np. thenCombine, nie gwarantuje konkretnego executora ani wątku i może wykonać funkcję od razu, gdy dane są gotowe. Aby wskazać executor dla łączenia, użyj thenCombineAsync(other, fn, executor).
Przykłady
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());
}
}
}Wynik
composed=10 recovered=-1 any=ready all=ready,done fallback=0, same=true timeout=TimeoutException async=17
Większość etapów w pierwszej kompozycji korzysta z gotowych wyników. Obiekty future z limitem czasu nie mają zadań roboczych, więc wynik nie zależy od wyścigu z obliczeniami. `io` i `cpu` to osobne executory demonstracyjne; `try` z zasobami zamyka oba. Nie zakładaj konkretnego czasu oczekiwania ani wątku wykonującego `thenCombine`.
Powiązane lekcje
- Java · Lekcja 41 · Zaawansowany · Wersja: 2
- Java · Lekcja 42 · Zaawansowany · Wersja: 2