CKTIS / Java
`CompletableFuture.thenCombine`: združevanje dveh rezultatov
`thenCombine` ustvari nov `CompletableFuture`, katerega vrednost se izračuna šele po uspešnem zaključku obeh vhodnih stopenj, na primer s seštevanjem vrednosti dveh neodvisnih števcev.
Različica: 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 funkcijo fn, ki je odvisna od dveh stopenj. Klic left.thenCombine(right, fn) ne zažene vhodnih izračunov in ne blokira niti med čakanjem na njuna rezultata. fn se lahko izvede šele, ko se obe stopnji uspešno zaključita. Kot prvi argument prejme rezultat left, kot drugega pa rezultat right, ne glede na vrstni red zaključka.
T je tip rezultata left, U pa tip rezultata druge stopnje; tipa se lahko razlikujeta. right je lahko kateri koli združljiv CompletionStage in ni nujno CompletableFuture. Vrednost, ki jo vrne BiFunction, postane rezultat tipa V novega CompletableFuture<V>. Uporabi thenCompose, kadar prvi rezultat potrebuješ za izbiro ali zagon naslednje stopnje.
Različica brez Async ne zagotavlja ločene niti. Če sta oba rezultata že na voljo, se lahko funkcija izvede, še preden se klic thenCombine vrne. thenCombineAsync(other, fn) uporablja privzeti mehanizem asinhronega izvajanja, thenCombineAsync(other, fn, executor) pa uporablja podani Executor.
Če se katera od vhodnih stopenj konča z izjemo, tudi zaradi preklica, se fn ne pokliče. V OpenJDK 21 thenCombine počaka, da se končata obe vhodni stopnji, preden se odvisna stopnja konča z izjemo. Če se druga vhodna stopnja nikoli ne konča, lahko odvisna stopnja ostane nedokončana za nedoločen čas. Če spodletita obe, lahko sporočeni vzrok izvira iz katere koli od njiju. Tudi izjema, ki jo vrže fn, povzroči neuspeh odvisne stopnje; pri pridobivanju takega rezultata join() vrže CompletionException.
Primeri
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` se zaključi prvi, vendar `total.isDone()` še vedno vrne `false`. Šele po zaključku `leftCount` funkcija `Integer::sum` prejme `18` in `24`, `total.join()` pa vrne `42`.
Povezane lekcije
- Java · Lekcija 51 · Srednja · Različica: 2