ObjectUtil (hutool-core 5.7.15 API)

java.lang.Object
- cn.hutool.core.util.ObjectUtil

```
public class ObjectUtil
extends Object
```
对象工具类，包括判空、克隆、序列化等操作

作者:

Looly

构造器概要

构造器
构造器和说明

ObjectUtil()

构造器
构造器和说明
`ObjectUtil()`

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static <T> T`	`clone(T obj)` 克隆对象如果对象实现Cloneable接口，调用其clone方法如果实现Serializable接口，执行深度克隆否则返回`null`
`static <T> T`	`cloneByStream(T obj)` 序列化后拷贝流的方式克隆对象必须实现Serializable接口
`static <T> T`	`cloneIfPossible(T obj)` 返回克隆后的对象，如果克隆失败，返回原对象
`static <T extends Comparable<? super T>> int`	`compare(T c1, T c2)` `null`安全的对象比较，`null`对象排在末尾
`static <T extends Comparable<? super T>> int`	`compare(T c1, T c2, boolean nullGreater)` `null`安全的对象比较
`static boolean`	`contains(Object obj, Object element)` 对象中是否包含元素支持的对象类型包括： String Collection Map Iterator Enumeration Array
`static <T extends CharSequence> T`	`defaultIfBlank(T str, T defaultValue)` 如果给定对象为`null`或者""或者空白符返回默认值 ObjectUtil.defaultIfBlank(null, null) = null ObjectUtil.defaultIfBlank(null, "") = "" ObjectUtil.defaultIfBlank("", "zz") = "zz" ObjectUtil.defaultIfBlank(" ", "zz") = "zz" ObjectUtil.defaultIfBlank("abc", *) = "abc"
`static <T> T`	`defaultIfEmpty(String str, Supplier<? extends T> handle, T defaultValue)` 如果给定对象为`null`或者""返回默认值, 否则返回自定义handle处理后的返回值
`static <T extends CharSequence> T`	`defaultIfEmpty(T str, T defaultValue)` 如果给定对象为`null`或者 "" 返回默认值 ObjectUtil.defaultIfEmpty(null, null) = null ObjectUtil.defaultIfEmpty(null, "") = "" ObjectUtil.defaultIfEmpty("", "zz") = "zz" ObjectUtil.defaultIfEmpty(" ", "zz") = " " ObjectUtil.defaultIfEmpty("abc", *) = "abc"
`static <T> T`	`defaultIfNull(Object source, Supplier<? extends T> handle, T defaultValue)` 如果给定对象为`null` 返回默认值, 如果不为null 返回自定义handle处理后的返回值
`static <T> T`	`defaultIfNull(T object, T defaultValue)` 如果给定对象为`null`返回默认值 ObjectUtil.defaultIfNull(null, null) = null ObjectUtil.defaultIfNull(null, "") = "" ObjectUtil.defaultIfNull(null, "zz") = "zz" ObjectUtil.defaultIfNull("abc", ) = "abc" ObjectUtil.defaultIfNull(Boolean.TRUE, ) = Boolean.TRUE
`static <T> T`	`deserialize(byte[] bytes)` 反序列化对象必须实现Serializable接口注意！！！
`static int`	`emptyCount(Object... objs)` 存在多少个`null`或空对象，通过`isEmpty(Object)` 判断元素
`static boolean`	`equal(Object obj1, Object obj2)` 比较两个对象是否相等。
`static boolean`	`equals(Object obj1, Object obj2)` 比较两个对象是否相等，此方法是 `equal(Object, Object)`的别名方法。
`static Class<?>`	`getTypeArgument(Object obj)` 获得给定类的第一个泛型参数
`static Class<?>`	`getTypeArgument(Object obj, int index)` 获得给定类的第一个泛型参数
`static boolean`	`hasEmpty(Object... objs)` 是否存在`null`或空对象，通过`isEmpty(Object)` 判断元素
`static boolean`	`hasNull(Object... objs)` 是否存在`null`对象，通过`isNull(Object)` 判断元素
`static boolean`	`isAllEmpty(Object... objs)` 是否全都为`null`或空对象，通过`isEmpty(Object)` 判断元素
`static boolean`	`isAllNotEmpty(Object... objs)` 是否全都不为`null`或空对象，通过`isEmpty(Object)` 判断元素
`static boolean`	`isBasicType(Object object)` 是否为基本类型，包括包装类型和非包装类型
`static boolean`	`isEmpty(Object obj)` 判断指定对象是否为空，支持： 1.
`static boolean`	`isNotEmpty(Object obj)` 判断指定对象是否为非空，支持： 1.
`static boolean`	`isNotNull(Object obj)` 检查对象是否不为null
`static boolean`	`isNull(Object obj)` 检查对象是否为null 判断标准为： 1. == null 2. equals(null)
`static boolean`	`isValidIfNumber(Object obj)` 检查是否为有效的数字检查Double和Float是否为无限大，或者Not a Number 非数字类型和Null将返回true
`static int`	`length(Object obj)` 计算对象长度，如果是字符串调用其length函数，集合类调用其size函数，数组调用其length属性，其他可遍历对象遍历计算长度支持的类型包括： CharSequence Map Iterator Enumeration Array
`static boolean`	`notEqual(Object obj1, Object obj2)` 比较两个对象是否不相等。
`static <T> byte[]`	`serialize(T obj)` 序列化对象必须实现Serializable接口
`static String`	`toString(Object obj)` 将Object转为String 策略为： 1、null转为"null" 2、调用Convert.toStr(Object)转换

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - ObjectUtil
```
public ObjectUtil()
```
- 方法详细资料
  - equals
```
public static boolean equals(Object obj1,
                             Object obj2)
