Java中Objects工具类

Java中Objects，Arrays工具类

1. Objects

This class consists of static utility methods for operating on objects. These utilities include null-safe or null-tolerant methods for computing the hash code of an object, returning a string for an object, and comparing two objects.

翻译过来是：Objects类提供了null值安全和null值容忍的静态方法用来计算对象的哈希值，对象的字符串表示和比较两个对象。

1.1 对象比较

用于对象比较的方法有：

//equals方法用来比较两个对象是否相等；
public static boolean equals(Object a, Object b) {
    return (a == b) || (a != null && a.equals(b));
}
// deepEquals方法用来比较两个对象是否相等，但是对数组对象进行了特殊处理。
public static boolean deepEquals(Object a, Object b) {
    if (a == b)
        return true;
    else if (a == null || b == null)
        return false;
    else
        return Arrays.deepEquals0(a, b);
}

equals方法和deepEquals方法的唯一区别是deepEquals方法针对数组对象进行了特殊处理。编写如下测试方法：

public static void equalsReview() {
    int[] a = new int[10];
    int[] b = new int[10];
    System.out.println(Objects.equals(a, b));
    System.out.println(Objects.deepEquals(a, b));
}

equals方法和deepEquals方法的输出是不一样的，equals方法输出false，而deepEquals方法输出true。

1.2 计算哈希值

// 计算单个对象的哈希值
public static int hashCode(Object o) {
    return o != null ? o.hashCode() : 0;
}
// 计算多个对象的哈希值
public static int hash(Object... values) {
    return Arrays.hashCode(values);
}

可以看到hashCode方法是null值容忍的,对于null返回的哈希值是0。hash方法提供了对多个对象计算哈希的方法，该方法通过调用Arrays工具类的hashCode方法计算数组哈希值来实现。

1.3 对象的字符串输出

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

第一个toString方法直接调用了String.valueOf方法得到对象的字符串表示。第二个toString方法提供了对null的默认字符串输出。

1.4 对null值的判断

//  判断传入的对象是为null，如果是抛出NullPointerException
public static <T> T requireNonNull(T obj) {
    if (obj == null)
        throw new NullPointerException();
    return obj;
}
// 判断传入的对象是否为null，如果为null则抛出NullPointerException，而且异常信息为传入的字符串
public static <T> T requireNonNull(T obj, String message) {
    if (obj == null)
        throw new NullPointerException(message);
    return obj;
}
// 判断传入的对象是否微null
public static boolean isNull(Object obj) {
    return obj == null;
}
// 判断传入的对象是否不是null
public static boolean nonNull(Object obj) {
    return obj != null;
}
// 判断传入的对象是否为null，如果是返回默认的对象，如果默认对象也为null则抛出NullPointerException
public static <T> T requireNonNullElse(T obj, T defaultObj) {
    return (obj != null) ? obj : requireNonNull(defaultObj, "defaultObj");
}
// 判断传入的参数是否为null，如果是则通过Supplier对象获取默认值，如果Supplier也为null则抛出NullPointerException。
public static <T> T requireNonNullElseGet(T obj, Supplier<? extends T> supplier) {
    return (obj != null) ? obj
            : requireNonNull(requireNonNull(supplier, "supplier").get(), "supplier.get()");
}
// 判断传入的参数是否为null，如果是则抛出异常，异常信息通过messageSupplier对象获取。
public static <T> T requireNonNull(T obj, Supplier<String> messageSupplier) {
    if (obj == null)
        throw new NullPointerException(messageSupplier == null ?
                                        null : messageSupplier.get());
    return obj;
}

1.5 检查下标是否越界

// 检查下标是否越界
@ForceInline
public static int checkIndex(int index, int length) {
    return Preconditions.checkIndex(index, length, null);
}
// 检查输入的范围下标是否越界：[fromIndex, toIndex)
public static int checkFromToIndex(int fromIndex, int toIndex, int length) {
    return Preconditions.checkFromToIndex(fromIndex, toIndex, length, null);
}
// 检查从fromIndex开始size长度是否越界（不包含fromIndex + size）
public static int checkFromIndexSize(int fromIndex, int size, int length) {
    return Preconditions.checkFromIndexSize(fromIndex, size, length, null);
}