ObjUtil (hutool 6.0.0-M20 API)

java.lang.Object
- org.dromara.hutool.core.util.ObjUtil

```
public class ObjUtil
extends Object
```
对象工具类，包括判空、克隆、序列化等操作
原数组相关操作见：ArrayUtil.hasBlank(CharSequence...)、ArrayUtil.isAllBlank(CharSequence...)等等

Author:

Looly

Constructor Summary

Constructors
Constructor and Description

ObjUtil()

Constructors
Constructor and Description
`ObjUtil()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static <T> void`	`accept(T source, Consumer<T> consumer)` 如果指定的对象不为 `null`,则执行`Consumer`处理source，否则不进行操作
`static <T,R> R`	`apply(T source, Function<T,R> handler)` 如果指定的对象不为 `null`,则应用提供的映射函数并返回结果,否则返回 `null`。
`static <T> T`	`clone(T obj)` 克隆对象如果对象是数组，则等同于`ArrayUtil.clone(Object)`；如果对象实现了`Cloneable`接口，调用 `Object.clone()`方法；如果对象实现了`Serializable`接口，执行深度克隆；不符合上述任意情况则返回`null`；
`static <T> T`	`cloneByStream(T obj)` 序列化后拷贝流的方式克隆若对象未实现`Serializable`接口，则返回`null`
`static <T> T`	`cloneIfPossible(T obj)` 返回克隆后的对象，如果克隆失败，返回原对象
`static boolean`	`contains(Object obj, Object element)` 检查`obj`中是否包含`element`，若`obj`为`null`，则直接返回`false`。
`static <T,R> R`	`defaultIfNull(T object, Function<? super T,? extends R> handler, R defaultValue)` 如果给定对象不为`null` 返回自定义handler处理后的结果，否则返回默认值
`static <T,R> R`	`defaultIfNull(T object, Function<? super T,? extends R> handler, Supplier<? extends R> defaultSupplier)` 如果给定对象不为`null` 返回自定义handler处理后的结果，否则返回 `Supplier.get()` 提供的默认值
`static <T> T`	`defaultIfNull(T object, Supplier<? extends T> defaultSupplier)` 如果给定对象不为`null` 返回原值, 否则返回 `Supplier.get()` 提供的默认值
`static <T> T`	`defaultIfNull(T object, T defaultValue)` 如果给定对象为`null`返回默认值 `ObjUtil.defaultIfNull(null, null); // = null ObjUtil.defaultIfNull(null, ""); // = "" ObjUtil.defaultIfNull(null, "zz"); // = "zz" ObjUtil.defaultIfNull("abc", ); // = "abc" ObjUtil.defaultIfNull(Boolean.TRUE, ); // = Boolean.TRUE`
`static boolean`	`equals(Object obj1, Object obj2)` 比较两个对象是否相等，满足下述任意条件即返回`true`：若两对象皆为`BigDecimal`，且满足`0 == obj1.compareTo(obj2)` 若两对象都为数组，调用Arrays.equals完成判断 `obj1 == null && obj2 == null` `obj1.equals(obj2)`
`static Class<?>`	`getTypeArgument(Object obj)` 获得给定类的第一个泛型参数
`static Class<?>`	`getTypeArgument(Object obj, int index)` 获得给定类指定下标的泛型参数
`static boolean`	`isBasicType(Object object)` 是否为基本类型，包括包装类型和原始类型
`static boolean`	`isEmpty(Object obj)` 判断指定对象是否为空，支持类型包括： `null`：默认返回`true`；数组：等同于`ArrayUtil.isEmpty(Object)`； `CharSequence`：等同于`StrValidator.isEmpty(CharSequence)`； `Collection`：等同于`CollUtil.isEmpty(Collection)`； `Map`：等同于`MapUtil.isEmpty(Map)`； `Iterator`或`Iterable`：等同于`IterUtil.isEmpty(Iterator)`、 `IterUtil.isEmpty(Iterable)`；
`static boolean`	`isNotEmpty(Object obj)` 判断指定对象是否为非空
`static boolean`	`isNotNull(Object obj)` 检查对象是否不为`null`
`static boolean`	`isNull(Object obj)` 检查对象是否为`null`
`static boolean`	`isValidIfNumber(Object obj)` 是否为有效的数字，主要用于检查浮点数是否为有意义的数值若对象不为`Number`类型，则直接返回`true`，否则：若对象类型为`Double`，则检查`Double.isInfinite()`或`Double.isNaN()`；若对象类型为`Float`，则检查`Float.isInfinite()`或`Float.isNaN()`；
`static int`	`length(Object obj)` 计算对象长度，支持类型包括： `null`：默认返回`0`；数组：返回数组长度； `CharSequence`：返回`CharSequence.length()`； `Collection`：返回`Collection.size()`； `Iterator`或`Iterable`：可迭代的元素数量； `Enumeration`：返回可迭代的元素数量；
`static boolean`	`notEquals(Object obj1, Object obj2)` 比较两个对象是否不相等

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - ObjUtil
```
public ObjUtil()
```
- Method Detail
  - equals
