Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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