ObjectUtils (bus-all 3.6.6 API)

java.lang.Object
- org.aoju.bus.core.utils.ObjectUtils

```
public class ObjectUtils
extends Object
```
一些通用的函数

Since:

JDK 1.8+

Version:

3.6.6

Author:

Kimi Liu

Constructor Summary

Constructors
Constructor and Description

ObjectUtils()

Constructors
Constructor and Description
`ObjectUtils()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static <T> void`	`cleanInitValue(T bean)` 清空对象中所有属性的初始值
`static <T> T`	`clone(T obj)` 克隆对象如果对象实现Cloneable接口,调用其clone方法如果实现Serializable接口,执行深度克隆否则返回null
`static <T> T`	`cloneByStream(T obj)` 序列化后拷贝流的方式克隆对象必须实现Serializable接口
`static <T> T`	`CloneObject(Class<T> clazz, Object bean)` 克隆有序列化的对象
`static <T> T`	`CloneObject(T bean)` 克隆有序列化的对象
`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)` 对象中是否包含元素
`static <T> T`	`defaultIfNull(T object, T defaultValue)` 如果给定对象为`null`返回默认值
`static boolean`	`equal(Object obj1, Object obj2)` 比较两个对象是否相等
`static Field[]`	`getAllFields(Object object)` 获取包括父类所有的属性
`static Object`	`getAttributeValue(Object obj, String attrName)` 从对象中取值
`static Class`	`getClassByName(String classAllName)` 依据class的名称获取对应class
`static <T> T`	`getDiff(T oldBean, T newBean)`
`static Map<String,Class>`	`getFieldNames(Class clazz)` 获取类的所有属性与属性的类型
`static Map<String,Object>`	`getFields(Object bean)` 获取对象中的所有属性
`static <T> Class<T>`	`getGeneric(Class clazz)` 依据类,获取该类的泛型class
`static Map<String,Object>`	`getNotNullFields(Object bean)` 获取对象中的非空属性(属性如果是对象,则只会在同一个map中新增,不会出现map嵌套情况) (不会清空初始值)
`static Map<String,Object>`	`getNotNullFields(Object bean, boolean hasInitValue)` 获取对象中的非空属性(属性如果是对象,则只会在同一个map中新增,不会出现map嵌套情况)
`static Map<String,Object>`	`getNotNullFieldsForStructure(Object bean)` 获取对象中的非空属性(属性如果是对象,则会嵌套map)
`static Map<String,List<String>>`	`getNotNullFieldsParam(Object bean)` 获取对象中的非空属性(属性如果是对象,则只会在同一个map中新增,不会出现map嵌套情况) (不会清空初始值)
`static Map<String,List<String>>`	`getNotNullFieldsParam(Object bean, boolean hasInitValue)` 获取对象中的非空属性(属性如果是对象,则只会在同一个map中新增,不会出现map嵌套情况)
`static void`	`identityToString(Appendable appendable, Object object)` Appends the toString that would be produced by `Object` if a class did not override toString itself.
`static String`	`identityToString(Object object)` Gets the toString that would be produced by `Object` if a class did not override toString itself.
`static void`	`identityToString(StrBuilder builder, Object object)` Appends the toString that would be produced by `Object` if a class did not override toString itself.
`static void`	`identityToString(StringBuffer buffer, Object object)` Appends the toString that would be produced by `Object` if a class did not override toString itself.
`static void`	`identityToString(StringBuilder builder, Object object)` Appends the toString that would be produced by `Object` if a class did not override toString itself.
`static <T> T`	`initObject(Class<T> clazz, Map<String,Object> attrMap)` 初始化对象
`static void`	`insertObj(Object baseData, Object newData)` 将新数据的非空属性值插入到基本数据中
`static boolean`	`isArray(Object object)` 确定给定的对象是一个数组:对象数组还是基元数组
`static boolean`	`isBaseClass(Object value)` 校验是否是九种基础类型(即：非用户定义的类型)
`static boolean`	`isEmpty(Object... object)` 判断对象是否Empty(null或元素为0) 实用于对如下对象做判断:String Collection及其子类 Map及其子类
`static boolean`	`isFalse(Boolean object)` 判断对象为false
`static boolean`	`isNotEmpty(Object... object)` 判断对象是否为NotEmpty(!null或元素大于0) 实用于对如下对象做判断:String Collection及其子类 Map及其子类
`static boolean`	`isNotNull(Object obj)` 检查对象是否不为null
`static boolean`	`isNull(Object obj)` 检查对象是否为null
`static boolean`	`isTrue(Boolean object)` 判断对象为true
`static boolean`	`isValidIfNumber(Object obj)` 检查是否为有效的数字检查Double和Float是否为无限大,或者Not a Number 非数字类型和Null将返回true
`static int`	`length(Object obj)` 计算对象长度,如果是字符串调用其length函数, 集合类调用其size函数, 数组调用其length属性, 其他可遍历对象遍历计算长度
`static boolean`	`notEqual(Object obj1, Object obj2)` 比较两个对象是否不相等
`static boolean`	`nullSafeEquals(Object o1, Object o2)` Determine if the given objects are equal, returning `true` if both are `null` or `false` if only one is `null`.
`static <T> T`	`parseByteForObj(byte[] bts)` 将byte字节转换成对象
`static byte[]`	`parseObjForByte(Object obj)` 将对象转换为byte数据
`static <T> T`	`parseToObject(Object value, Class<T> type)` 转换类型
`static void`	`setAttribute(Object obj, String attrName, Object value)` 给对象的属性赋值
`static String`	`toBase64(Object obj)` 将对象序列化后进行base64处理
`static byte[]`	`toByte(Object obj)` 将对象进行序列化
`static <T> T`	`toObject(byte[] bts)` 将序列化数据转换为对象
`static <T> T`	`toObject(String base64)` 将base64的序列化数据转换为对象
`static Object[]`	`toObjectArray(Object source)` Convert the given array (which may be a primitive array) to an object array (if necessary of primitive wrapper objects).
`static void`	`transMap2Bean(Map<String,Object> map, Object obj)`

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

