CompletableFuture | thenApply vs thenCompose

Ich kann den Unterschied zwischen thenApply() und nicht verstehen thenCompose().

Könnte jemand einen gültigen Anwendungsfall bereitstellen?

Aus den Java-Dokumenten:

thenApply(Function<? super T,? extends U> fn)

Gibt eine neue zurück CompletionStage, die, wenn diese Stufe normal abgeschlossen ist, mit dem Ergebnis dieser Stufe als Argument für die angegebene Funktion ausgeführt wird.

thenCompose(Function<? super T,? extends CompletionStage<U>> fn)

Gibt eine neue zurück CompletionStage, die, wenn diese Phase normal abgeschlossen ist, mit dieser Phase als Argument für die angegebene Funktion ausgeführt wird.

Ich verstehe, dass das 2. Argument von thenComposedie CompletionStage erweitert, wo thenApplydies nicht der Fall ist.

Könnte jemand ein Beispiel geben, in welchem ​​Fall ich thenApplywann verwenden muss thenCompose?

thenApply wird verwendet, wenn Sie eine synchrone Zuordnungsfunktion haben.

CompletableFuture<Integer> future = 
    CompletableFuture.supplyAsync(() -> 1)
                     .thenApply(x -> x+1);

thenComposewird verwendet, wenn Sie eine asynchrone Zuordnungsfunktion haben (dh eine, die a zurückgibt CompletableFuture). Es wird dann eine Zukunft mit dem Ergebnis direkt zurückgeben und nicht eine verschachtelte Zukunft.

CompletableFuture<Integer> future = 
    CompletableFuture.supplyAsync(() -> 1)
                     .thenCompose(x -> CompletableFuture.supplyAsync(() -> x+1));

Ich denke, die Antwort von @Joe C ist irreführend.

Lassen Sie mich versuchen, den Unterschied zwischen thenApplyund thenComposeanhand eines Beispiels zu erklären .

Nehmen wir an, wir haben zwei Methoden: getUserInfo(int userId)und getUserRating(UserInfo userInfo):

public CompletableFuture<UserInfo> getUserInfo(userId)

public CompletableFuture<UserRating> getUserRating(UserInfo)

Beide Methodenrückgabetypen sind CompletableFuture.

Wir möchten getUserInfo()zuerst anrufen und nach Abschluss getUserRating()mit dem Ergebnis anrufen UserInfo.

getUserInfo()Versuchen wir nach Abschluss der Methode beide thenApplyund thenCompose. Der Unterschied liegt in den Rückgabetypen:

CompletableFuture<CompletableFuture<UserRating>> f =
    userInfo.thenApply(this::getUserRating);

CompletableFuture<UserRating> relevanceFuture =
    userInfo.thenCompose(this::getUserRating);

thenCompose()funktioniert wie Scala,flatMap die verschachtelte Futures abflacht.

thenApply() gab die verschachtelten Futures so zurück, wie sie waren, aber thenCompose() abgeflacht CompletableFutures, damit es einfacher ist, mehr Methodenaufrufe an sie zu ketten.

Die aktualisierten Javadocs in Java 9 werden wahrscheinlich helfen, es besser zu verstehen:

dann anwenden

<U> CompletionStage<U> thenApply​(Function<? super T,? extends U> fn)

Gibt eine neue zurück CompletionStage, die, wenn diese Stufe normal abgeschlossen ist, mit dem Ergebnis dieser Stufe als Argument für die angegebene Funktion ausgeführt wird.

Diese Methode ist analog zu Optional.mapund Stream.map.

In der CompletionStageDokumentation finden Sie Regeln für außergewöhnliche Abschlüsse.

thenCompose

<U> CompletionStage<U> thenCompose​(Function<? super T,? extends CompletionStage<U>> fn)

Gibt eine neue zurück CompletionStage, die mit demselben Wert abgeschlossen ist wie die CompletionStagevon der angegebenen Funktion zurückgegebene.

Wenn diese Phase normal abgeschlossen ist, wird die angegebene Funktion mit dem Ergebnis dieser Phase als Argument aufgerufen und eine andere zurückgegeben CompletionStage. Wenn diese Phase normal abgeschlossen ist, wird die CompletionStagevon dieser Methode zurückgegebene Phase mit demselben Wert abgeschlossen.

Um den Fortschritt sicherzustellen, muss die bereitgestellte Funktion den endgültigen Abschluss ihres Ergebnisses veranlassen.

Diese Methode ist analog zu Optional.flatMapund Stream.flatMap.

In der CompletionStageDokumentation finden Sie Regeln für außergewöhnliche Abschlüsse.

thenApplyund thenComposesind Methoden von CompletableFuture. Verwenden Sie sie, wenn Sie beabsichtigen, mit a etwas zum CompleteableFutureErgebnis zu führen Function.

thenApplyund thenComposebeide geben a CompletableFutureals ihr eigenes Ergebnis zurück. Sie können mehrere thenApplyoder thenComposezusammen verketten. Geben Sie Functionfür jeden Anruf ein an, dessen Ergebnis die Eingabe für den nächsten sein wird Function.

Das von FunctionIhnen gelieferte muss manchmal etwas synchron machen. Der Rückgabetyp von Functionsollte ein Nicht- FutureTyp sein. In diesem Fall sollten Sie verwenden thenApply.

CompletableFuture.completedFuture(1)
    .thenApply((x)->x+1) // adding one to the result synchronously, returns int
    .thenApply((y)->System.println(y)); // value of y is 1 + 1 = 2

In anderen Fällen möchten Sie möglicherweise eine asynchrone Verarbeitung durchführen Function. In diesem Fall sollten Sie verwenden thenCompose. Der Rückgabetyp Ihres Functionsollte a sein CompletionStage. Der nächste Functionin der Kette erhält das Ergebnis CompletionStageals Eingabe und wickelt so das aus CompletionStage.

// addOneAsync may be implemented by using another thread, or calling a remote method
abstract CompletableFuture<Integer> addOneAsync(int input);

CompletableFuture.completedFuture(1)
    .thenCompose((x)->addOneAsync(x)) // doing something asynchronous, returns CompletableFuture<Integer>
    .thenApply((y)->System.println(y)); // y is an Integer, the result of CompletableFuture<Integer> above

Dies ist eine ähnliche Idee wie bei Javascript Promise. Promise.thenkann eine Funktion akzeptieren, die entweder einen Wert oder Promiseeinen Wert zurückgibt . Der Grund, warum diese beiden Methoden in Java unterschiedliche Namen haben, liegt in der generischen Löschung . Function<? super T,? extends U> fnund Function<? super T,? extends CompletionStage<U>> fngelten als der gleiche Runtime-Typ - Function. Daher thenApplyund thenComposemüssen eindeutig benannt werden, sonst würde sich der Java-Compiler über identische Methodensignaturen beschweren. Das Endergebnis ist, dass Javascript Promise.thenin zwei Teilen implementiert ist - thenApplyund thenCompose- in Java.

Du kannst lesen meine andere Antwort , wenn Sie auch über eine verwandte Funktion verwirrt sind thenApplyAsync.