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

CKTIS / Java

`CompletableFuture.thenCombine`: combinar dos resultados

`thenCombine` crea un nuevo `CompletableFuture` cuyo valor solo se calcula cuando ambas etapas de entrada terminan normalmente, por ejemplo para sumar dos contadores independientes.

Versión: Java SE 21

Sintaxis

public <U, V> CompletableFuture<V> thenCombine(CompletionStage<? extends U> other, BiFunction<? super T, ? super U, ? extends V> fn)

CompletableFuture.thenCombine registra una función fn que depende de dos etapas. La llamada left.thenCombine(right, fn) no inicia los cálculos de entrada ni se bloquea esperando sus resultados. fn solo puede ejecutarse cuando ambas etapas terminan normalmente. Recibe primero el resultado de left y después el de right, sin importar el orden de finalización.

T es el tipo del resultado de left y U el del resultado de la otra etapa; pueden ser distintos. right puede ser cualquier CompletionStage compatible, no necesariamente un CompletableFuture. El valor que devuelve la BiFunction se convierte en el resultado de tipo V del nuevo CompletableFuture<V>. Usa thenCompose cuando necesites el primer resultado para elegir o iniciar la siguiente etapa.

La variante sin Async no garantiza el uso de otro hilo. Si los dos resultados ya están disponibles, la función puede ejecutarse antes de que retorne thenCombine. thenCombineAsync(other, fn) usa el mecanismo de ejecución asíncrona predeterminado, mientras que thenCombineAsync(other, fn, executor) usa el Executor proporcionado.

Si alguna etapa de entrada termina con una excepción, incluida la cancelación, no se invoca fn. En OpenJDK 21, thenCombine espera a que terminen ambas etapas de entrada antes de que la etapa dependiente termine con una excepción. Si la otra etapa nunca termina, la etapa dependiente puede quedar pendiente indefinidamente. Si fallan ambas, la causa notificada puede proceder de cualquiera de ellas. Si fn lanza una excepción, la etapa dependiente también falla; al intentar obtener un resultado así con join(), se lanza CompletionException.

Ejemplos

import java.util.concurrent.CompletableFuture;

public class CombineCounters {
    public static void main(String[] args) {
        var leftCount = new CompletableFuture<Integer>();
        var rightCount = new CompletableFuture<Integer>();
        CompletableFuture<Integer> total =
                leftCount.thenCombine(rightCount, Integer::sum);

        rightCount.complete(24);
        System.out.println(total.isDone());

        leftCount.complete(18);
        System.out.println(total.join());
    }
}

Resultado

false
42

`rightCount` termina primero, pero `total.isDone()` todavía devuelve `false`. Solo cuando termina `leftCount`, `Integer::sum` recibe `18` y `24` y `total.join()` devuelve `42`.

Lecciones relacionadas

  • Java · Lección 51 · Intermedio · Versión: 2

Fuentes