- Constructor Detail
  - ObjectUtils
```
public ObjectUtils()
```
- Method Detail
  - equal
```
public static boolean equal(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:
    
    是否不等
    
    Since:
    
    3.0.7
  - length
```
public static int length(Object obj)
```
    计算对象长度,如果是字符串调用其length函数, 集合类调用其size函数, 数组调用其length属性, 其他可遍历对象遍历计算长度
    
    Parameters:
    
    obj - 被计算长度的对象
    
    Returns:
    
    长度
  - contains
```
public static boolean contains(Object obj,
                               Object element)
```
    对象中是否包含元素
    
    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
  - defaultIfNull
```
public static <T> T defaultIfNull(T object,
                                  T defaultValue)
```
    如果给定对象为null返回默认值
    
    Type Parameters:
    
    T - 对象类型
    
    Parameters:
    
    object - 被检查对象,可能为null
    
    defaultValue - 被检查对象为null返回的默认值,可以为null
    
    Returns:
    
    被检查对象为{ null}返回默认值,否则返回原值
    
    Since:
    
    3.0.7
  - isTrue
```
public static boolean isTrue(Boolean object)
```
    判断对象为true
    
    Parameters:
    
    object - 对象
    
    Returns:
    
    对象是否为true
  - isFalse
```
public static boolean isFalse(Boolean object)
```
    判断对象为false
    
    Parameters:
    
    object - 对象
    
    Returns:
    
    对象是否为false
  - isArray
```
public static boolean isArray(Object object)
```
    确定给定的对象是一个数组:对象数组还是基元数组
    
    Parameters:
    
    object - 要检查的对象
    
    Returns:
    
    the true/false
  - isValidIfNumber
```
public static boolean isValidIfNumber(Object obj)
```
    检查是否为有效的数字检查Double和Float是否为无限大,或者Not a Number 非数字类型和Null将返回true
    
    Parameters:
    
    obj - 被检查类型
    
    Returns:
    
    检查结果, 非数字类型和Null将返回true
  - clone
```
public static <T> T clone(T obj)
```
    克隆对象如果对象实现Cloneable接口,调用其clone方法如果实现Serializable接口,执行深度克隆否则返回null
    
    Type Parameters:
    
    T - 对象类型
    
    Parameters:
    
    obj - 被克隆对象
    
    Returns:
    
    克隆后的对象
  - cloneByStream
```
public static <T> T cloneByStream(T obj)
```
    序列化后拷贝流的方式克隆对象必须实现Serializable接口
    
    Type Parameters:
    
    T - 对象类型
    
    Parameters:
    
    obj - 被克隆对象
    
    Returns:
    
    克隆后的对象
    
    Throws:
    
    InstrumentException - IO异常和ClassNotFoundException封装
  - compare
```
public static <T extends Comparable<? super T>> int compare(T c1,
                                                            T c2)