```
public static boolean equals(Object obj1,
                             Object obj2)
```
    比较两个对象是否相等，满足下述任意条件即返回true：
    - 若两对象皆为BigDecimal，且满足0 == obj1.compareTo(obj2)
    - 若两对象都为数组，调用Arrays.equals完成判断
    - obj1 == null && obj2 == null
    - obj1.equals(obj2)
    Parameters:
    
    obj1 - 对象1
    
    obj2 - 对象2
    
    Returns:
    
    是否相等
    
    Since:
    
    5.4.3
  - notEquals
```
public static boolean notEquals(Object obj1,
                                Object obj2)
```
    比较两个对象是否不相等
    
    Parameters:
    
    obj1 - 对象1
    
    obj2 - 对象2
    
    Returns:
    
    是否不等
    
    Since:
    
    3.0.7
    
    See Also:
    
    equals(Object, Object)
  - length
```
public static int length(Object obj)
```
    计算对象长度，支持类型包括：
    - null：默认返回0；
    - 数组：返回数组长度；
    - CharSequence：返回CharSequence.length()；
    - Collection：返回Collection.size()；
    - Iterator或Iterable：可迭代的元素数量；
    - Enumeration：返回可迭代的元素数量；
    Parameters:
    
    obj - 被计算长度的对象
    
    Returns:
    
    长度
  - contains
```
public static boolean contains(Object obj,
                               Object element)
```
    检查obj中是否包含element，若obj为null，则直接返回false。
    支持类型包括：
    - null：默认返回false；
    - String：等同String.contains(CharSequence)；
    - Collection：等同Collection.contains(Object)；
    - Map：等同Map.containsValue(Object)；
    - Iterator、Iterable、Enumeration或数组：等同于遍历后对其元素调用equals(Object, Object)方法；
    Parameters:
    
    obj - 对象
    
    element - 元素
    
    Returns:
    
    是否包含
  - 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：默认返回true；
    - 数组：等同于ArrayUtil.isEmpty(Object)；
    - CharSequence：等同于StrValidator.isEmpty(CharSequence)；
    - Collection：等同于CollUtil.isEmpty(Collection)；
    - Map：等同于MapUtil.isEmpty(Map)；
    - Iterator或Iterable：等同于IterUtil.isEmpty(Iterator)、 IterUtil.isEmpty(Iterable)；
    Parameters:
    
    obj - 被判断的对象
    
    Returns:
    
    是否为空，如果类型不支持，返回false
    
    Since:
    
    4.5.7
    
    See Also:
    
    StrValidator.isEmpty(CharSequence), MapUtil.isEmpty(Map), IterUtil.isEmpty(Iterable), IterUtil.isEmpty(Iterator), ArrayUtil.isEmpty(Object)
  - isNotEmpty
```
public static boolean isNotEmpty(Object obj)
```
    判断指定对象是否为非空
    
    Parameters:
    
    obj - 被判断的对象
    
    Returns:
    
    是否不为空，如果类型不支持，返回true
    
    Since:
    
    4.5.7
    
    See Also:
    
    isEmpty(Object)
  - defaultIfNull
```
public static <T> T defaultIfNull(T object,
                                  T defaultValue)
```
    如果给定对象为null返回默认值
```
 ObjUtil.defaultIfNull(null, null);      // = null
 ObjUtil.defaultIfNull(null, "");        // = ""
 ObjUtil.defaultIfNull(null, "zz");      // = "zz"
 ObjUtil.defaultIfNull("abc", *);        // = "abc"
 ObjUtil.defaultIfNull(Boolean.TRUE, *); // = Boolean.TRUE
 
```
    Type Parameters:
    
    T - 对象类型
    
    Parameters:
    
    object - 被检查对象，可能为null
    
    defaultValue - 被检查对象为null返回的默认值，可以为null
    
    Returns:
    
    被检查对象不为 null 返回原值，否则返回默认值
    
    Since:
    
    3.0.7
  - defaultIfNull
```
public static <T> T defaultIfNull(T object,
                                  Supplier<? extends T> defaultSupplier)
```
    如果给定对象不为null 返回原值, 否则返回 Supplier.get() 提供的默认值
    
    Type Parameters:
    
    T - 被检查对象类型
    
    Parameters:
    
    object - 被检查对象，可能为null
    
    defaultSupplier - 为空时的默认值提供者
    
    Returns:
    
    被检查对象不为 null 返回原值，否则返回 Supplier.get() 提供的默认值
    
    Since:
    
    5.4.6
  - defaultIfNull
```
public static <T,R> R defaultIfNull(T object,
                                    Function<? super T,? extends R> handler,
                                    R defaultValue)
```
    如果给定对象不为null 返回自定义handler处理后的结果，否则返回默认值
    
    Type Parameters:
    
    R - 返回值类型
    
    T - 被检查对象类型
    
    Parameters:
    
    object - 被检查对象，可能为null
    
    handler - 非空时自定义的处理方法
    
    defaultValue - 为空时的默认返回值
    
    Returns:
    
    被检查对象不为 null 返回处理后的结果，否则返回默认值
    
    Since:
    
    6.0.0
  - defaultIfNull
