java.lang.Object
|---java.util.Objects
public final class Objects
extends Object
此类包含用于对对象进行操作的静态实用程序方法。 这些实用程序包括用于计算对象的哈希码、返回对象的字符串以及比较两个对象的空值安全或空值容忍方法。
| 修饰符和类型 | 方法 | 描述 |
|---|---|---|
| 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) | 返回非空参数的哈希码，空参数返回 0。 |
| static boolean | isNull(Object obj) | 如果提供的引用为 null，则返回 true，否则返回 false。 |
| static boolean | nonNull(Object obj) | 如果提供的引用为非 null，则返回 true，否则返回 false。 |
| static <T> T | requireNonNull(T obj) | 检查指定的对象引用不为空。 |
| static <T> T | requireNonNull(T obj, String message) | 检查指定的对象引用是否不为空，如果是则抛出自定义的 NullPointerException。 |
| static <T> T | requireNonNull(T obj, SupplierString messageSupplier) | 检查指定的对象引用是否不为空，如果是则抛出自定义的 NullPointerException。 |
| static String | toString(Object o) | 返回为非 null 参数调用 toString 和为 null 参数调用“null”的结果。 |
| static String | toString(Object o, String nullDefault) | 如果第一个参数不为 null，则返回对第一个参数调用 toString 的结果，否则返回第二个参数。 |
| 从类 java.lang.Object 继承的方法 |
|---|
| clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
public static boolean equals(Object a, Object b)
如果参数彼此相等，则返回 true，否则返回 false。 因此，如果两个参数都为 null，则返回 true，如果恰好一个参数为 null，则返回 false。 否则，相等性通过使用第一个参数的 Object#equals 方法来确定。
参数：
| 参数名称 | 参数描述 |
|---|---|
| a | 一个对象 |
| b | 一个要与 a 比较的对象以求相等 |
返回:
如果参数彼此相等，则为 true，否则为 false
public static boolean deepEquals(Object a, Object b)
如果参数彼此高度相等，则返回 true，否则返回 false。 两个空值非常相等。 如果两个参数都是数组，则使用 Arrays#deepEquals(Object[], Object[]) 中的算法来确定相等性。 否则，相等性通过使用第一个参数的 Object#equals 方法来确定。
参数：
| 参数名称 | 参数描述 |
|---|---|
| a | 一个对象 |
| b | 一个要与 a 进行比较的对象以实现深度相等 |
返回:
如果参数彼此高度相等，则为 true，否则为 false
public static int hashCode(Object o)
返回非空参数的哈希码，空参数返回 0。
参数：
| 参数名称 | 参数描述 |
|---|---|
| o | 一个对象 |
返回:
非空参数的哈希码和空参数的 0
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(java.lang.Object) 来计算。
参数：
| 参数名称 | 参数描述 |
|---|---|
| values | 要散列的值 |
返回:
输入值序列的哈希值
public static String toString(Object o)
返回为非 null 参数调用 toString 和为 null 参数调用“null”的结果。
参数：
| 参数名称 | 参数描述 |
|---|---|
| o | 一个对象 |
返回:
为非 null 参数调用 toString 和为 null 参数调用“null”的结果
public static String toString(Object o, String nullDefault)
如果第一个参数不为 null，则返回对第一个参数调用 toString 的结果，否则返回第二个参数。
参数：
| 参数名称 | 参数描述 |
|---|---|
| o | 一个对象 |
| nullDefault | 如果第一个参数为空，则返回字符串 |
返回:
如果第一个参数不为空，则对第一个参数调用 toString 的结果，否则为第二个参数。
public static <T> int compare(T a, T b, Comparator<? super T> c)
如果参数相同则返回 0，否则返回 c.compare(a, b)。 因此，如果两个参数都为空，则返回 0。
请注意，如果其中一个参数为空，则可能会或可能不会抛出 NullPointerException，具体取决于比较器为空值选择的排序策略（如果有）。
类型参数：
| 类型参数名称 | 类型参数描述 |
|---|---|
| T | 被比较的对象的类型 |
参数:
| 参数名称 | 参数描述 |
|---|---|
| a | 一个对象 |
| b | 一个要与之比较的对象 |
| c | Comparator 比较前两个参数 |
返回:
如果参数相同，则为 0，否则为 c.compare(a, b)。
public static <T> T requireNonNull(T obj)
检查指定的对象引用不为空。 此方法主要用于在方法和构造函数中进行参数验证，如下所示：
public Foo(Bar bar) {
this.bar = Objects.requireNonNull(bar);
} 类型参数:
| 类型参数名称 | 类型参数描述 |
|---|---|
| T | 参考的类型 |
参数:
| 参数名称 | 参数描述 |
|---|---|
| obj | 检查无效性的对象引用 |
返回:
如果不为空，则为 obj
Throws:
| Throw名称 | Throw描述 |
|---|---|
| NullPointerException | 如果 obj 为空 |
public static <T> T requireNonNull(T obj, String message)
检查指定的对象引用是否不为空，如果是则抛出自定义的 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 时使用的详细消息 |
返回:
如果不为空，则为 obj
Throws:
| Throw名称 | Throw描述 |
|---|---|
| NullPointerException | 如果 obj 为空 |
public static boolean isNull(Object obj)
如果提供的引用为 null，则返回 true，否则返回 false。
参数：
| 参数名称 | 参数描述 |
|---|---|
| obj | 要针对 null 进行检查的引用 |
返回:
如果提供的引用为 null，则为 true，否则为 false
public static boolean nonNull(Object obj)
如果提供的引用为非 null，则返回 true，否则返回 false。
参数：
| 参数名称 | 参数描述 |
|---|---|
| obj | 要针对 null 进行检查的引用 |
返回:
如果提供的引用不为空，则为 true，否则为 false
public static <T> T requireNonNull(T obj, SupplierString messageSupplier)
检查指定的对象引用是否不为空，如果是则抛出自定义的 NullPointerException。
与方法 requireNonNull(java.lang.Object,java.lang.String) 不同，此方法允许将消息的创建推迟到进行空值检查之后。 虽然这可能会在非空情况下带来性能优势，但在决定调用此方法时，应注意创建消息提供者的成本低于直接创建字符串消息的成本。
类型参数：
| 类型参数名称 | 类型参数描述 |
|---|---|
| T | the type of the reference |
参数:
| 参数名称 | 参数描述 |
|---|---|
| obj | 检查无效性的对象引用 |
| messageSupplier | 抛出 NullPointerException 时使用的详细消息的提供者 |
返回:
如果不为空，则为 obj
Throws:
| Throw名称 | Throw描述 |
|---|---|
| NullPointerException | 如果 obj 为空 |
备案信息： 粤ICP备15087711号-2
Copyright © 2008-2024 啊嘎哇在线工具箱 All Rights.
本站所有资料来源于网络，版权归原作者所有，仅作学习交流使用，如不慎侵犯了您的权利，请联系我们。