```
    比较两个对象是否相等，此方法是 equal(Object, Object)的别名方法。
    相同的条件有两个，满足其一即可：
    1. obj1 == null && obj2 == null
    2. obj1.equals(obj2)
    3. 如果是BigDecimal比较，0 == obj1.compareTo(obj2)
    参数:
    
    obj1 - 对象1
    
    obj2 - 对象2
    
    返回:
    
    是否相等
    
    从以下版本开始:
    
    5.4.3
    
    另请参阅:
    
    equal(Object, Object)
  - equal
```
public static boolean equal(Object obj1,
                            Object obj2)
```
    比较两个对象是否相等。
    相同的条件有两个，满足其一即可：
    1. obj1 == null && obj2 == null
    2. obj1.equals(obj2)
    3. 如果是BigDecimal比较，0 == obj1.compareTo(obj2)
    参数:
    
    obj1 - 对象1
    
    obj2 - 对象2
    
    返回:
    
    是否相等
    
    另请参阅:
    
    Objects.equals(Object, Object)
  - notEqual
```
public static boolean notEqual(Object obj1,
                               Object obj2)
```
    比较两个对象是否不相等。
    
    参数:
    
    obj1 - 对象1
    
    obj2 - 对象2
    
    返回:
    
    是否不等
    
    从以下版本开始:
    
    3.0.7
  - length
```
public static int length(Object obj)
```
    计算对象长度，如果是字符串调用其length函数，集合类调用其size函数，数组调用其length属性，其他可遍历对象遍历计算长度
    支持的类型包括：
    - CharSequence
    - Map
    - Iterator
    - Enumeration
    - Array
    参数:
    
    obj - 被计算长度的对象
    
    返回:
    
    长度
  - contains
```
public static boolean contains(Object obj,
                               Object element)
```
    对象中是否包含元素
    支持的对象类型包括：
    - String
    - Collection
    - Map
    - Iterator
    - Enumeration
    - Array
    参数:
    
    obj - 对象
    
    element - 元素
    
    返回:
    
    是否包含
  - isNull
```
public static boolean isNull(Object obj)
```
    检查对象是否为null
    判断标准为：
```
 1. == null
 2. equals(null)
 
