org.tinygroup.commons.tools

Class ObjectUtil

java.lang.Object

org.tinygroup.commons.tools.ObjectUtil

public class ObjectUtil
extends Object

有关Object处理的工具类。

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

Author:

renhui

Constructor Summary

Constructors

Constructor and Description
ObjectUtil()

Method Summary

Modifier and Type	Method and Description
static <A extends Appendable> A	appendIdentityToString(A buffer, Object object) 将对象自身的identity——如同对象没有覆盖toString()方法时， Object.toString()的原始输出——追加到Appendable中。
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	isEmptyObject(Object object) 是否为null、空字符串、或空数组。
static boolean	isEquals(Object object1, Object object2) 比较两个对象是否完全相等。
static boolean	isSameType(Object object1, Object object2) 检查两个对象是否属于相同类型。null将被看作任意类型。
static String	toString(Object object) 取得对象的toString()的值，如果对象为null，则返回空字符串 ""。
static String	toString(Object object, String nullStr) 取得对象的toString()的值，如果对象为null，则返回指定字符串。

Methods inherited from class java.lang.Object

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

Constructor Detail

ObjectUtil

public ObjectUtil()

Method Detail

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
 

Parameters:

object1 - 对象1

object2 - 对象2

Returns:

如果相等, 则返回true

isSameType

public static boolean isSameType(Object object1,
                                 Object object2)

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

Parameters:

object1 - 对象1

object2 - 对象2

Returns:

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

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
 

Parameters:

object - 要测试的对象

defaultValue - 默认值

Returns:

对象本身或默认对象

isEmptyObject

public static boolean isEmptyObject(Object object)

是否为null、空字符串、或空数组。

hashCode

public static int hashCode(Object object)

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

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

Parameters:

object - 对象

Returns:

hash值

identityHashCode

public static int identityHashCode(Object object)

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

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

Parameters:

object - 对象

Returns:

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"
 

Parameters:

object - 对象

Returns:

对象的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"
 

Parameters:

object - 对象

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

Returns:

对象的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")
 

Parameters:

buffer - Appendable对象

object - 对象

Returns:

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]"
 

Parameters:

object - 对象

Returns:

对象的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]"
 

Parameters:

object - 对象

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

Returns:

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