Java-API简析_java.util.Objects类（基于 Latest JDK）（浅析源码）

【版权声明】未经博主同意，谢绝转载！（请尊重原创，博主保留追究权）
https://blog.csdn.net/m0_69908381/article/details/133463511
出自【进步*于辰的博客】

1、概述

继承关系：

• java.lang.Object
  • java.util.Objects

---

public final class Objects extends Object

此类包含static实用程序方法，用于操作对象或在操作前检查某些条件。 这些实用程序包括null或null方法，用于计算对象的哈希代码，返回对象的字符串，比较两个对象，以及检查索引或子范围值是否超出范围。

API Note:
静态方法如checkIndex(int, int) ， checkFromToIndex(int, int, int) 和checkFromIndexSize(int, int, int)提供用于如果对应于索引和子范围的值超出边界的检查的便利性。 这些静态方法的变体支持定义运行时异常以及相应的异常详细消息，这些消息在值超出范围时抛出。 此类方法接受功能接口参数，即BiFunction实例，它将超出范围的值映射到运行时异常。 将这些方法与作为 lambda 表达式，方法引用或捕获值的类的参数结合使用时应小心。 在这种情况下，与功能接口分配相关的捕获成本可能超过检查边界的成本。

从以下版本开始：
1.7

2、方法摘要

2.1 static int checkFromIndexSize​(int fromIndex, int size, int length)

检查是否在子范围从 fromIndex （包括）到 fromIndex + size （不包括）是范围界限内 0 （包括）到 length （不包括）。

2.2 static int checkFromToIndex​(int fromIndex, int toIndex, int length)

检查是否在子范围从 fromIndex （包括）到 toIndex （不包括）是范围界限内 0 （包括）到 length （不包括）。

2.3 static int checkIndex​(int index, int length)

检查 index是否在 0 （含）到 length （不包括）范围内。

2.4 static int compare​(T a, T b, Comparator c)

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

public static <T> int compare(T a, T b, Comparator<? super T> c) {
    return (a == b) ? 0 :  c.compare(a, b);
}
1
2
3

2.5 static boolean deepEquals​(Object a, Object b)

如果参数是深层相等，返回 true。

public static boolean deepEquals(Object a, Object b) {
    if (a == b)
        return true;
    else if (a == null || b == null)// a != b
        return false;
    else
        return Arrays.deepEquals0(a, b);
}
1
2
3
4
5
6
7
8

关于deepEquals0()，见Arrays类的第3.6项。

2.6 static boolean equals​(Object a, Object b)

如果参数相等，返回 true。

2.7 static int hash​(Object… values)

为一系列输入值生成哈希码。

2.8 static int hashCode​(Object o)

返回“非”的哈希码，0为 null的论点。

public static int hashCode(Object o) {
    return o != null ? o.hashCode() : 0;
}
1
2
3

2.9 static boolean isNull​(Object obj)

如果提供的参考是 null ，返回 true。

2.10 static boolean nonNull​(Object obj)

如果提供的参考是非 null，返回 true。

2.11 static T requireNonNull​(T obj)

检查指定的对象引用是否不是 null 。

public static <T> T requireNonNull(T obj, Supplier<String> messageSupplier) {
    if (obj == null)
        throw new NullPointerException(messageSupplier.get());
    return obj;
}
1
2
3
4
5

2.12 static T requireNonNull​(T obj, String message)

检查指定的对象引用是否为null ，如果是，则抛出自定义的 NullPointerException 。

2.13 static T requireNonNull​(T obj, Supplier messageSupplier)

检查指定的对象引用是否为null ，如果是，则抛出自定义的 NullPointerException 。

2.14 static T requireNonNullElse​(T obj, T defaultObj)

如果它是非 null ，则返回第一个参数，否则返回第二个参数（非null值）。

2.15 static T requireNonNullElseGet​(T obj, Supplier supplier)

如果它是非 null ，则返回第一个参数，否则返回 supplier.get()（非null值） 。

2.16 static String toString​(Object o)

返回调用的结果 toString()。对于非null参数， "null"为null的说法。

public static String toString(Object o) {
    return String.valueOf(o);
}
1
2
3

关于valueOf()，见String类的第2.64项。

2.17 static String toString​(Object o, String nullDefault)

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

public static String toString(Object o, String nullDefault) {
    return (o != null) ? o.toString() : nullDefault;
}
1
2
3

关于toString()，见Object类的第3.8项。

最后

如果大家需要Java-API文档，我上传了《Java-API文档-包含5/8/11三个版本》。

---

本文暂缓更新。