Class Result<T>
java.lang.Object
com.sure.tool.lang.Result<T>
- Type Parameters:
T- 成功值类型
显式错误传播的两态结果门面(成功值 / 失败信息)。
与异常流互补:适合业务校验、批量聚合等"失败信息需要显式携带"的场景,
支持 map(Function)/flatMap(Function) 链式短路、recover(Function) 恢复与
throwIfFailed() 终止式转换。零依赖,对标 Vavr Result。
使用示例:
Result<Integer> r = Result.ok(1)
.map(x -> x * 2) // 2
.onSuccess(v -> log(v))
.recover(e -> 0); // 失败恢复
if (r.isFailure()) { throw new BizException(r.getErrorMessage()); }
null 语义:ok(T) 允许 null 值;fail(String) 不允许 null
信息(立即 NPE);失败时 get()/throwIfFailed() 抛异常,
getOrNull()/getOrElse(T) 返回默认值。
- Since:
- 1.12.0
-
Method Summary
Modifier and TypeMethodDescriptionstatic <T> Result<T> 失败结果(仅信息)。static <T> Result<T> 失败结果(信息 + 异常)。static <T> Result<T> 失败结果(携带异常)。<U> Result<U> 平铺映射(失败短路保留原错误;mapper 返回 null 视为成功 null 值)。get()获取成功值(失败抛NoSuchElementException)。getCause()获取失败异常(成功返回 null)。获取失败信息(成功返回 null)。获取成功值;失败返回默认值。getOrElseGet(Supplier<T> supplier) 获取成功值;失败时由供应器提供。获取成功值;失败返回 null。boolean是否失败。boolean是否成功。<U> Result<U> 映射成功值(失败短路保留原错误)。static <T> Result<T> ok(T value) 成功结果。失败时回调(链式可用,返回自身)。成功时回调(链式可用,返回自身)。失败恢复:将失败转换为成功值(成功原样返回)。失败时抛出异常(携带 cause),成功返回自身值。转 JDK Optional(失败为空)。toString()
-
Method Details
-
ok
成功结果。- Type Parameters:
T- 泛型- Parameters:
value- 值(可为 null)- Returns:
- Result
-
fail
-
fail
-
fail
-
isSuccess
public boolean isSuccess()是否成功。- Returns:
- true=成功
-
isFailure
public boolean isFailure()是否失败。- Returns:
- true=失败
-
get
-
getOrNull
-
getOrElse
-
getOrElseGet
-
map
-
flatMap
-
onSuccess
-
onFailure
-
recover
-
throwIfFailed
失败时抛出异常(携带 cause),成功返回自身值。- Returns:
- 成功值
- Throws:
RuntimeException- 失败时(cause 为原始异常,无 cause 时含错误信息)
-
getErrorMessage
-
getCause
-
toOptional
-
toString
-