```
    参数:
    
    obj - 对象
    
    返回:
    
    是否为null
  - isNotNull
```
public static boolean isNotNull(Object obj)
```
    检查对象是否不为null
    
    参数:
    
    obj - 对象
    
    返回:
    
    是否为null
  - isEmpty
```
public static boolean isEmpty(Object obj)
```
    判断指定对象是否为空，支持：
```
 1. CharSequence
 2. Map
 3. Iterable
 4. Iterator
 5. Array
 
```
    参数:
    
    obj - 被判断的对象
    
    返回:
    
    是否为空，如果类型不支持，返回false
    
    从以下版本开始:
    
    4.5.7
  - isNotEmpty
```
public static boolean isNotEmpty(Object obj)
```
    判断指定对象是否为非空，支持：
```
 1. CharSequence
 2. Map
 3. Iterable
 4. Iterator
 5. Array
 
```
    参数:
    
    obj - 被判断的对象
    
    返回:
    
    是否为空，如果类型不支持，返回true
    
    从以下版本开始:
    
    4.5.7
  - defaultIfNull
```
public static <T> T defaultIfNull(T object,
                                  T defaultValue)
```
    如果给定对象为null返回默认值
```
 ObjectUtil.defaultIfNull(null, null)      = null
 ObjectUtil.defaultIfNull(null, "")        = ""
 ObjectUtil.defaultIfNull(null, "zz")      = "zz"
 ObjectUtil.defaultIfNull("abc", *)        = "abc"
 ObjectUtil.defaultIfNull(Boolean.TRUE, *) = Boolean.TRUE
 
```
    类型参数:
    
    T - 对象类型
    
    参数:
    
    object - 被检查对象，可能为null
    
    defaultValue - 被检查对象为null返回的默认值，可以为null
    
    返回:
    
    被检查对象为null返回默认值，否则返回原值
    
    从以下版本开始:
    
    3.0.7
  - defaultIfNull
```
public static <T> T defaultIfNull(Object source,
                                  Supplier<? extends T> handle,
                                  T defaultValue)
```
    如果给定对象为null 返回默认值, 如果不为null 返回自定义handle处理后的返回值
    
    类型参数:
    
    T - 被检查对象为null返回默认值，否则返回自定义handle处理后的返回值
    
    参数:
    
    source - Object 类型对象
    
    handle - 自定义的处理方法
    
    defaultValue - 默认为空的返回值
    
    返回:
    
    处理后的返回值
    
    从以下版本开始:
    
    5.4.6
  - defaultIfEmpty
```
public static <T> T defaultIfEmpty(String str,
                                   Supplier<? extends T> handle,
                                   T defaultValue)
```
    如果给定对象为null或者""返回默认值, 否则返回自定义handle处理后的返回值
    
    类型参数:
    
    T - 被检查对象为null或者 ""返回默认值，否则返回自定义handle处理后的返回值
    
    参数:
    
    str - String 类型
    
    handle - 自定义的处理方法
    
    defaultValue - 默认为空的返回值
    
    返回:
    
    处理后的返回值
    
    从以下版本开始:
    
    5.4.6
  - defaultIfEmpty
```
public static <T extends CharSequence> T defaultIfEmpty(T str,
                                                        T defaultValue)
```
    如果给定对象为null或者 "" 返回默认值
```
 ObjectUtil.defaultIfEmpty(null, null)      = null
 ObjectUtil.defaultIfEmpty(null, "")        = ""
 ObjectUtil.defaultIfEmpty("", "zz")      = "zz"
 ObjectUtil.defaultIfEmpty(" ", "zz")      = " "
 ObjectUtil.defaultIfEmpty("abc", *)        = "abc"
 
