CompletableFuture | thenApply vs thenCompose

No puedo entender la diferencia entre thenApply() y thenCompose().

Entonces, ¿alguien podría proporcionar un caso de uso válido?

De los documentos de Java:

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

Devuelve un nuevo CompletionStageque, cuando esta etapa se completa normalmente, se ejecuta con el resultado de esta etapa como argumento de la función proporcionada.

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

Devuelve un nuevo CompletionStageque, cuando esta etapa se completa normalmente, se ejecuta con esta etapa como argumento para la función proporcionada.

Entiendo que el segundo argumento de thenComposeCompletionStage se extiende donde thenApplyno lo hace.

¿Alguien podría dar un ejemplo en qué caso debo usar thenApplyy cuándo thenCompose?

thenApply se utiliza si tiene una función de mapeo síncrono.

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

thenComposese utiliza si tiene una función de mapeo asincrónica (es decir, una que devuelve a CompletableFuture). Luego devolverá un futuro con el resultado directamente, en lugar de un futuro anidado.

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

Creo que la respuesta publicada por @Joe C es engañosa.

Permítanme intentar explicar la diferencia entre thenApplyy thenComposecon un ejemplo.

Supongamos que tenemos 2 métodos: getUserInfo(int userId)y getUserRating(UserInfo userInfo):

public CompletableFuture<UserInfo> getUserInfo(userId)

public CompletableFuture<UserRating> getUserRating(UserInfo)

Ambos tipos de retorno de método son CompletableFuture.

Queremos llamar getUserInfo()primero, y al finalizar, llamar getUserRating()con el resultado UserInfo.

Al finalizar el getUserInfo()método, probemos ambos thenApplyy thenCompose. La diferencia está en los tipos de devolución:

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

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

thenCompose()funciona como el de Scala,flatMap que aplana los futuros anidados.

thenApply()devolvió los futuros anidados como estaban, pero thenCompose()aplanó el anidado CompletableFuturespara que sea más fácil encadenar más llamadas a métodos.

Los Javadocs actualizados en Java 9 probablemente ayudarán a comprenderlo mejor:

luego aplicar

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

Devuelve un nuevo CompletionStageque, cuando esta etapa se completa normalmente, se ejecuta con el resultado de esta etapa como argumento de la función proporcionada.

Este método es análogo a Optional.mapy Stream.map.

Consulte la CompletionStagedocumentación para conocer las reglas que cubren la finalización excepcional.

luego componer

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

Devuelve un nuevo CompletionStageque se completa con el mismo valor que CompletionStagedevuelve la función dada.

Cuando esta etapa se completa normalmente, la función dada se invoca con el resultado de esta etapa como argumento, devolviendo otro CompletionStage. Cuando esa etapa se completa normalmente, lo CompletionStagedevuelto por este método se completa con el mismo valor.

Para asegurar el progreso, la función suministrada debe organizar la finalización final de su resultado.

Este método es análogo a Optional.flatMapy Stream.flatMap.

Consulte la CompletionStagedocumentación para conocer las reglas que cubren la finalización excepcional.

thenApplyy thenComposeson métodos de CompletableFuture. Úselos cuando tenga la intención de hacer algo con CompleteableFutureel resultado de to con a Function.

thenApplyy thenComposeambos devuelven un CompletableFuturecomo resultado. Puede encadenar varios thenApplyo thenComposejuntos. Suministre a Functiona cada llamada, cuyo resultado será la entrada a la siguiente Function.

El Functionque proporcionó a veces necesita hacer algo sincrónicamente. El tipo de retorno de su Functiondebe ser un no Futuretipo. En este caso debes usar 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

En otras ocasiones, es posible que desee realizar un procesamiento asincrónico en este Function. En ese caso deberías usar thenCompose. El tipo de retorno de su Functiondebería ser un CompletionStage. El siguiente Functionen la cadena obtendrá el resultado de eso CompletionStagecomo entrada, desenvolviendo así el 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

Esta es una idea similar a la de Javascript Promise. Promise.thenpuede aceptar una función que devuelve un valor o Promiseun valor. La razón por la que estos dos métodos tienen nombres diferentes en Java se debe al borrado genérico . Function<? super T,? extends U> fny Function<? super T,? extends CompletionStage<U>> fnse consideran del mismo tipo de tiempo de ejecución - Function. Por lo tanto, thenApplyy thenComposedebe tener un nombre distinto, o el compilador de Java se quejaría de firmas de métodos idénticas. El resultado final es que Javascript Promise.thense implementa en dos partes, thenApplyy thenComposeen Java.

Puede leer mi otra respuesta si también está confundido acerca de una función relacionada thenApplyAsync.