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

The handle Method: Signature and Purpose

Learn the handle method's BiFunction signature and how it processes both results and exceptions uniformly.

The handle Method: Signature and Purpose

You'll learn how handle provides a unified way to process both successful results and exceptions in a CompletableFuture pipeline.

What handle Does

Unlike exceptionally, which only deals with errors, handle receives both the result (if successful) and the exception (if failed) as parameters. Think of it as a universal processor that handles all outcomes—like a Swiss Army knife for completion handling.

The method signature looks like this:

CompletableFuture<U> handle(BiFunction<T, Throwable, U> fn)

The BiFunction takes two arguments:

  • First parameter: The result of type T (or null if an exception occurred)
  • Second parameter: The exception of type Throwable (or null if successful)

How It Works

The handle method always executes, regardless of whether the pipeline succeeded or failed. You check which parameter is null to determine what happened:

CompletableFuture.supplyAsync(() -> riskyOperation())
    .handle((result, exception) -> {
        if (exception != null) {
            // Handle error case
            return "Error: " + exception.getMessage();
        } else {
            // Handle success case
            return "Success: " + result;
        }
    });

Why Use handle Instead of exceptionally?

Use handle when you need to:

  • Transform both success and error cases uniformly
  • Access the result and exception in one place
  • Apply conditional logic based on completion state

It's like having a single gate that processes all traffic, rather than separate lanes for success and failure.

Key Takeaway: The handle method's BiFunction<T, Throwable, U> signature lets you process both successful results and exceptions in a single callback, providing unified control over all completion scenarios.