```
    null安全的对象比较,null对象排在末尾
    
    Type Parameters:
    
    T - 被比较对象类型
    
    Parameters:
    
    c1 - 对象1,可以为null
    
    c2 - 对象2,可以为null
    
    Returns:
    
    比较结果, 如果c1 < c2,返回数小于0,c1==c2返回0,c1 > c2 大于0
    
    Since:
    
    3.0.7
    
    See Also:
    
    Comparator.compare(Object, Object)
  - compare
```
public static <T extends Comparable<? super T>> int compare(T c1,
                                                            T c2,
                                                            boolean nullGreater)
```
    null安全的对象比较
    
    Type Parameters:
    
    T - 被比较对象类型
    
    Parameters:
    
    c1 - 对象1,可以为null
    
    c2 - 对象2,可以为null
    
    nullGreater - 当被比较对象为null时是否排在前面
    
    Returns:
    
    比较结果, 如果c1 < c2,返回数小于0,c1==c2返回0,c1 > c2 大于0
    
    Since:
    
    3.0.7
    
    See Also:
    
    Comparator.compare(Object, Object)
  - isEmpty
```
public static final boolean isEmpty(Object... object)
```
    判断对象是否Empty(null或元素为0) 实用于对如下对象做判断:String Collection及其子类 Map及其子类
    
    Parameters:
    
    object - 待检查对象
    
    Returns:
    
    boolean 返回的布尔值
  - isNotEmpty
```
public static final boolean isNotEmpty(Object... object)
```
    判断对象是否为NotEmpty(!null或元素大于0) 实用于对如下对象做判断:String Collection及其子类 Map及其子类
    
    Parameters:
    
    object - 待检查对象
    
    Returns:
    
    boolean 返回的布尔值
  - getAllFields
```
public static Field[] getAllFields(Object object)
```
    获取包括父类所有的属性
    
    Parameters:
    
    object - 对象
    
    Returns:
    
    the field
  - transMap2Bean
```
public static void transMap2Bean(Map<String,Object> map,
                                 Object obj)
```
  - getDiff
```
public static <T> T getDiff(T oldBean,
                            T newBean)
