blade.kit

类 ObjectKit

java.lang.Object

blade.kit.ObjectKit

public abstract class ObjectKit
extends Object

有关Object处理的工具类。

这个类中的每个方法都可以“安全”地处理null，而不会抛出NullPointerException。

从以下版本开始:

1.0

作者:

biezhi

字段概要

字段

限定符和类型	字段和说明
static String	SERIAL_VERSION_UID

构造器概要

构造器

构造器和说明
ObjectKit()

方法概要

限定符和类型	方法和说明
static <A extends Appendable> A	appendIdentityToString(A buffer, Object object) 将对象自身的identity——如同对象没有覆盖toString()方法时， Object.toString()的原始输出——追加到 Appendable中。
static StringBuffer	appendIdentityToString(StringBuffer buffer, Object object) 将对象自身的identity——如同对象没有覆盖toString()方法时， Object.toString()的原始输出——追加到 StringBuffer中。
static StringBuilder	appendIdentityToString(StringBuilder builder, Object object) 将对象自身的identity——如同对象没有覆盖toString()方法时， Object.toString()的原始输出——追加到 StringBuilder中。
static Object	clone(Object array) 复制一个对象。
static <T,S extends T> T	defaultIfNull(T object, S defaultValue) 如果对象为null，则返回指定默认对象，否则返回对象本身。
static int	hashCode(Object object) 取得对象的hash值, 如果对象为null, 则返回0。
static int	identityHashCode(Object object) 取得对象的原始的hash值, 如果对象为null, 则返回0。
static String	identityToString(Object object) 取得对象自身的identity，如同对象没有覆盖toString()方法时， Object.toString()的原始输出。
static String	identityToString(Object object, String nullStr) 取得对象自身的identity，如同对象没有覆盖toString()方法时， Object.toString()的原始输出。
static boolean	isAllNull(Object... objects) 判断对象是否均为null
static boolean	isAnyNull(Object... objects) 判断是否有任一对象为null
static boolean	isEmpty(Object object) 判断对象是否是空
static boolean	isEquals(Object object1, Object object2) 比较两个对象是否完全相等。
static boolean	isNotEmpty(Object object) 判断对象是否不为空
static boolean	isNotNull(Object object) 判断对象是否不为null
static boolean	isNull(Object object) 判断对象是否为null
static boolean	isSameType(Object object1, Object object2) 检查两个对象是否属于相同类型。
static int	nullNum(Object... objects)
static String	toString(Object object) 取得对象的toString()的值，如果对象为null，则返回空字符串 ""。
static String	toString(Object object, String nullStr) 取得对象的toString()的值，如果对象为null，则返回指定字符串。

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

SERIAL_VERSION_UID

public static final String SERIAL_VERSION_UID

另请参阅:

常量字段值

构造器详细资料

ObjectKit

public ObjectKit()

方法详细资料

defaultIfNull