```
public static <T,R> R defaultIfNull(T object,
                                    Function<? super T,? extends R> handler,
                                    Supplier<? extends R> defaultSupplier)
```
    如果给定对象不为null 返回自定义handler处理后的结果，否则返回 Supplier.get() 提供的默认值
    
    Type Parameters:
    
    R - 返回值类型
    
    T - 被检查对象类型
    
    Parameters:
    
    object - 被检查对象，可能为null
    
    handler - 非空时自定义的处理方法
    
    defaultSupplier - 为空时的默认值提供者
    
    Returns:
    
    被检查对象不为 null 返回处理后的结果，否则返回 Supplier.get() 提供的默认值
    
    Since:
    
    6.0.0
  - apply
```
public static <T,R> R apply(T source,
                            Function<T,R> handler)
```
    如果指定的对象不为 null,则应用提供的映射函数并返回结果,否则返回 null。
    
    Type Parameters:
    
    T - 输入对象的类型
    
    R - 映射函数的返回类型
    
    Parameters:
    
    source - 要检查的对象
    
    handler - 要应用的映射函数
    
    Returns:
    
    映射函数的结果, 如果输入对象为 null,则返回 null
  - accept
```
public static <T> void accept(T source,
                              Consumer<T> consumer)
```
    如果指定的对象不为 null,则执行Consumer处理source，否则不进行操作
    
    Type Parameters:
    
    T - 输入对象的类型
    
    Parameters:
    
    source - 要检查的对象
    
    consumer - source处理逻辑
  - clone
```
public static <T> T clone(T obj)
```
    克隆对象
    1. 如果对象是数组，则等同于ArrayUtil.clone(Object)；
    2. 如果对象实现了Cloneable接口，调用 Object.clone()方法；
    3. 如果对象实现了Serializable接口，执行深度克隆；
    4. 不符合上述任意情况则返回null；
    Type Parameters:
    
    T - 对象类型
    
    Parameters:
    
    obj - 被克隆对象
    
    Returns:
    
    克隆后的对象
    
    See Also:
    
    ArrayUtil.clone(Object), Object.clone(), cloneByStream(Object)
  - cloneIfPossible
```
public static <T> T cloneIfPossible(T obj)
```
    返回克隆后的对象，如果克隆失败，返回原对象
    
    Type Parameters:
    
    T - 对象类型
    
    Parameters:
    
    obj - 对象
    
    Returns:
    
    克隆对象或原对象
    
    See Also:
    
    clone(Object)
  - cloneByStream
```
public static <T> T cloneByStream(T obj)
```
    序列化后拷贝流的方式克隆
    若对象未实现Serializable接口，则返回null
    
    Type Parameters:
    
    T - 对象类型
    
    Parameters:
    
    obj - 被克隆对象
    
    Returns:
    
    克隆后的对象
    
    Throws:
    
    HutoolException - IO异常和ClassNotFoundException封装
    
    See Also:
    
    SerializeUtil.clone(Object)
  - isBasicType
```
public static boolean isBasicType(Object object)
```
    是否为基本类型，包括包装类型和原始类型
    
    Parameters:
    
    object - 被检查对象，null返回false
    
    Returns:
    
    是否为基本类型
    
    See Also:
    
    ClassUtil.isBasicType(Class)
  - isValidIfNumber
```
public static boolean isValidIfNumber(Object obj)
```
    是否为有效的数字，主要用于检查浮点数是否为有意义的数值
    若对象不为Number类型，则直接返回true，否则：
    - 若对象类型为Double，则检查Double.isInfinite()或Double.isNaN()；
    - 若对象类型为Float，则检查Float.isInfinite()或Float.isNaN()；
    Parameters:
    
    obj - 被检查对象
    
    Returns:
    
    检查结果，非数字类型和null将返回true
    
    See Also:
    
    NumberUtil.isValidNumber(Number)
  - getTypeArgument
```
public static Class<?> getTypeArgument(Object obj)
```
    获得给定类的第一个泛型参数
    
    Parameters:
    
    obj - 被检查的实体对象
    
    Returns:
    
    Class
    
    Since:
    
    3.0.8
  - getTypeArgument
```
public static Class<?> getTypeArgument(Object obj,
                                       int index)
```
    获得给定类指定下标的泛型参数
    
    Parameters:
    
    obj - 被检查的实体对象
    
    index - 泛型类型的索引号，即第几个泛型类型
    
    Returns:
    
    Class
    
    Since:
    
    3.0.8
    
    See Also:
    
    ClassUtil.getTypeArgument(Class, int)

Class ObjUtil

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ObjUtil

Method Detail

equals

notEquals

length

contains

isNull

isNotNull

isEmpty

isNotEmpty

defaultIfNull

defaultIfNull

defaultIfNull

defaultIfNull

apply

accept

clone

cloneIfPossible

cloneByStream

isBasicType

isValidIfNumber

getTypeArgument

getTypeArgument