CKTIS / Java
`CompletableFuture.thenCombine`: комбиниране на два резултата
`thenCombine` създава нов `CompletableFuture`, чиято стойност се изчислява едва след успешното приключване на двата входни етапа, например чрез събиране на стойностите на два независими брояча.
Версия: Java SE 21
Синтаксис
public <U, V> CompletableFuture<V> thenCombine(CompletionStage<? extends U> other, BiFunction<? super T, ? super U, ? extends V> fn)CompletableFuture.thenCombine регистрира функция fn, която зависи от два етапа. Извикването на left.thenCombine(right, fn) не стартира входните изчисления и не блокира нишката в очакване на резултатите им. fn може да се изпълни едва след като и двата етапа приключат успешно. Първият ѝ аргумент е резултатът от left, а вторият — резултатът от right, независимо от реда на приключване.
T е типът на резултата от left, а U е типът на резултата от другия етап; те може да са различни. right може да бъде всеки съвместим CompletionStage, не непременно CompletableFuture. Стойността, върната от BiFunction, става резултат от тип V в новия CompletableFuture<V>. Използвай thenCompose, когато първият резултат е нужен за избор или стартиране на следващия етап.
Вариантът без Async не гарантира отделна нишка. Ако и двата резултата вече са налични, функцията може да се изпълни, преди thenCombine да върне управлението. thenCombineAsync(other, fn) използва механизма по подразбиране за асинхронно изпълнение, а thenCombineAsync(other, fn, executor) използва подадения Executor.
Ако някой от входните етапи приключи с изключение, включително при отмяна, fn не се извиква. В OpenJDK 21 thenCombine изчаква и двата входни етапа да приключат, преди зависимият етап да приключи с изключение. Ако другият входен етап никога не приключи, зависимият етап може да остане незавършен за неопределено време. Ако и двата се провалят, съобщената причина може да идва от който и да е от тях. Изключение, хвърлено от fn, също води до неуспешно приключване на зависимия етап; при опит за получаване на такъв резултат join() хвърля CompletionException.
Примери
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());
}
}Резултат
false 42
`rightCount` приключва първи, но `total.isDone()` все още връща `false`. Едва след приключването на `leftCount` функцията `Integer::sum` получава `18` и `24`, а `total.join()` връща `42`.
Свързани уроци
- Java · Урок 51 · Средно · Версия: 2