public static <T,S extends T> T defaultIfNull(T object,
                                              S 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
 

参数:

object - 要测试的对象

defaultValue - 默认值

返回:

对象本身或默认对象

isEquals

public static boolean isEquals(Object object1,
                               Object object2)

比较两个对象是否完全相等。

此方法可以正确地比较多维数组。

 ObjectUtil.equals(null, null)                  = true
 ObjectUtil.equals(null, "")                    = false
 ObjectUtil.equals("", null)                    = false
 ObjectUtil.equals("", "")                      = true
 ObjectUtil.equals(Boolean.TRUE, null)          = false
 ObjectUtil.equals(Boolean.TRUE, "true")        = false
 ObjectUtil.equals(Boolean.TRUE, Boolean.TRUE)  = true
 ObjectUtil.equals(Boolean.TRUE, Boolean.FALSE) = false
 

参数:

object1 - 对象1

object2 - 对象2

返回:

如果相等, 则返回true

hashCode

public static int hashCode(Object object)

取得对象的hash值, 如果对象为null, 则返回0。

此方法可以正确地处理多维数组。

参数:

object - 对象

返回:

hash值

identityHashCode

public static int identityHashCode(Object object)

取得对象的原始的hash值, 如果对象为null, 则返回0。

该方法使用System.identityHashCode来取得hash值，该值不受对象本身的 hashCode方法的影响。

参数:

object - 对象

返回:

hash值

identityToString

public static String identityToString(Object object)

取得对象自身的identity，如同对象没有覆盖toString()方法时， Object.toString()的原始输出。

 ObjectUtil.identityToString(null)          = null
 ObjectUtil.identityToString("")            = "java.lang.String@1e23"
 ObjectUtil.identityToString(Boolean.TRUE)  = "java.lang.Boolean@7fa"
 ObjectUtil.identityToString(new int[0])    = "int[]@7fa"
 ObjectUtil.identityToString(new Object[0]) = "java.lang.Object[]@7fa"
 

参数:

object - 对象

返回:

对象的identity，如果对象是null，则返回null

identityToString

public static String identityToString(Object object,
                                      String nullStr)

取得对象自身的identity，如同对象没有覆盖toString()方法时， Object.toString()的原始输出。

 ObjectUtil.identityToString(null, "NULL")            = "NULL"
 ObjectUtil.identityToString("", "NULL")              = "java.lang.String@1e23"
 ObjectUtil.identityToString(Boolean.TRUE, "NULL")    = "java.lang.Boolean@7fa"
 ObjectUtil.identityToString(new int[0], "NULL")      = "int[]@7fa"
 ObjectUtil.identityToString(new Object[0], "NULL")   = "java.lang.Object[]@7fa"
 

参数:

object - 对象

nullStr - 如果对象为null，则返回该字符串

返回:

对象的identity，如果对象是null，则返回指定字符串

appendIdentityToString

public static <A extends Appendable> A appendIdentityToString(A buffer,
                                                              Object object)

将对象自身的identity——如同对象没有覆盖toString()方法时， Object.toString()的原始输出——追加到 Appendable中。

 ObjectUtil.appendIdentityToString(buf, null)          = null
 ObjectUtil.appendIdentityToString(buf, Boolean.TRUE)  = buf.append("java.lang.Boolean@7fa")
 ObjectUtil.appendIdentityToString(buf, new int[0])    = buf.append("int[]@7fa")
 ObjectUtil.appendIdentityToString(buf, new Object[0]) = buf.append("java.lang.Object[]@7fa")
 

参数:

buffer - Appendable对象

object - 对象

返回:

Appendable对象，如果对象为null，则输出 "null"

toString

public static String toString(Object object)

取得对象的toString()的值，如果对象为null，则返回空字符串 ""。

 ObjectUtil.toString(null)         = ""
 ObjectUtil.toString("")           = ""
 ObjectUtil.toString("bat")        = "bat"
 ObjectUtil.toString(Boolean.TRUE) = "true"
 ObjectUtil.toString([1, 2, 3])    = "[1, 2, 3]"
 

参数:

object - 对象

返回:

对象的toString()的返回值，或空字符串""

toString

public static String toString(Object object,
                              String nullStr)

取得对象的toString()的值，如果对象为null，则返回指定字符串。

 ObjectUtil.toString(null, null)           = null
 ObjectUtil.toString(null, "null")         = "null"
 ObjectUtil.toString("", "null")           = ""
 ObjectUtil.toString("bat", "null")        = "bat"
 ObjectUtil.toString(Boolean.TRUE, "null") = "true"
 ObjectUtil.toString([1, 2, 3], "null")    = "[1, 2, 3]"
 

参数:

object - 对象

nullStr - 如果对象为null，则返回该字符串

返回:

对象的toString()的返回值，或指定字符串

isSameType

public static boolean isSameType(Object object1,
                                 Object object2)

检查两个对象是否属于相同类型。null将被看作任意类型。

参数:

object1 - 对象1

object2 - 对象2

返回:

如果两个对象有相同的类型，则返回true

isEmpty

public static boolean isEmpty(Object object)

判断对象是否是空

参数:

object - 传入对象

返回:

如果object.toString()为""、 null 或者空数组, 则返回true

isNotEmpty

public static boolean isNotEmpty(Object object)

判断对象是否不为空

参数:

object - 传入对象

返回:

如果obj.toString()不为""且不为 null, 则返回true

isNull

public static boolean isNull(Object object)

判断对象是否为null

参数:

object - 传入对象

返回:

为null则返还true

isNotNull

public static boolean isNotNull(Object object)

判断对象是否不为null

参数:

object - 传入对象

返回:

不为null则返还true

isAllNull

public static boolean isAllNull(Object... objects)

判断对象是否均为null

参数:

objects - 传入对象集

返回:

均为null则返还true

isAnyNull

public static boolean isAnyNull(Object... objects)

判断是否有任一对象为null

参数:

objects - 传入对象集

返回:

任一对象为null则返还true

nullNum

public static int nullNum(Object... objects)

appendIdentityToString

public static StringBuilder appendIdentityToString(StringBuilder builder,
                                                   Object object)

将对象自身的identity——如同对象没有覆盖toString()方法时， Object.toString()的原始输出——追加到 StringBuilder中。

 ObjectUtil.appendIdentityToString(*, null)            = null
 ObjectUtil.appendIdentityToString(null, "")           = "java.lang.String@1e23"
 ObjectUtil.appendIdentityToString(null, Boolean.TRUE) = "java.lang.Boolean@7fa"
 ObjectUtil.appendIdentityToString(buf, Boolean.TRUE)  = buf.append("java.lang.Boolean@7fa")
 ObjectUtil.appendIdentityToString(buf, new int[0])    = buf.append("int[]@7fa")
 ObjectUtil.appendIdentityToString(buf, new Object[0]) = buf.append("java.lang.Object[]@7fa")
 

参数:

builder - StringBuilder对象，如果是null，则创建新的

object - 对象

返回:

StringBuilder对象，如果对象为null，则返回 null

appendIdentityToString

public static StringBuffer appendIdentityToString(StringBuffer buffer,
                                                  Object object)

将对象自身的identity——如同对象没有覆盖toString()方法时， Object.toString()的原始输出——追加到 StringBuffer中。

 ObjectUtil.appendIdentityToString(*, null)            = null
 ObjectUtil.appendIdentityToString(null, "")           = "java.lang.String@1e23"
 ObjectUtil.appendIdentityToString(null, Boolean.TRUE) = "java.lang.Boolean@7fa"
 ObjectUtil.appendIdentityToString(buf, Boolean.TRUE)  = buf.append("java.lang.Boolean@7fa")
 ObjectUtil.appendIdentityToString(buf, new int[0])    = buf.append("int[]@7fa")
 ObjectUtil.appendIdentityToString(buf, new Object[0]) = buf.append("java.lang.Object[]@7fa")
 

参数:

buffer - StringBuffer对象，如果是null，则创建新的

object - 对象

返回:

StringBuffer对象，如果对象为null，则返回 null

clone

public static Object clone(Object array)
                    throws CloneNotSupportedException

复制一个对象。如果对象为null，则返回null。

此方法调用Object.clone方法，默认只进行“浅复制”。 对于数组，调用 ArrayUtil.clone方法更高效。

参数:

array - 要复制的数组

返回:

数组的复本，如果原始数组为null，则返回null

抛出:

CloneNotSupportedException