r/java • u/javaprof • Aug 27 '25
Community JEP: Explicit Results (recoverable errors)
Java today leaves us with three main tools for error handling:
Exceptions → great for non-local/unrecoverable issues (frameworks, invariants).
null / sentinels → terse, but ambiguous and unsafe in chains/collections.
Wrappers (Optional, Either, Try, Result) → expressive but verbose and don’t mesh with Java’s switch / flow typing.
I’d like to discuss a new idea: Explicit Results.
A function’s return type directly encodes its possible success value + recoverable errors.
Syntax idea
Introduce a new error kind of type and use in unions:
error record NotFound()
error record PermissionDenied(String reason)
User | NotFound | PermissionDenied loadUser(String id);Exactly one value type + N error tags.
Error tags are value-like and live under a disjoint root (ErrorTag, name TBD).
Exceptions remain for non-local/unrecoverable problems.
Examples
Exhaustive handling
switch (loadUser("42")) {
case User u -> greet(u);
case NotFound _ -> log("no user");
case PermissionDenied _ -> log("denied");
}Propagation (short-circuit if error)
Order | NotFound | PermissionDenied | AddressMissing place(String id) {
var u = try loadUser(id); // auto-return error if NotFound/PermissionDenied
var a = try loadAddress(u.id());
return createOrder(u, a);
}Streams interop
Stream<User | NotFound> results = ids.stream().map(this::loadUser);
// keep only successful users
Stream<User> okUsers = results.flatMap(r ->
switch (r) {
case User u -> Stream.of(u);
default -> Stream.of();
}
);
1
u/klekpl Aug 28 '25 edited Aug 29 '25
The point is that union types are orthogonal to exceptions. So
tryand propagation stays the same:Streams example:
(Not sure what you mean when talking about
Throwableand stacktraces - stacktraces can already be disabled by using https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Throwable.html#%3Cinit%3E(java.lang.String,java.lang.Throwable,boolean,boolean) constructor)Sealed types are not equivalent as they are nominal. So you cannot define ad-hoc supertype for two unrelated types like
IOEexception | BusinessException.EDIT: added paragraph about sealed types.