java源码阅读之java.util.Objects

之所以写这篇文章,是因为工作中接触到一个开源项目代码,而这个开源代码使用到了这个类。同时如果不是前面的包名java.util,都很容易看错成java超类java.lang.Object。

java.util.Objects是java1.7新增的一个类。下面这篇文章将基于1.7.0_80版本的类库源码展开。

一、类定义:

package java.util;

/**
 * @since 1.7
 */
public final class Objects {

我去掉了类上面的注释,只保留了一个注解标签,用来记住这个类是自1.7开始出现的。另外需要注意的是这个类用关键字final修饰了,意味着它不能被继承

二、构造函数:

    private Objects() {
        throw new AssertionError("No java.util.Objects instances for you!");
    }

只有这么一个构造函数,并且声明为private,构造函数中抛出一个AssertionError。这两点结合起来看,意味着:这个类不可以实例化。(这里我们不考虑反射打破这一规则的问题)

综合三点,(1)java.util包下面的类;(2)不可以被继承;(3)不能实例化。

可以推测,这个类八九不离十,是个工具类

三、公开的方法:

(1)判断两个对象是否相等

public static boolean equals(Object a, Object b) {
        return (a == b) || (a != null && a.equals(b));
    }

参数a和b都是Object类型,意味着这个方法很灵活,能够接收所有的对象引用。

方法内部也很有意思,用到了短路或,先判断链两个引用是否指向同一对象。如果不是,再调用a参数的equals方法,等于将

是否相等的任务委托给引用a所指向的对象去执行了。同时很细心地,先判断a是不是null。否则很容易引起NPE问题。

(2)判断两个对象是否相等。

  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);
    }

不同于(1)中的函数,这个函数,直接指明了,如果参数a或者b其中有1个为null,而另一个不为null,那么就返回false。

等到else判断的时候,已经可以确定的是a和b都不是null了。同时也将判断委托给Arrays类的deepEquals0方法了。有兴趣的读者可以去看一下这个方法的具体实现。

(3)获取对象hashCode值方法:

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

方法很简单,判断引用o所指对象是否为null,不为null,则返回o所指对象的hasCode方法执行结果,为null,返回0。

(4)还是获取hash值的方法,并且还是一个变长参数的方法。

    public static int hash(Object... values) {
        return Arrays.hashCode(values);
    }

真正执行方法的是Arrays类的方法:【public static int hashCode(Object a[])】

在这里也这个方法的具体实现:

    public static int hashCode(Object a[]) {
        if (a == null)
            return 0;

        int result = 1;

        for (Object element : a)
            result = 31 * result + (element == null ? 0 : element.hashCode());

        return result;
    }

细心地读者可能会发现,变长参数values怎么可以传给一个数组类型的方法参数呢?这里,读者可以参考我的另一篇文章,我专门讲解了变长参数这个语法糖的背后真实实现。

(5)将一个Object引用所指的对象,转换成一个字符串。

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

这个方法,仍然是委托给String类去执行,调用String的valueOf方法。

其实String的valueOf这个方法也很有意思,有兴趣的读者也可以自行去了解。

(6)将一个Object引用所指的对象,转换成一个字符串。

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

不同与(5)中方法的是,提供了一个默认值,而且这个默认值是由调用者所指定的。

(7)对两个引用所指对象的比较,使用到了泛型

    public static  int compare(T a, T b, Comparator c) {
        return (a == b) ? 0 :  c.compare(a, b);
    }

其实这也是个委托实现的方法,重要的第三个参数,是如何实现的compare方法。

(8)  null检查

  public static  T requireNonNull(T obj) {
        if (obj == null)
            throw new NullPointerException();
        return obj;
    }

这个是最受我追捧,也是我使用最多的一个方法,它可以提前的探知你的参数是否为null,从而早暴露出NPE问题,并能够帮助你精确定位。有点类似与guava的Optional类检查null一样。

(9)null检查,但是提供用户指定的异常信息。

    public static  T requireNonNull(T obj, String message) {
        if (obj == null)
            throw new NullPointerException(message);
        return obj;
    }

三、JDK1.8新增的方法:

新增了三个方法,都是小方法,但也很实用。下面三个方法都是取自JDK1.8.0_151中源码。

(1)null判断,判断一个Object引用是不是指向null。

     /**
     * @see java.util.function.Predicate
     * @since 1.8
     */
    public static boolean isNull(Object obj) {
        return obj == null;
    }

(2)非null判断,判断一个Object引用是否不是指向null。

     /**
     * @see java.util.function.Predicate
     * @since 1.8
     */
    public static boolean nonNull(Object obj) {
        return obj != null;
    }

(3)null检查

     /**
     * @since 1.8
     */
    public static  T requireNonNull(T obj, Supplier messageSupplier) {
        if (obj == null)
            throw new NullPointerException(messageSupplier.get());
        return obj;
    }

可以看出,这三个方法,都是为了适应java1.8引入的lambda表达式和函数式编程服务的。

【总结】:这个是一个轻量级的工具类,拥有很多很实用的小方法。值得推荐。

 

你可能感兴趣的:(java,源码)