CompletableFuture | thenApply против thenCompose

Я не могу понять разницу между thenApply() и thenCompose().

Итак, может ли кто-нибудь предоставить допустимый вариант использования?

Из документов Java:

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

Возвращает новое значение, CompletionStageкоторое при нормальном завершении этого этапа выполняется с результатом этого этапа в качестве аргумента предоставленной функции.

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

Возвращает новое значение, CompletionStageкоторое, когда этот этап завершается нормально, выполняется с этим этапом в качестве аргумента предоставленной функции.

Я понимаю, что второй аргумент thenComposeрасширяет CompletionStage там, где thenApplyего нет.

Может ли кто-нибудь привести пример, в каком случае я должен использовать thenApplyи когда thenCompose?

thenApply используется, если у вас есть функция синхронного сопоставления.

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

thenComposeиспользуется, если у вас есть функция асинхронного сопоставления (т. е. та, которая возвращает a CompletableFuture). Затем он вернет будущее с результатом напрямую, а не вложенное будущее.

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

Я думаю, что ответ, опубликованный @Joe C, вводит в заблуждение.

Позвольте мне попытаться объяснить разницу между thenApplyи thenComposeна примере.

Предположим, у нас есть 2 метода: getUserInfo(int userId)и getUserRating(UserInfo userInfo):

public CompletableFuture<UserInfo> getUserInfo(userId)

public CompletableFuture<UserRating> getUserRating(UserInfo)

Оба типа возвращаемых методов - это CompletableFuture.

Мы хотим getUserInfo()сначала вызвать , а по его завершении вызвать getUserRating()с результатом UserInfo.

По завершении getUserInfo()метода давайте попробуем оба thenApplyи thenCompose. Разница в возвращаемых типах:

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

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

thenCompose()работает как Scala,flatMap который выравнивает вложенные фьючерсы.

thenApply()вернули вложенные фьючерсы такими, какие они были, но thenCompose()сгладили вложенные, CompletableFuturesчтобы было легче связать с ним больше вызовов методов.

Обновленные Javadocs в Java 9, вероятно, помогут лучше понять это:

thenApply

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

Возвращает новое значение, CompletionStageкоторое при нормальном завершении этого этапа выполняется с результатом этого этапа в качестве аргумента предоставленной функции.

Этот метод аналогичен Optional.mapи Stream.map.

Смотрите в CompletionStageдокументации правила, касающиеся исключительного завершения.

thenCompose

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

Возвращает новый, CompletionStageкоторый завершается тем же значением, что и CompletionStageвозвращаемое данной функцией.

Когда этот этап завершается нормально, данная функция вызывается с результатом этого этапа в качестве аргумента, возвращая другой CompletionStage. Когда этот этап завершается нормально, CompletionStageвозвращаемое этим методом значение завершается с тем же значением.

Для обеспечения прогресса предоставленная функция должна обеспечить окончательное завершение своего результата.

Этот метод аналогичен Optional.flatMapи Stream.flatMap.

Смотрите в CompletionStageдокументации правила, касающиеся исключительного завершения.

thenApplyи thenComposeявляются методами CompletableFuture. Используйте их, когда намереваетесь сделать что-то, чтобы добиться CompleteableFutureрезультата с помощью Function.

thenApplyи thenComposeоба возвращают CompletableFutureкак свой собственный результат. Вы можете объединить несколько thenApplyили thenComposeвместе. Поставьте a Functionдля каждого вызова, результат которого будет вводом для следующего Function.

Предоставленному Functionвами иногда необходимо что-то делать синхронно. Тип возврата вашего Functionдолжен быть не Futureтипом. В этом случае вам следует использовать 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

В других случаях вы можете захотеть выполнить здесь асинхронную обработку Function. В этом случае вам следует использовать thenCompose. Тип возврата вашего Functionдолжен быть CompletionStage. Следующий Functionв цепочке получит результат CompletionStageкак входной, таким образом разворачивая файл 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

Это похоже на идею Javascript Promise. Promise.thenможет принимать функцию, которая либо возвращает значение, либо Promiseзначение. Причина, по которой эти два метода имеют разные имена в Java, связана с общим стиранием . Function<? super T,? extends U> fnи Function<? super T,? extends CompletionStage<U>> fnсчитаются одним и тем же типом среды выполнения - Function. Таким образом, thenApplyи thenComposeон должен быть четко назван, иначе компилятор Java будет жаловаться на идентичные сигнатуры методов. Конечным результатом является то, что Javascript Promise.thenреализован в двух частях - thenApplyи thenCompose- в Java.

Вы можете прочитать мой другой ответ, если вас не смущает связанная функция thenApplyAsync.