Class NullUtil

java.lang.Object
com.sure.tool.lang.NullUtil

public final class NullUtil extends Object
统一 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 Details

    • isNull

      public static boolean isNull(Object obj)
      是否为 null。
      Parameters:
      obj - 对象
      Returns:
      true=null
    • isNonNull

      public static boolean isNonNull(Object obj)
      是否非 null。
      Parameters:
      obj - 对象
      Returns:
      true=非 null
    • isAnyNull

      public static boolean isAnyNull(Object... values)
      是否任一为 null。
      Parameters:
      values - 值列表
      Returns:
      true=至少一个为 null
    • isAllNull

      public static boolean isAllNull(Object... values)
      是否全部为 null。
      Parameters:
      values - 值列表
      Returns:
      true=全部为 null(空数组/空入参视为 true)
    • firstNonNull

      @SafeVarargs public static <T> T firstNonNull(T... values)
      取首个非 null 值(委托 ArrayUtil.firstNonNull(T...))。
      Type Parameters:
      T - 泛型
      Parameters:
      values - 值列表
      Returns:
      首个非 null 值;全 null 返回 null
    • lastNonNull

      @SafeVarargs public static <T> T lastNonNull(T... values)
      取最后一个非 null 值。
      Type Parameters:
      T - 泛型
      Parameters:
      values - 值列表
      Returns:
      最后一个非 null 值;全 null 返回 null
    • coalesce

      @SafeVarargs public static <T> T coalesce(T... values)
      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

      public static <T> T defaultIfNull(T obj, Supplier<T> defaultValue)
      null 时由供应器提供默认值(延迟求值)。
      Type Parameters:
      T - 泛型
      Parameters:
      obj - 对象
      defaultValue - 默认值供应器
      Returns:
      非 null 返回对象本身,否则供应值
    • applyIfNotNull

      public static <T,U> Option<U> applyIfNotNull(T value, Function<? super T, ? extends U> mapper)
      值非 null 时安全应用映射,返回 Option(仅短路显式 null; 映射函数内部异常——含 NPE——正常传播,便于定位调用方 bug)。
      Type Parameters:
      T - 输入泛型
      U - 输出泛型
      Parameters:
      value - 值(可为 null)
      mapper - 映射函数(返回 null 视为空)
      Returns:
      Option:null 输入/映射结果为 null 时转空,否则为映射值
    • consumeIfNotNull

      public static <T> void consumeIfNotNull(T value, Consumer<? super T> consumer)
      值非 null 时消费(空入参静默忽略)。
      Type Parameters:
      T - 泛型
      Parameters:
      value - 值(可为 null)
      consumer - 消费者
    • nullSafeToString

      public static String nullSafeToString(Object obj)
      null 安全转字符串(null 返回空串,不抛 NPE)。
      Parameters:
      obj - 对象(可为 null)
      Returns:
      null 时为 "",否则 String.valueOf(obj)