coldbox-async-programming

Parallel tasks in ColdBox execute asynchronously using non-blocking thread pools and ColdBox Futures backed by Java CompletableFuture. This safely isolates long-running or CPU-bound work from the main HTTP request thread, maintaining responsiveness and reducing latency for aggregate operations.

Processing large collections in parallel uses the allApply primitive alongside a named fixed thread-pool executor. This concurrently maps collection elements, such as generating order mementos, while safely managing the executor lifecycle and aggregating results without blocking the request.

ColdBox async executors support scheduling periodic background jobs through registered named pools like fixed, cached, single, or scheduled executors. You configure the executor lifecycle, dispatch fire-and-forget work, and monitor or shut down pools to safely manage recurring tasks.

ColdBox Futures handle timeouts and exceptions by chaining asynchronous pipelines with error-safe transformations. They provide built-in controls for timeout thresholds and fallback mechanisms, ensuring async pipelines fail gracefully without crashing the application.

ColdBox async programming allows dispatching fire-and-forget tasks without loading the full application context. This option enables lightweight background work execution, bypassing WireBox, CacheBox, and LogBox initialization for faster parallel processing.

Use the anyOf parallel primitive when you need the fastest response from concurrent operations rather than waiting for every result. Unlike all or allApply which aggregate complete collections, anyOf picks the first completed future to minimize latency for time-sensitive workloads.