Handle success and failure in Java without exceptions

Wave goodbye to slow exceptions and embrace clean, efficient error handling by encapsulating operations that may succeed or fail in a type-safe way.

Start here Fork me on GitHub

Result is a Java library for modeling operation outcomes explicitly. It gives you a simpler, faster alternative to exception-driven flow when you want to represent both success and failure in a single, composable type.

Why Result?

Optional is great for values that may be present or absent, but it does not explain why something is missing. Result fills that gap by carrying either a successful value or a failure reason, so your code can describe what happened instead of hiding it.

Mental Model

Quick Start

1

Create a result from an operation

Result<User, Exception> result = Results.ofCallable(() -> db.getUser(id));

2

Inspect whether it succeeded or failed

result.ifFailure(error -> logger.error("Couldn't get user: {}", id, error));

3

Transform it if needed, then unwrap it as required

String name = result.mapSuccess(User::name).orElse("Anonymous");

Latest Releases

Available in

Works with

Works with

Maven

<dependencies>
    <dependency>
        <groupId>com.leakyabstractions</groupId>
        <artifactId>result</artifactId>
        <version>1.0.0.0</version>
    </dependency>
</dependencies>

Gradle

Add-Ons

Integrate Result with popular libraries.

Assert results fluently with

Serialize results to JSON with

Demo Projects

Try it for yourself in 5 minutes.

Works with

Works with

Features

Boost Performance

Avoid exception overhead and benefit from faster operations

Simple API

Leverage a familiar interface for a smooth learning curve

Streamlined Error Handling

Handle failure explicitly to simplify error propagation

Safe Execution

Ensure safer and more predictable operation outcomes

Enhanced Readability

Reduce complexity to make your code easier to understand

Functional Style

Embrace elegant, functional programming paradigms

Lightweight

Keep your project slim with no extra dependencies

Open Source

Enjoy transparent, permissive Apache 2 licensing

Pure Java

Seamless compatibility from JDK8 to the latest versions

Ready to Tap into the Power of Results?

Read the guide and transform your error handling today.

🌱Getting Started🪴Basic Usage🚀Advanced Usage

Also available as an ebook in multiple formats. Download your free copy now!

TL;DR

Not a fan of reading long docs? No worries! Tune in to Deep Dive, a podcast generated by NetbookLM. In just a few minutes, you'll get the essential details and a fun intro to what this library can do for you!