Java CompletableFuture: Asynchronous Programming Guide

This article explains Java's CompletableFuture, a powerful tool for asynchronous programming introduced in Java 8. It overcomes the limitations of the older Future interface by providing non‑blocking result retrieval and rich callback APIs.

It begins with a review of Future, showing how Future.get() blocks the thread and how CountDownLatch can be used to wait for multiple tasks, but the approach is cumbersome.

The article then introduces CompletableFuture, demonstrating its creation via CompletableFuture.supplyAsync and CompletableFuture.runAsync (with or without a custom Executor), and explains the four ways to obtain results: get() , get(timeout, unit) , getNow(valueIfAbsent) , and join() .

Further sections cover asynchronous callbacks: thenRun / thenRunAsync for chaining void‑returning tasks, thenAccept / thenAcceptAsync for consuming results, and thenApply / thenApplyAsync for transforming results. Code examples illustrate each pattern.

Exception handling is discussed with whenComplete and exceptionally , showing how to react to both normal completion and exceptions, and emphasizing that calling get() or join() is required to surface exceptions.

The piece also details task combination logic: AND relationships ( thenCombine , thenAcceptBoth , runAfterBoth ), OR relationships ( applyToEither , acceptEither , runAfterEither ), and multi‑task synchronizers allOf and anyOf , complete with sample code.

Finally, it outlines best practices: always retrieve results to expose exceptions, use timeouts with get() , prefer custom thread pools over the default ForkJoinPool, and choose an appropriate saturation policy (e.g., AbortPolicy ) when configuring pools.