```
    Type Parameters:
    
    T - 对象
    
    Parameters:
    
    oldBean - 原对象
    
    newBean - 新对象
    
    Returns:
    
    对象
  - toBase64
```
public static String toBase64(Object obj)
```
    将对象序列化后进行base64处理
    
    Parameters:
    
    obj - 对象
    
    Returns:
    
    base64的序列化对象数据
  - toByte
```
public static byte[] toByte(Object obj)
```
    将对象进行序列化
    
    Parameters:
    
    obj - 对象
    
    Returns:
    
    对象序列化后的数据
  - toObject
```
public static <T> T toObject(String base64)
```
    将base64的序列化数据转换为对象
    
    Type Parameters:
    
    T - 对象
    
    Parameters:
    
    base64 - 经过base64的序列化对象数据
    
    Returns:
    
    原对象
  - toObject
```
public static <T> T toObject(byte[] bts)
```
    将序列化数据转换为对象
    
    Type Parameters:
    
    T - 对象
    
    Parameters:
    
    bts - 序列化后的对象数据
    
    Returns:
    
    原对象
  - getClassByName
```
public static Class getClassByName(String classAllName)
```
    依据class的名称获取对应class
    
    Parameters:
    
    classAllName - 类的全称(如: java.lang.String)
    
    Returns:
    
    返回依据类名映射的class对象
  - initObject
```
public static <T> T initObject(Class<T> clazz,
                               Map<String,Object> attrMap)
```
    初始化对象
    
    Type Parameters:
    
    T - 对象
    
    Parameters:
    
    clazz - 创建的对象的类型
    
    attrMap - 初始对象的属性值
    
    Returns:
    
    创建的对象
  - setAttribute
```
public static void setAttribute(Object obj,
                                String attrName,
                                Object value)
```
    给对象的属性赋值
    
    Parameters:
    
    obj - 对象
    
    attrName - 对象的属性名
    
    value - 对象的属性值
  - getAttributeValue
```
public static Object getAttributeValue(Object obj,
                                       String attrName)
```
    从对象中取值
    
    Parameters:
    
    obj - 对象
    
    attrName - 要取值的属性名
    
    Returns:
    
    值
  - getFields
```
public static Map<String,Object> getFields(Object bean)
```
    获取对象中的所有属性
    
    Parameters:
    
    bean - 对象
    
    Returns:
    
    属性和值(Map[属性名, 属性值])
  - getFieldNames
```
public static Map<String,Class> getFieldNames(Class clazz)
```
    获取类的所有属性与属性的类型
    
    Parameters:
    
    clazz - 类
    
    Returns:
    
    该类的所有属性名与属性类型(包含父类属性)
  - getNotNullFields
```
public static Map<String,Object> getNotNullFields(Object bean,
                                                  boolean hasInitValue)
```
    获取对象中的非空属性(属性如果是对象,则只会在同一个map中新增,不会出现map嵌套情况)
    
    Parameters:
    
    bean - 对象
    
    hasInitValue - 是否过滤掉初始值(true:过滤掉)
    
    Returns:
    
    非空属性和值(Map[属性名, 属性值])
  - getNotNullFields
```
public static Map<String,Object> getNotNullFields(Object bean)
```
    获取对象中的非空属性(属性如果是对象,则只会在同一个map中新增,不会出现map嵌套情况) (不会清空初始值)
    
    Parameters:
    
    bean - 对象
    
    Returns:
    
    非空属性和值(Map[属性名, 属性值])
  - getNotNullFieldsParam
```
public static Map<String,List<String>> getNotNullFieldsParam(Object bean)
```
    获取对象中的非空属性(属性如果是对象,则只会在同一个map中新增,不会出现map嵌套情况) (不会清空初始值)
    request param
    
    Parameters:
    
    bean - 对象
    
    Returns:
    
    非空属性和值(Map[属性名, 属性值])
  - getNotNullFieldsParam
```
public static Map<String,List<String>> getNotNullFieldsParam(Object bean,
                                                             boolean hasInitValue)
