CKTIS / Java
CompletableFuture.thenApply: transformar el resultado de una etapa
Usa `thenApply` para transformar el resultado de una etapa cuando termina normalmente. Devuelve una etapa nueva y no garantiza que la función se ejecute en un hilo separado.
Versión: Java SE 21
Sintaxis
public <U> CompletableFuture<U> thenApply(Function<? super T, ? extends U> fn)En Java SE 21, CompletableFuture.thenApply, del paquete java.util.concurrent, crea un nuevo CompletableFuture<U> dependiente sin cambiar el resultado del CompletableFuture<T> de origen. Cuando la etapa de origen termina normalmente, la función recibe su resultado y el valor que devuelve se convierte en el resultado de la nueva etapa. U puede ser distinto de T: ? super T admite T o un supertipo como entrada, y ? extends U admite U o un subtipo como tipo de retorno.
La variante sin Async no garantiza un hilo separado. La función puede ejecutarse en el hilo que completa la etapa de origen o durante la propia llamada a thenApply si el resultado ya está disponible. Procura que las transformaciones sean breves y no bloqueantes. thenApplyAsync utiliza el mecanismo de ejecución asíncrona predeterminado de la etapa o un Executor proporcionado explícitamente.
Si la etapa de origen termina de forma excepcional, incluida la cancelación, la función no se ejecuta y la etapa dependiente también termina de forma excepcional. Lo mismo ocurre si la función lanza una excepción: al llamar a join() sobre la etapa dependiente, se lanza CompletionException en lugar de devolver un resultado.
Usa thenApply cuando la función devuelva un valor ordinario. Si devuelve un CompletionStage<U>, usa thenCompose para obtener el resultado de esa etapa sin anidar etapas.
Ejemplos
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());
}
}Resultado
false Total: 42
La primera línea muestra `false` porque la etapa de origen aún no ha terminado. `complete(42)` pone el valor a disposición de la función y `join()` obtiene el resultado transformado `Total: 42`, esperando si hace falta.
Lecciones relacionadas
- Java · Lección 51 · Intermedio · Versión: 2
Fuentes
- 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