Course contentsShow
← Java
Lesson 2805 of 2,87051. CompletableFutureFree lesson

thenApply vs map in Stream API

Drawing parallels between thenApply on CompletableFuture and map on Stream for conceptual clarity.

thenApply vs map in Stream API

You'll learn: How thenApply on CompletableFuture mirrors map on Stream, making both easier to understand conceptually.

The Conceptual Parallel

If you're comfortable with Stream's map(), you already understand thenApply()—they're the same transformation pattern applied to different contexts.

Stream's map() transforms each element in a pipeline:

List.of(1, 2, 3).stream()
    .map(x -> x * 2)
    .map(x -> "Value: " + x)
    .collect(Collectors.toList());

CompletableFuture's thenApply() transforms a single asynchronous value in a pipeline:

CompletableFuture.supplyAsync(() -> 1)
    .thenApply(x -> x * 2)
    .thenApply(x -> "Value: " + x)
    .join();

Why They're Alike

Both operations:

  • Transform values without side effects
  • Return a new wrapped result (Stream or CompletableFuture)
  • Chain fluently for multi-step transformations
  • Preserve the container structure (you still have a Stream/CompletableFuture afterward)

The Key Difference

The difference is what they operate on:

  • map operates on multiple values flowing through time (a spatial collection)
  • thenApply operates on one value arriving in the future (a temporal container)

Think of map as transforming many items on a conveyor belt, while thenApply transforms a single package that hasn't been delivered yet.

Why This Matters

Recognizing this pattern helps you transfer Stream knowledge to async programming. Both are about declarative, composable transformations—just in different contexts.

Key Takeaway: thenApply is to CompletableFuture what map is to Stream—both apply synchronous transformations to wrapped values in a chainable, functional style.