```
    获取对象中的非空属性(属性如果是对象,则只会在同一个map中新增,不会出现map嵌套情况)
    
    Parameters:
    
    bean - 对象
    
    hasInitValue - 是否过滤掉初始值(true:过滤掉)
    
    Returns:
    
    非空属性和值(Map[属性名, 属性值])
  - getNotNullFieldsForStructure
```
public static Map<String,Object> getNotNullFieldsForStructure(Object bean)
```
    获取对象中的非空属性(属性如果是对象,则会嵌套map)
    
    Parameters:
    
    bean - 对象
    
    Returns:
    
    非空属性和值(Map[属性名, 属性值])
  - getGeneric
```
public static <T> Class<T> getGeneric(Class clazz)
```
    依据类,获取该类的泛型class
    
    Type Parameters:
    
    T - 对象
    
    Parameters:
    
    clazz - 类对象
    
    Returns:
    
    泛型类型
  - parseByteForObj
```
public static <T> T parseByteForObj(byte[] bts)
```
    将byte字节转换成对象
    
    Type Parameters:
    
    T - 对象
    
    Parameters:
    
    bts - 字节数据
    
    Returns:
    
    对象
  - parseObjForByte
```
public static byte[] parseObjForByte(Object obj)
```
    将对象转换为byte数据
    
    Parameters:
    
    obj - 对象
    
    Returns:
    
    byte数据
  - parseToObject
```
public static <T> T parseToObject(Object value,
                                  Class<T> type)
```
    转换类型
    
    Type Parameters:
    
    T - 对象
    
    Parameters:
    
    value - 字符串的值
    
    type - 要转换的类型
    
    Returns:
    
    转换后的值
  - isBaseClass
```
public static boolean isBaseClass(Object value)
```
    校验是否是九种基础类型(即：非用户定义的类型)
    
    Parameters:
    
    value - 字符串的值要校验的值
    
    Returns:
    
    是否是基础类型(true : 已经是基础类型了)
  - CloneObject
```
public static <T> T CloneObject(Class<T> clazz,
                                Object bean)
```
    克隆有序列化的对象
    
    Type Parameters:
    
    T - 要返回的数据类型
    
    Parameters:
    
    clazz - 反射类
    
    bean - 所有继承过BaseBean的对象
    
    Returns:
    
    克隆后的对象
  - CloneObject
```
public static <T> T CloneObject(T bean)
```
    克隆有序列化的对象
    
    Type Parameters:
    
    T - 要返回的数据类型
    
    Parameters:
    
    bean - 要克隆的对象
    
    Returns:
    
    克隆后的对象
  - insertObj
```
public static void insertObj(Object baseData,
                             Object newData)
```
    将新数据的非空属性值插入到基本数据中
    
    Parameters:
    
    baseData - 基本数据
    
    newData - 新数据
  - cleanInitValue
```
public static <T> void cleanInitValue(T bean)
```
    清空对象中所有属性的初始值
    
    Type Parameters:
    
    T - 对象
    
    Parameters:
    
    bean - 对象
  - identityToString
```
public static String identityToString(Object object)
```
    Gets the toString that would be produced by Object if a class did not override toString itself. null will return null.
```
 ObjectUtils.identityToString(null)         = null
 ObjectUtils.identityToString("")           = "java.lang.String@1e23"
 ObjectUtils.identityToString(Boolean.TRUE) = "java.lang.Boolean@7fa"
 
```
    Parameters:
    
    object - the object to create a toString for, may be null
    
    Returns:
    
    the default toString text, or null if null passed in
  - identityToString
```
public static void identityToString(Appendable appendable,
                                    Object object)
                             throws IOException
