Class NullUtil
java.lang.Object
com.sure.tool.lang.NullUtil
统一 null 门面:判断 / 取值 / 安全调用 / 展示。
使用示例:
// 判断
NullUtil.isNull(x); // x == null
NullUtil.isAnyNull(a, b, c); // 任一为 null
// 取值
String v = NullUtil.firstNonNull(a, b, "default"); // 首个非 null
String w = NullUtil.defaultIfNull(x, () -> "fallback");
// 安全调用(null 输入/结果转空;映射内部异常正常传播)
Option<String> name = NullUtil.applyIfNotNull(user, User::getName);
// 展示
String s = NullUtil.nullSafeToString(obj); // null -> ""
null 语义:除 applyIfNotNull(T, Function) 外所有方法均安全接受 null
入参且不抛 NPE;返回 Option 的方法将 null 输入/中间结果视为空。
- Since:
- 1.12.0
-
Method Summary
Modifier and TypeMethodDescriptionstatic <T,U> Option <U> applyIfNotNull(T value, Function<? super T, ? extends U> mapper) 值非 null 时安全应用映射,返回Option(仅短路显式 null; 映射函数内部异常——含 NPE——正常传播,便于定位调用方 bug)。static <T> Tcoalesce(T... values) SQL COALESCE 语义:取首个非 null 值(firstNonNull(T...)别名)。static <T> voidconsumeIfNotNull(T value, Consumer<? super T> consumer) 值非 null 时消费(空入参静默忽略)。static <T> TdefaultIfNull(T obj, Supplier<T> defaultValue) null 时由供应器提供默认值(延迟求值)。static <T> TdefaultIfNull(T obj, T defaultValue) null 时返回默认值(委托ObjectUtil.defaultIfNull(T, T))。static <T> TfirstNonNull(T... values) 取首个非 null 值(委托ArrayUtil.firstNonNull(T...))。static boolean是否全部为 null。static boolean是否任一为 null。static boolean是否非 null。static boolean是否为 null。static <T> TlastNonNull(T... values) 取最后一个非 null 值。static StringnullSafeToString(Object obj) null 安全转字符串(null 返回空串,不抛 NPE)。
-
Method Details
-
isNull
-
isNonNull
-
isAnyNull
是否任一为 null。- Parameters:
values- 值列表- Returns:
- true=至少一个为 null
-
isAllNull
是否全部为 null。- Parameters:
values- 值列表- Returns:
- true=全部为 null(空数组/空入参视为 true)
-
firstNonNull
取首个非 null 值(委托ArrayUtil.firstNonNull(T...))。- Type Parameters:
T- 泛型- Parameters:
values- 值列表- Returns:
- 首个非 null 值;全 null 返回 null
-
lastNonNull
取最后一个非 null 值。- Type Parameters:
T- 泛型- Parameters:
values- 值列表- Returns:
- 最后一个非 null 值;全 null 返回 null
-
coalesce
SQL COALESCE 语义:取首个非 null 值(firstNonNull(T...)别名)。- Type Parameters:
T- 泛型- Parameters:
values- 值列表- Returns:
- 首个非 null 值;全 null 返回 null
-
defaultIfNull
public static <T> T defaultIfNull(T obj, T defaultValue) null 时返回默认值(委托ObjectUtil.defaultIfNull(T, T))。- Type Parameters:
T- 泛型- Parameters:
obj- 对象defaultValue- 默认值- Returns:
- 非 null 返回对象本身,否则默认值
-
defaultIfNull
null 时由供应器提供默认值(延迟求值)。- Type Parameters:
T- 泛型- Parameters:
obj- 对象defaultValue- 默认值供应器- Returns:
- 非 null 返回对象本身,否则供应值
-
applyIfNotNull
值非 null 时安全应用映射,返回Option(仅短路显式 null; 映射函数内部异常——含 NPE——正常传播,便于定位调用方 bug)。- Type Parameters:
T- 输入泛型U- 输出泛型- Parameters:
value- 值(可为 null)mapper- 映射函数(返回 null 视为空)- Returns:
- Option:null 输入/映射结果为 null 时转空,否则为映射值
-
consumeIfNotNull
值非 null 时消费(空入参静默忽略)。- Type Parameters:
T- 泛型- Parameters:
value- 值(可为 null)consumer- 消费者
-
nullSafeToString
-