Class ObjectUtil

java.lang.Object
com.sure.tool.util.ObjectUtil

public class ObjectUtil extends Object
对象工具类,参考 Hutool 的 ObjectUtil 设计。

English: Null-safe object comparison, defaulting and type inspection helpers.

Since:
0.1.0
Author:
suretool
  • Method Summary

    Modifier and Type
    Method
    Description
    static <T> T
    clone(T obj)
    克隆对象(对象需实现 Cloneable)。
    static <T> T
    通过序列化克隆对象(对象及其成员需实现 Serializable)。
    static <T> int
    compare(T a, T b)
    空安全比较(null 视为最小),值须实现 Comparable。
    static <T> T
    defaultIfEmpty(T obj, T defaultValue)
    对象为空时使用默认值(空字符串、空集合、空数组等视为空)。
    static <T> T
    defaultIfNull(T obj, T defaultValue)
    对象为 null 时使用默认值。
    static Object
    deserialize(byte[] bytes)
    字节数组反序列化为对象。
    static Object
    空值转 null(空字符串、空集合、空 Map、空数组)。
    static boolean
    equals(Object obj1, Object obj2)
    深度比较两个对象是否相等(数组按元素比较)。
    static Class<?>
    获取对象的类。
    static String
    类名(数组含维数,如 int[] → int[])。
    static int
    获取对象的 hashCode。
    static String
    获取对象的身份标识字符串:类名@十六进制哈希。
    static boolean
    是否全部非 null。
    static boolean
    isAllNull(Object... objs)
    是否全部为 null。
    static boolean
    isBasicType(Class<?> clazz)
    是否基本类型或其包装类(含 String、BigDecimal 等常用值类型)。
    static boolean
    是否基本类型或其包装类(含 String、BigDecimal 等常用值类型)。
    static boolean
    对象是否为空:null、空字符串、空集合、空 Map、空数组、空 Optional。
    static boolean
    对象是否非空。
    static boolean
    对象是否非 null。
    static boolean
    对象是否为 null。
    static boolean
    判断对象是否为有效数字值(null、空字符串或非数字返回 false)。
    static int
    获取对象长度:数组/CharSequence/Collection/Map,其它类型返回 1,null 返回 0。
    static boolean
    notEqual(Object obj1, Object obj2)
    对象是否不相等。
    static byte[]
    对象序列化为字节数组。
    static String
    对象转字符串,null 返回空串。
    static String
    toString(Object obj, String defaultValue)
    对象转字符串,null 返回默认值。

    Methods inherited from class Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Method Details

    • isNull

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

      public static boolean isNotNull(Object obj)
      对象是否非 null。
      Parameters:
      obj - 对象
      Returns:
      是否非 null
    • isEmpty

      public static boolean isEmpty(Object obj)
      对象是否为空:null、空字符串、空集合、空 Map、空数组、空 Optional。
      Parameters:
      obj - 对象
      Returns:
      是否为空
    • isNotEmpty

      public static boolean isNotEmpty(Object obj)
      对象是否非空。
      Parameters:
      obj - 对象
      Returns:
      是否非空
    • equals

      public static boolean equals(Object obj1, Object obj2)
      深度比较两个对象是否相等(数组按元素比较)。
      Parameters:
      obj1 - 对象 1
      obj2 - 对象 2
      Returns:
      是否相等
    • notEqual

      public static boolean notEqual(Object obj1, Object obj2)
      对象是否不相等。
      Parameters:
      obj1 - 对象 1
      obj2 - 对象 2
      Returns:
      是否不相等
    • hashCode

      public static int hashCode(Object obj)
      获取对象的 hashCode。
      Parameters:
      obj - 对象
      Returns:
      hashCode
    • identityToString

      public static String identityToString(Object obj)
      获取对象的身份标识字符串:类名@十六进制哈希。
      Parameters:
      obj - 对象
      Returns:
      身份标识字符串
    • getClass

      public static Class<?> getClass(Object obj)
      获取对象的类。
      Parameters:
      obj - 对象
      Returns:
      对象的类,null 对象返回 null
    • defaultIfNull

      public static <T> T defaultIfNull(T obj, T defaultValue)
      对象为 null 时使用默认值。
      Type Parameters:
      T - 类型
      Parameters:
      obj - 对象
      defaultValue - 默认值
      Returns:
      非 null 返回原对象,否则返回默认值
    • defaultIfEmpty

      public static <T> T defaultIfEmpty(T obj, T defaultValue)
      对象为空时使用默认值(空字符串、空集合、空数组等视为空)。
      Type Parameters:
      T - 类型
      Parameters:
      obj - 对象
      defaultValue - 默认值
      Returns:
      非空返回原对象,否则返回默认值
    • clone

      public static <T> T clone(T obj)
      克隆对象(对象需实现 Cloneable)。
      Type Parameters:
      T - 类型
      Parameters:
      obj - 对象
      Returns:
      克隆后的对象,克隆失败返回 null
    • cloneByStream

      public static <T> T cloneByStream(T obj)
      通过序列化克隆对象(对象及其成员需实现 Serializable)。
      Type Parameters:
      T - 类型
      Parameters:
      obj - 对象
      Returns:
      克隆后的对象,失败时返回 null
    • serialize

      public static byte[] serialize(Object obj)
      对象序列化为字节数组。
      Parameters:
      obj - 对象(需实现 Serializable)
      Returns:
      字节数组,失败返回 null
    • deserialize

      public static Object deserialize(byte[] bytes)
      字节数组反序列化为对象。
      Parameters:
      bytes - 字节数组
      Returns:
      对象,失败返回 null
    • isAllNotNull

      public static boolean isAllNotNull(Object... objs)
      是否全部非 null。
      Parameters:
      objs - 对象数组
      Returns:
      全部非 null 返回 true
    • isAllNull

      public static boolean isAllNull(Object... objs)
      是否全部为 null。
      Parameters:
      objs - 对象数组
      Returns:
      全部 null 返回 true
    • compare

      public static <T> int compare(T a, T b)
      空安全比较(null 视为最小),值须实现 Comparable。
      Type Parameters:
      T - 类型
      Parameters:
      a - 第一个
      b - 第二个
      Returns:
      -1/0/1
    • isBasicType

      public static boolean isBasicType(Object obj)
      是否基本类型或其包装类(含 String、BigDecimal 等常用值类型)。
      Parameters:
      obj - 对象
      Returns:
      是否值类型
    • isBasicType

      public static boolean isBasicType(Class<?> clazz)
      是否基本类型或其包装类(含 String、BigDecimal 等常用值类型)。
      Parameters:
      clazz - 类型
      Returns:
      是否值类型
    • getClassName

      public static String getClassName(Object obj)
      类名(数组含维数,如 int[] → int[])。
      Parameters:
      obj - 对象
      Returns:
      类名;null 返回 null
    • toString

      public static String toString(Object obj)
      对象转字符串,null 返回空串。
      Parameters:
      obj - 对象
      Returns:
      字符串
    • toString

      public static String toString(Object obj, String defaultValue)
      对象转字符串,null 返回默认值。
      Parameters:
      obj - 对象
      defaultValue - 默认值
      Returns:
      字符串
    • length

      public static int length(Object obj)
      获取对象长度:数组/CharSequence/Collection/Map,其它类型返回 1,null 返回 0。
      Parameters:
      obj - 对象
      Returns:
      长度
    • emptyToNull

      public static Object emptyToNull(Object obj)
      空值转 null(空字符串、空集合、空 Map、空数组)。
      Parameters:
      obj - 对象
      Returns:
      空值返回 null,否则返回原对象
    • isValidIfNumber

      public static boolean isValidIfNumber(Object obj)
      判断对象是否为有效数字值(null、空字符串或非数字返回 false)。
      Parameters:
      obj - 对象
      Returns:
      是否为有效数字