```
    类型参数:
    
    T - 对象类型（必须实现CharSequence接口）
    
    参数:
    
    str - 被检查对象，可能为null
    
    defaultValue - 被检查对象为null或者 ""返回的默认值，可以为null或者 ""
    
    返回:
    
    被检查对象为null或者 ""返回默认值，否则返回原值
    
    从以下版本开始:
    
    5.0.4
  - defaultIfBlank
```
public static <T extends CharSequence> T defaultIfBlank(T str,
                                                        T defaultValue)
```
    如果给定对象为null或者""或者空白符返回默认值
```
 ObjectUtil.defaultIfBlank(null, null)      = null
 ObjectUtil.defaultIfBlank(null, "")        = ""
 ObjectUtil.defaultIfBlank("", "zz")      = "zz"
 ObjectUtil.defaultIfBlank(" ", "zz")      = "zz"
 ObjectUtil.defaultIfBlank("abc", *)        = "abc"
 
```
    类型参数:
    
    T - 对象类型（必须实现CharSequence接口）
    
    参数:
    
    str - 被检查对象，可能为null
    
    defaultValue - 被检查对象为null或者 ""或者空白符返回的默认值，可以为null或者 ""或者空白符
    
    返回:
    
    被检查对象为null或者 ""或者空白符返回默认值，否则返回原值
    
    从以下版本开始:
    
    5.0.4
  - clone
```
public static <T> T clone(T obj)
```
    克隆对象
    如果对象实现Cloneable接口，调用其clone方法
    如果实现Serializable接口，执行深度克隆
    否则返回null
    
    类型参数:
    
    T - 对象类型
    
    参数:
    
    obj - 被克隆对象
    
    返回:
    
    克隆后的对象
  - cloneIfPossible
```
public static <T> T cloneIfPossible(T obj)
```
    返回克隆后的对象，如果克隆失败，返回原对象
    
    类型参数:
    
    T - 对象类型
    
    参数:
    
    obj - 对象
    
    返回:
    
    克隆后或原对象
  - cloneByStream
```
public static <T> T cloneByStream(T obj)
```
    序列化后拷贝流的方式克隆
    对象必须实现Serializable接口
    
    类型参数:
    
    T - 对象类型
    
    参数:
    
    obj - 被克隆对象
    
    返回:
    
    克隆后的对象
    
    抛出:
    
    UtilException - IO异常和ClassNotFoundException封装
  - serialize
```
public static <T> byte[] serialize(T obj)
```
    序列化
    对象必须实现Serializable接口
    
    类型参数:
    
    T - 对象类型
    
    参数:
    
    obj - 要被序列化的对象
    
    返回:
    
    序列化后的字节码
  - deserialize
```
public static <T> T deserialize(byte[] bytes)
```
    反序列化
    对象必须实现Serializable接口
    注意！！！此方法不会检查反序列化安全，可能存在反序列化漏洞风险！！！
    
    类型参数:
    
    T - 对象类型
    
    参数:
    
    bytes - 反序列化的字节码
    
    返回:
    
    反序列化后的对象
  - isBasicType
```
public static boolean isBasicType(Object object)
```
    是否为基本类型，包括包装类型和非包装类型
    
    参数:
    
    object - 被检查对象
    
    返回:
    
    是否为基本类型
    
    另请参阅:
    
    ClassUtil.isBasicType(Class)
  - isValidIfNumber
```
public static boolean isValidIfNumber(Object obj)
```
    检查是否为有效的数字
    检查Double和Float是否为无限大，或者Not a Number
    非数字类型和Null将返回true
    
    参数:
    
    obj - 被检查类型
    
    返回:
    
    检查结果，非数字类型和Null将返回true
  - compare
```
public static <T extends Comparable<? super T>> int compare(T c1,
                                                            T c2)
