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

Combining handle with Other CompletableFuture Methods

Integrate handle into complex async pipelines with thenCompose, thenCombine, and other combinators.

Combining handle with Other CompletableFuture Methods

What you'll learn: How to integrate handle seamlessly into complex async pipelines alongside thenCompose, thenCombine, and other combinators for robust error handling and result transformation.

The Core Idea

While handle is powerful on its own, its true strength emerges when you weave it into multi-stage async pipelines. You can place handle strategically within chains that use thenCompose for sequential operations, thenCombine for parallel merging, or other transformations like thenApply and thenAccept. This lets you recover from errors at specific pipeline stages while allowing the flow to continue.

Positioning handle in Complex Chains

Think of handle as a checkpoint in your async pipeline. You might:

  • After supplyAsync – catch initial failures early
  • Between thenCompose stages – recover from one async operation before starting the next
  • After thenCombine – handle errors from either of the combined futures
  • Before final consumption – normalize results before thenAccept
CompletableFuture.supplyAsync(() -> fetchUserId())
    .handle((id, ex) -> ex != null ? -1 : id) // recover from fetch failure
    .thenCompose(id -> id == -1 
        ? CompletableFuture.completedFuture("Guest")
        : loadUserName(id)) // continue with default or real data
    .thenApply(String::toUpperCase)
    .thenAccept(System.out::println);

Combining with thenCombine

CompletableFuture<Integer> priceData = fetchPrice()
    .handle((price, ex) -> ex != null ? 0 : price); // fallback to 0

CompletableFuture<Double> taxRate = fetchTaxRate();

priceData.thenCombine(taxRate, (price, rate) -> price * (1 + rate))
    .thenAccept(total -> System.out.println("Total: " + total));

Here, handle ensures one future never fails the combination—it provides a safe default.

Key Takeaway: Strategically placing handle within pipelines using thenCompose, thenCombine, and other methods creates resilient async workflows that gracefully recover from failures at specific stages without breaking the entire chain.