CKTIS / Java
`CompletableFuture.thenCombine`: combinar dois resultados
`thenCombine` cria um novo `CompletableFuture` cujo valor só é calculado quando ambas as etapas de entrada terminam normalmente, por exemplo para somar dois contadores independentes.
Versão: Java SE 21
Sintaxe
public <U, V> CompletableFuture<V> thenCombine(CompletionStage<? extends U> other, BiFunction<? super T, ? super U, ? extends V> fn)CompletableFuture.thenCombine regista uma função fn que depende de duas etapas. A chamada left.thenCombine(right, fn) não inicia os cálculos de entrada nem bloqueia à espera dos resultados. fn só pode ser executada quando ambas as etapas terminarem normalmente. Recebe primeiro o resultado de left e depois o de right, independentemente da ordem de conclusão.
T é o tipo do resultado de left e U o tipo do resultado da outra etapa; podem ser diferentes. right pode ser qualquer CompletionStage compatível, não necessariamente um CompletableFuture. O valor devolvido pela BiFunction torna-se o resultado de tipo V do novo CompletableFuture<V>. Usa thenCompose quando o primeiro resultado for necessário para escolher ou iniciar a etapa seguinte.
A variante sem Async não garante a utilização de uma thread separada. Se ambos os resultados já estiverem disponíveis, a função pode ser executada antes de thenCombine devolver o controlo. thenCombineAsync(other, fn) usa o mecanismo de execução assíncrona predefinido, enquanto thenCombineAsync(other, fn, executor) usa o Executor fornecido.
Se uma etapa de entrada terminar com uma exceção, incluindo por cancelamento, fn não é chamada. No OpenJDK 21, thenCombine espera que ambas as etapas de entrada terminem antes de concluir a etapa dependente com uma exceção. Se a outra etapa nunca terminar, a etapa dependente pode ficar pendente indefinidamente. Se ambas falharem, a causa indicada pode vir de qualquer uma delas. Uma exceção lançada por fn também faz falhar a etapa dependente; ao tentar obter esse resultado, join() lança uma CompletionException.
Exemplos
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 primeiro, mas `total.isDone()` ainda devolve `false`. Só depois de `leftCount` terminar é que `Integer::sum` recebe `18` e `24` e `total.join()` devolve `42`.
Lições relacionadas
- Java · Lição 51 · Intermédio · Versão: 2