```
    null安全的对象比较，null对象排在末尾
    
    类型参数:
    
    T - 被比较对象类型
    
    参数:
    
    c1 - 对象1，可以为null
    
    c2 - 对象2，可以为null
    
    返回:
    
    比较结果，如果c1 < c2，返回数小于0，c1==c2返回0，c1 > c2 大于0
    
    从以下版本开始:
    
    3.0.7
    
    另请参阅:
    
    Comparator.compare(Object, Object)
  - compare
```
public static <T extends Comparable<? super T>> int compare(T c1,
                                                            T c2,
                                                            boolean nullGreater)
```
    null安全的对象比较
    
    类型参数:
    
    T - 被比较对象类型
    
    参数:
    
    c1 - 对象1，可以为null
    
    c2 - 对象2，可以为null
    
    nullGreater - 当被比较对象为null时是否排在前面
    
    返回:
    
    比较结果，如果c1 < c2，返回数小于0，c1==c2返回0，c1 > c2 大于0
    
    从以下版本开始:
    
    3.0.7
    
    另请参阅:
    
    Comparator.compare(Object, Object)
  - getTypeArgument
```
public static Class<?> getTypeArgument(Object obj)
```
    获得给定类的第一个泛型参数
    
    参数:
    
    obj - 被检查的对象
    
    返回:
    
    Class
    
    从以下版本开始:
    
    3.0.8
  - getTypeArgument
```
public static Class<?> getTypeArgument(Object obj,
                                       int index)
```
    获得给定类的第一个泛型参数
    
    参数:
    
    obj - 被检查的对象
    
    index - 泛型类型的索引号，即第几个泛型类型
    
    返回:
    
    Class
    
    从以下版本开始:
    
    3.0.8
  - toString
```
public static String toString(Object obj)
```
    将Object转为String
    策略为：
```
  1、null转为"null"
  2、调用Convert.toStr(Object)转换
 
```
    参数:
    
    obj - Bean对象
    
    返回:
    
    Bean所有字段转为Map后的字符串
    
    从以下版本开始:
    
    3.2.0
  - emptyCount
```
public static int emptyCount(Object... objs)
```
    存在多少个null或空对象，通过isEmpty(Object) 判断元素
    
    参数:
    
    objs - 被检查的对象,一个或者多个
    
    返回:
    
    存在null的数量
  - hasNull
```
public static boolean hasNull(Object... objs)
```
    是否存在null对象，通过isNull(Object) 判断元素
    
    参数:
    
    objs - 被检查对象
    
    返回:
    
    是否存在
    
    从以下版本开始:
    
    5.5.3
    
    另请参阅:
    
    ArrayUtil.hasNull(Object[])
  - hasEmpty
```
public static boolean hasEmpty(Object... objs)
```
    是否存在null或空对象，通过isEmpty(Object) 判断元素
    
    参数:
    
    objs - 被检查对象
    
    返回:
    
    是否存在
    
    另请参阅:
    
    ArrayUtil.hasEmpty(Object...)
  - isAllEmpty
```
public static boolean isAllEmpty(Object... objs)
```
    是否全都为null或空对象，通过isEmpty(Object) 判断元素
    
    参数:
    
    objs - 被检查的对象,一个或者多个
    
    返回:
    
    是否都为空
  - isAllNotEmpty
```
public static boolean isAllNotEmpty(Object... objs)
```
    是否全都不为null或空对象，通过isEmpty(Object) 判断元素
    
    参数:
    
    objs - 被检查的对象,一个或者多个
    
    返回:
    
    是否都不为空

类 ObjectUtil

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

ObjectUtil

方法详细资料

equals

equal

notEqual

length

contains

isNull

isNotNull

isEmpty

isNotEmpty

defaultIfNull

defaultIfNull

defaultIfEmpty

defaultIfEmpty

defaultIfBlank

clone

cloneIfPossible

cloneByStream

serialize

deserialize

isBasicType

isValidIfNumber

compare

compare

getTypeArgument

getTypeArgument

toString

emptyCount

hasNull

hasEmpty

isAllEmpty

isAllNotEmpty