```
    Appends the toString that would be produced by Object if a class did not override toString itself. null will throw a NullPointerException for either of the two parameters.
```
 ObjectUtils.identityToString(appendable, "")            = appendable.append("java.lang.String@1e23"
 ObjectUtils.identityToString(appendable, Boolean.TRUE)  = appendable.append("java.lang.Boolean@7fa"
 ObjectUtils.identityToString(appendable, Boolean.TRUE)  = appendable.append("java.lang.Boolean@7fa")
 
```
    Parameters:
    
    appendable - the appendable to append to
    
    object - the object to create a toString for
    
    Throws:
    
    IOException - if an I/O error occurs
    
    Since:
    
    3.2
  - identityToString
```
public static void identityToString(StrBuilder builder,
                                    Object object)
```
    Appends the toString that would be produced by Object if a class did not override toString itself. null will throw a NullPointerException for either of the two parameters.
```
 ObjectUtils.identityToString(builder, "")            = builder.append("java.lang.String@1e23"
 ObjectUtils.identityToString(builder, Boolean.TRUE)  = builder.append("java.lang.Boolean@7fa"
 ObjectUtils.identityToString(builder, Boolean.TRUE)  = builder.append("java.lang.Boolean@7fa")
 
```
    Parameters:
    
    builder - the builder to append to
    
    object - the object to create a toString for
    
    Since:
    
    3.2
  - identityToString
```
public static void identityToString(StringBuffer buffer,
                                    Object object)
```
    Appends the toString that would be produced by Object if a class did not override toString itself. null will throw a NullPointerException for either of the two parameters.
```
 ObjectUtils.identityToString(buf, "")            = buf.append("java.lang.String@1e23"
 ObjectUtils.identityToString(buf, Boolean.TRUE)  = buf.append("java.lang.Boolean@7fa"
 ObjectUtils.identityToString(buf, Boolean.TRUE)  = buf.append("java.lang.Boolean@7fa")
 
```
    Parameters:
    
    buffer - the buffer to append to
    
    object - the object to create a toString for
    
    Since:
    
    2.4.0
  - identityToString
```
public static void identityToString(StringBuilder builder,
                                    Object object)
```
    Appends the toString that would be produced by Object if a class did not override toString itself. null will throw a NullPointerException for either of the two parameters.
```
 ObjectUtils.identityToString(builder, "")            = builder.append("java.lang.String@1e23"
 ObjectUtils.identityToString(builder, Boolean.TRUE)  = builder.append("java.lang.Boolean@7fa"
 ObjectUtils.identityToString(builder, Boolean.TRUE)  = builder.append("java.lang.Boolean@7fa")
 
```
    Parameters:
    
    builder - the builder to append to
    
    object - the object to create a toString for
    
    Since:
    
    3.2
  - nullSafeEquals
```
public static boolean nullSafeEquals(Object o1,
                                     Object o2)
```
    Determine if the given objects are equal, returning true if both are null or false if only one is null.
    Compares arrays with Arrays.equals, performing an equality check based on the array elements rather than the array reference.
    
    Parameters:
    
    o1 - first Object to compare
    
    o2 - second Object to compare
    
    Returns:
    
    whether the given objects are equal
    
    See Also:
    
    Object.equals(Object), Arrays.equals(long[], long[])
  - toObjectArray
```
public static Object[] toObjectArray(Object source)
```
    Convert the given array (which may be a primitive array) to an object array (if necessary of primitive wrapper objects).
    A null source value will be converted to an empty Object array.
    
    Parameters:
    
    source - the (potentially primitive) array
    
    Returns:
    
    the corresponding object array (never null)
    
    Throws:
    
    IllegalArgumentException - if the parameter is not an array

Class ObjectUtils

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ObjectUtils

Method Detail

equal

notEqual

length

contains

isNull

isNotNull

defaultIfNull

isTrue

isFalse

isArray

isValidIfNumber

clone

cloneByStream

compare

compare

isEmpty

isNotEmpty

getAllFields

transMap2Bean

getDiff

toBase64

toByte

toObject

toObject

getClassByName

initObject

setAttribute

getAttributeValue

getFields

getFieldNames

getNotNullFields

getNotNullFields

getNotNullFieldsParam

getNotNullFieldsParam

getNotNullFieldsForStructure

getGeneric

parseByteForObj

parseObjForByte

parseToObject

isBaseClass

CloneObject

CloneObject

insertObj

cleanInitValue

identityToString

identityToString

identityToString

identityToString

identityToString

nullSafeEquals

toObjectArray