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

CKTIS / Java

CompletableFuture.thenApply: преобразуване на резултата от етап

Използвай `thenApply`, за да преобразуваш резултата от етап след нормалното му завършване. Методът връща нов етап и не гарантира изпълнение на функцията в отделна нишка.

Версия: Java SE 21

Синтаксис

public <U> CompletableFuture<U> thenApply(Function<? super T, ? extends U> fn)

В Java SE 21 методът CompletableFuture.thenApply от пакета java.util.concurrent създава нов зависим CompletableFuture<U>, без да променя резултата на изходния CompletableFuture<T>. Когато изходният етап завърши нормално, функцията получава резултата му, а върнатата от нея стойност става резултат на новия етап. U може да се различава от T: ? super T допуска входен тип T или негов надтип, а ? extends U допуска тип на върнатата стойност U или негов подтип.

Вариантът без Async не гарантира отделна нишка. Функцията може да се изпълни в нишката, която завършва изходния етап, или направо по време на извикването на thenApply, ако резултатът вече е наличен. Използвай кратки, неблокиращи преобразувания. thenApplyAsync използва механизма по подразбиране на етапа за асинхронно изпълнение или изрично подаден Executor.

Ако изходният етап завърши с изключение, включително при отмяна, функцията не се извиква и зависимият етап също завършва с изключение. Същото става, ако функцията хвърли изключение: join() върху зависимия етап тогава хвърля CompletionException, вместо да върне резултат.

Използвай thenApply, когато функцията връща обикновена стойност. Ако връща CompletionStage<U>, използвай thenCompose, за да получиш резултата от този етап без влагане на етапи.

Примери

import java.util.concurrent.CompletableFuture;

public class Main {
    public static void main(String[] args) {
        CompletableFuture<Integer> total = new CompletableFuture<>();
        CompletableFuture<String> label = total.thenApply(value -> "Total: " + value);

        System.out.println(label.isDone());
        total.complete(42);
        System.out.println(label.join());
    }
}

Резултат

false
Total: 42

Първият ред е `false`, защото изходният етап все още не е завършил. `complete(42)` предоставя стойността на функцията, а `join()` получава преобразувания резултат `Total: 42`, като изчаква при нужда.

Свързани уроци

  • Java · Урок 51 · Средно · Версия: 2

Източници