JDK源码之Object类详解(一)

package java.lang;

/**
 * Object类是类层次结构中的根,每个类的父类都是Object类。
 * 所有对象,包括数组,都实现了这个类的方法。
 */
public class Object {

    /**
     * registerNatives函数前面有native关键字修饰,
     * Java中,用native关键字修饰的函数表明该方法的实现并不是在Java中去完成,
     * 而是由C/C++去完成,并被编译成了.dll,由Java去调用
     * 一个本地方法,具体是用C(C++)在DLL中实现的,然后通过JNI调用
     */
    private static native void registerNatives();

    /**
     * registerNatives()修饰符为private,且并没有执行,
     * registerNatives()方法是在静态代码块中执行的
     */
    static {
        registerNatives();
    }

    /**
     * 返回运行时的类名
     */
    public final native Class<?> getClass();

    /**
     * 1.在java应用程序执行期间,在对同一对象多次调用hashCode()方法时,
     * 必须一致地返回相同的整数,前提是将对象进行equals比较时所用的信息没有被修改。
     * 从某一应用程序的一次执行到同一应用程序的另一次执行,该整数无需保持一致。
     * 2.如果根据equals(object)方法,两个对象是相等的,
     * 那么对这两个对象中的每个对象调用hashCode方法都必须生成相同的整数结果。
     * 3.如果根据equals(java.lang.Object)方法,
     * 两个对象不相等,那么对这两个对象中的任一对象上调用hashCode()方法不要求一定生成不同的整数结果。
     * 但是,程序员应该意识到,为不相等的对象生成不同整数结果可以提高哈希表的性能。
     * hashCode()用于获取对象的哈希值,这个值的作用是检索,具体的作用可以参考这里
     */
    public native int hashCode();

    /**
     * equale()用于确认两个对象是否相同。
     * 哈希值相同的对象不一定equale()为true
     * equale()返回true的两个对象一定相同。
     * 这里比较的是对象的内存地址,
     * 跟String.equals方法不同,它比较的只是对象的值
     */
    public boolean equals(Object obj) {
        return (this == obj);
    }

    /**
     * 本地clone方法,用于对象的复制
     * clone函数返回的是一个引用,指向的是新的clone出来的对象,
     * 此对象与原对象分别占用不同的堆空间。
     */

    protected native Object clone() throws CloneNotSupportedException;

    /**
     * 返回该对象的字符串表示,非常重要的方法
     * getClass().getName();获取字节码文件的对应全路径名例如java.lang.Object
     * Integer.toHexString(hashCode());将哈希值转成16进制数格式的字符串。
     */

    public String toString() {
        return getClass().getName() + "@" + Integer.toHexString(hashCode());
    }

    /**
     * 在使用的时候要求在synchronize语句中使用
     * 唤醒在该对象的监视器上等待的单个线程
     */
    public final native void notify();

    /**
     * 在使用的时候要求在synchronize语句中使用
     * 唤醒在该对象的监视器上等待的所有线程
     */
    public final native void notifyAll();

    /**
     * 在使用的时候要求在synchronize语句中使用
     * 在其他线程调用此对象的notify()方法或notifyAll()方法前,导致当前线程等待。
     * 换句话说,此方法的行为就好像它仅执行wait(0)调用一样。
     * 当前线程必须拥有此对象监视器。该线程发布对此监视器的所有权并等待,
     * 直到其他线程通过调用notify方法或notifyAll方法通知在此对象的监视器上等待的线程醒来,
     * 然后该线程将等到重新获得对监视器的所有权后才能继续执行。
     */
    public final native void wait(long timeout) throws InterruptedException;

    /**
     * 在使用的时候要求在synchronize语句中使用
     * 让当前线程等待直到另一个线程调用了此对象的notify()或notifyAll()方法,
     * 或者其他某个线程中断了当前线程,或者过去了一定的时间
     * nanos不能大于等于1000000ms也就是1000s
     */
    public final void wait(long timeout, int nanos) throws InterruptedException {
        if (timeout < 0) {
            throw new IllegalArgumentException("timeout value is negative");
        }

        if (nanos < 0 || nanos > 999999) {
            throw new IllegalArgumentException(
                    "nanosecond timeout value out of range");
        }

        if (nanos > 0) {
            timeout++;
        }

        wait(timeout);
    }

    /**
     * 在使用的时候要求在synchronize语句中使用
     * 在其他线程调用此对象的notify()方法或notifyAll()方法前,导致当前线程等待。
     * 换句话说,此方法的行为就好像它仅执行wait(0)调用一样。
     * 当前线程必须拥有此对象监视器。该线程发布对此监视器的所有权并等待,
     * 直到其他线程通过调用notify方法或notifyAll方法通知在此对象的监视器上等待的线程醒来,
     * 然后该线程将等到重新获得对监视器的所有权后才能继续执行。
     */
    public final void wait() throws InterruptedException {
        wait(0);
    }

    /**
     * 当垃圾回收器确定该对象没有被引用时,调用此方法
     */
    protected void finalize() throws Throwable { }
}