compact1, compact2, compact3

java.util

Class Objects

java.lang.Object

java.util.Objects

public final class Objects
extends Object

这类由 static实用方法为操作对象。这些工具包括 null-safe或 null-tolerant方法计算一个对象的哈希码，返回一个对象的字符串，比较两个对象。

从以下版本开始：

一点七

方法摘要

Modifier and Type	Method and Description
static <T> int	compare(T a, T b, Comparator<? super T> c) 返回0，如果参数是相同的， c.compare(a, b)否则。
static boolean	deepEquals(Object a, Object b) 返回 true如果参数深入彼此相等，否则 false。
static boolean	equals(Object a, Object b) 返回 true如果参数相等，否则 false。
static int	hash(Object... values) 生成一个输入值序列的哈希代码。
static int	hashCode(Object o) 返回一个非哈希代码一个 null null参数和0参数。
static boolean	isNull(Object obj) 返回 true如果提供的参考 null否则返回 false。
static boolean	nonNull(Object obj) 返回 true如果提供的参考是非 null否则返回 false。
static <T> T	requireNonNull(T obj) 检查指定的对象的引用是不 null。
static <T> T	requireNonNull(T obj, String message) 检查指定的对象的引用是不 null抛 NullPointerException如果是定制的。
static <T> T	requireNonNull(T obj, Supplier<String> messageSupplier) 检查指定的对象的引用是不 null抛 NullPointerException如果是定制的。
static String	toString(Object o) 返回调用 toString为非结果一 null论证论点和 "null" null。
static String	toString(Object o, String nullDefault) 返回在第一个参数调用 toString结果如果第一个参数不 null返回第二个参数，否则。

Methods inherited from class java.lang.Object

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

方法详细信息

equals

public static boolean equals(Object a,
                             Object b)

返回 true如果参数相等，否则 false。因此，如果参数都是 null， true返回如果一个确切的说法是 null， false返回。否则，平等是通过使用第一个参数的 equals法测定。

参数

a -对象

b对象与 a平等相比

结果

true如果参数相等，否则 false

另请参见：

Object.equals(Object)

deepEquals

public static boolean deepEquals(Object a,
                                 Object b)

返回 true如果参数是彼此平等 false否则。两 null价值深深的平等。如果参数是数组，在 Arrays.deepEquals算法是用来确定平等。否则，平等是通过使用第一个参数的 equals法测定。

参数

a -对象

b对象是平等 a比较深

结果

true如果参数深入彼此相等，否则 false

另请参见：

Arrays.deepEquals(Object[], Object[])， equals(Object, Object)

hashCode

public static int hashCode(Object o)

返回一个非哈希代码一个 null null参数和0参数。

参数

o -对象

结果

一个非哈希代码一个 null null参数和0参数

另请参见：

Object.hashCode()

hash

public static int hash(Object... values)

生成一个输入值序列的哈希代码。散列码的产生是如果所有的输入值被放置到一个数组，数组进行散列，通过调用 Arrays.hashCode(Object[])。

此方法用于实现包含多个字段的对象Object.hashCode()。例如，如果一个对象有三个领域，x，y，和z，一个能写：

 @Override public int hashCode() {
     return Objects.hash(x, y, z);
 }
 

警告：当提供一个单一对象引用时，返回的值不等于该对象引用的哈希代码。这个值可以通过调用 hashCode(Object)计算。

参数

values -被散列值

结果

输入值序列的哈希值

另请参见：

Arrays.hashCode(Object[])， List.hashCode()

toString

public static String toString(Object o)

返回调用 toString为非结果一 null论证论点和 "null" null。

参数

o -对象

结果

打电话 toString为非结果一 null论证论点和 "null" null

另请参见：

Object.toString()， String.valueOf(Object)

toString

public static String toString(Object o,
                              String nullDefault)

返回在第一个参数调用 toString结果如果第一个参数不 null返回第二个参数，否则。

参数

o -对象

nullDefault -字符串，如果第一个参数是 null返回

结果

在第一个参数调用 toString结果如果不是 null和二否则。

另请参见：

toString(Object)

compare

public static <T> int compare(T a,
                              T b,
                              Comparator<? super T> c)

返回0，如果参数是相同的， c.compare(a, b)否则。因此，如果参数都是 null返回0。

注意，如果一个参数是null，一NullPointerException可能或不可能被取决于订货政策，如果有选择的Comparator有null值。

参数类型

T -是该对象的类型比较

参数

a -对象

b对象比较 a

c - Comparator比较前两个参数

结果

0如果参数是相同的， c.compare(a, b)否则。

另请参见：

Comparable， Comparator

requireNonNull

public static <T> T requireNonNull(T obj)

检查指定的对象的引用是不 null。这种方法的主要目的是为在方法和构造函数做参数验证，如下图所示：

 public Foo(Bar bar) {
     this.bar = Objects.requireNonNull(bar);
 }
 

参数类型

T -参考类型

参数

obj -对象引用来检查无效

结果

如果不 null obj

异常

如果是 null obj NullPointerException

requireNonNull

public static <T> T requireNonNull(T obj,
                                   String message)

检查指定的对象的引用是不 null抛 NullPointerException如果是定制的。这种方法的主要目的是为在多个参数的方法和构造函数做参数验证，如下图所示：

 public Foo(Bar bar, Baz baz) {
     this.bar = Objects.requireNonNull(bar, "bar must not be null");
     this.baz = Objects.requireNonNull(baz, "baz must not be null");
 }
 

参数类型

T -参考类型

参数

obj -对象引用来检查无效

message -详细信息可在事件， NullPointerException抛出

结果

如果不 null obj

异常

如果是 null obj NullPointerException

isNull

public static boolean isNull(Object obj)

返回 true如果提供的参考 null否则返回 false。

API Note:

这个方法的存在作为一 Predicate， filter(Objects::isNull)

参数

obj -参考进行核对， null

结果

true如果提供的参考 null否则 false

从以下版本开始：

一点八

另请参见：

Predicate

nonNull

public static boolean nonNull(Object obj)

返回 true如果提供的参考是非 null否则返回 false。

API Note:

这个方法的存在作为一 Predicate， filter(Objects::nonNull)

参数

obj -参考进行核对， null

结果

true如果提供的参考是非 null否则 false

从以下版本开始：

一点八

另请参见：

Predicate

requireNonNull

public static <T> T requireNonNull(T obj,
                                   Supplier<String> messageSupplier)

检查指定的对象的引用是不 null抛 NullPointerException如果是定制的。

不同的方法requireNonNull(Object, String)，这种方法允许消息被推迟到null检查了创作。虽然这可能会赋予在非空的情况下的性能优势，当决定调用这个方法的护理应考虑创建消息供应商的成本是小于直接创建字符串消息的成本。

参数类型

T -参考类型

参数

obj -对象引用来检查无效

messageSupplier -的详细信息可以在事件， NullPointerException被供应商

结果

如果不 null obj

异常

如果是 null obj NullPointerException

从以下版本开始：

一点八