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
Източници
- CompletableFuture.thenApply — Java SE 21 & JDK 21 API
- CompletableFuture — Execution policies and cancellation — Java SE 21 & JDK 21 API
- CompletionStage — Exceptional completion rules — Java SE 21 & JDK 21 API
- CompletionStage.thenCompose — Java SE 21 & JDK 21 API
- CompletableFuture.join — Java SE 21 & JDK 21 API