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

What thenApply Does: Synchronous Transformation

Understanding thenApply as a method to transform a CompletableFuture's result once it completes.

What thenApply Does: Synchronous Transformation

You'll learn how thenApply transforms the result of a CompletableFuture once it completes, creating a new future with the transformed value.

The Core Idea

thenApply is a method that lets you chain a transformation onto a CompletableFuture. When the original future completes successfully, thenApply applies a function to that result and returns a new CompletableFuture containing the transformed value.

Think of it like an assembly line: the first station produces a raw result, and thenApply is the next station that processes that result into something else. The whole pipeline remains asynchronous and non-blocking.

How It Works

When you call thenApply on a CompletableFuture, you provide a transformation function (typically a lambda). This function:

  • Takes the completed result as input
  • Returns a transformed output
  • Executes synchronously in whatever thread completes the original future
CompletableFuture<Integer> future = CompletableFuture.supplyAsync(() -> 5);

CompletableFuture<Integer> doubled = future.thenApply(result -> result * 2);

// When future completes with 5, doubled will complete with 10

Key Characteristics

  • Synchronous execution: The transformation happens in the same thread that completes the prior stage
  • Returns a new future: You get a CompletableFuture of the transformed type
  • Chainable: You can call thenApply multiple times to build a pipeline
  • Exception propagation: If the original future fails, thenApply never executes

Key Takeaway: thenApply transforms a CompletableFuture's successful result into a new value, creating a composable pipeline where each stage processes the output of the previous one—all without blocking your calling thread.