База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

CompletableFuture — съставяне на асинхронни изчисления

CompletableFuture<T> представя бъдещ резултат и позволява свързване на зависими етапи, без да се блокира след всяка стъпка. Научете за преобразуването, композирането, комбинирането на резултати, възстановяването след грешки и времевите ограничения в Java SE 21.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

CompletableFuture<T> future = CompletableFuture.supplyAsync(supplier, executor);
CompletableFuture<U> mapped = future.thenApply(mapper);
CompletableFuture<U> composed = future.thenCompose(asyncMapper);
T result = future.join();

CompletableFuture<T> съчетава резултат Future<T> с етапи CompletionStage<T>. CompletableFuture.supplyAsync подава изчисление за изпълнение; CompletableFuture.completedFuture създава вече завършен резултат. CompletableFuture.completeExceptionally завършва незавършен future с грешка. Обхват: Java SE 21; среда за изпълнение на хранилището, производствената среда не е потвърдена.

CompletableFuture.thenApply преобразува успешен резултат; не гарантира отделна нишка. CompletableFuture.thenApplyAsync подава функцията на executor за изпълнение. По подразбиране се използва ForkJoinPool.commonPool(); когато паралелизмът е под две, за всяка задача се създава нишка. Можете изрично да зададете executor. CompletableFuture.thenCompose сплесква функция, която връща следващ етап, вместо да създава вложен резултат. CompletableFuture.thenCombine комбинира стойностите, след като и двата етапа завършат успешно.

CompletableFuture.exceptionally изчислява заместваща стойност само при грешка. CompletableFuture.allOf изчаква всички етапи, връща CompletableFuture<Void> и разпространява грешка, ако някой етап се провали; не събира стойностите. CompletableFuture.anyOf връща CompletableFuture<Object> с резултата или грешката на един от завършилите етапи — не е задължително това да е успех. Не отменя останалите задачи.

CompletableFuture.join и CompletableFuture.get блокират до завършването. Обикновено грешката се обвива съответно в непроверяваното CompletionException или проверяваното ExecutionException; get може да хвърли и InterruptedException. Отмяната хвърля CancellationException. Избягвайте блокиране в зависими задачи.

CompletableFuture.completeOnTimeout завършва същия future със заместваща стойност, докато CompletableFuture.orTimeout го завършва с TimeoutException, ако още не е завършен. Нито един от двата метода не спира основното изчисление. За разлика от тях get(timeout, unit) ограничава само времето за изчакване на извикващия.

Примери

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

public class Main {
    public static void main(String[] args) {
        try (var executor = Executors.newFixedThreadPool(2)) {
            var base = CompletableFuture.supplyAsync(() -> 20, executor);
            var result = base
                .thenApply(n -> n + 1)
                .thenCompose(n -> CompletableFuture.completedFuture(n * 2))
                .thenCombine(CompletableFuture.completedFuture(8), Integer::sum);

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

            CompletableFuture.allOf(result, recovered).join();
            System.out.println("result=" + result.join());
            System.out.println("recovered=" + recovered.join());
        }
    }
}

Резултат

result=50
recovered=-1

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници