CKTIS / Java
`CompletableFuture.thenCombine`: kombiniranje dvaju rezultata
`thenCombine` stvara novi `CompletableFuture` čija se vrijednost izračunava tek nakon što obje ulazne faze uspješno završe, primjerice zbrajanjem vrijednosti dvaju neovisnih brojača.
Verzija: Java SE 21
Sintaksa
public <U, V> CompletableFuture<V> thenCombine(CompletionStage<? extends U> other, BiFunction<? super T, ? super U, ? extends V> fn)CompletableFuture.thenCombine registrira funkciju fn koja ovisi o dvjema fazama. Poziv left.thenCombine(right, fn) ne pokreće ulazne izračune niti blokira dretvu čekajući njihove rezultate. fn se može izvršiti tek kad obje faze uspješno završe. Kao prvi argument prima rezultat left, a kao drugi rezultat right, bez obzira na redoslijed dovršetka.
T je tip rezultata left, a U tip rezultata druge faze; mogu se razlikovati. right može biti bilo koji kompatibilni CompletionStage, ne nužno CompletableFuture. Vrijednost koju vrati BiFunction postaje rezultat tipa V u novom CompletableFuture<V>. Upotrijebi thenCompose kada ti prvi rezultat treba da bi odabrao ili pokrenuo sljedeću fazu.
Varijanta bez Async ne jamči zasebnu dretvu. Ako su oba rezultata već dostupna, funkcija se može izvršiti prije povratka iz thenCombine. thenCombineAsync(other, fn) koristi zadani mehanizam asinkronog izvršavanja, a thenCombineAsync(other, fn, executor) koristi predani Executor.
Ako bilo koja ulazna faza završi iznimkom, uključujući otkazivanje, fn se ne poziva. U OpenJDK-u 21 thenCombine čeka da završe obje ulazne faze prije nego što ovisna faza završi iznimkom. Ako druga ulazna faza nikad ne završi, ovisna faza može ostati nedovršena na neodređeno vrijeme. Ako obje ne uspiju, prijavljeni uzrok može potjecati iz bilo koje od njih. Iznimka koju baci fn također uzrokuje neuspjeh ovisne faze; pri dohvaćanju takvog rezultata join() baca CompletionException.
Primjeri
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());
}
}Rezultat
false 42
`rightCount` završava prvi, ali `total.isDone()` i dalje vraća `false`. Tek nakon dovršetka `leftCount` funkcija `Integer::sum` prima `18` i `24`, a `total.join()` vraća `42`.
Povezane lekcije
- Java · Lekcija 51 · Srednje · Verzija: 2