java源码阅读之java.lang.Enum

之所以要研究这个类,因为它是java中所有枚举的父类,本文基于JDK1.9.0的java源码进行展开。

一、类定义:

public abstract class Enum>
        implements Comparable, Serializable {

可以看到Enum是一个虚基类,并且实现了Comparable接口和序列化接口。Enum类的泛型,必须是继承自Enum的子类。

二、成员常量和取值器:

1、成员常量name,被声明为final类型,意为不可变,同时只提供取值器。

    private final String name;

    public final String name() {
        return name;
    }

2、成员常量ordinal,被声明为final类型,意为不可变,同时只提供取值器。

    private final int ordinal;

    public final int ordinal() {
        return ordinal;
    }

三、构造函数:

构造函数被定义成protected,参数有两个,分别是name和ordinal,和成员常量相呼应。

    protected Enum(String name, int ordinal) {
        this.name = name;
        this.ordinal = ordinal;
    }

四、公开的方法:

1、toString() 方法,返回成员常量name的值。

    public String toString() {
        return name;
    }

2、equals()方法,参数为Object类型,方法内部判断是不是和this指向同一对象。注意这个方法final被修饰,也就是说枚举不可以覆写这个类。

    public final boolean equals(Object other) {
        return this==other;
    }

3、hashCode()方法,委托父类执行,即Object类的hashCode方法执行。注意这个方法final被修饰,也就是说枚举不可以覆写这个类。

    public final int hashCode() {
        return super.hashCode();
    }

4、clone()方法,直接抛出异常,不支持拷贝。这也符合枚举唯一的特性。值得注意的是,这个方法被定义成protected,也就是只能包内和子类可见,并且不可以覆写。

    protected final Object clone() throws CloneNotSupportedException {
        throw new CloneNotSupportedException();
    }

5、compareTo()方法,有这个方法,一方面是因为Enum类实现了Comparable接口,一方面也符合枚举可以比较的特点。值得注意的是,方法内部可以看出,要求比较的对象必须是相同枚举类型的,否则便会引起ClassCastException异常。对相同类型枚举值,比较的则是它们的成员常量ordinal大小。

    public final int compareTo(E o) {
        Enum other = (Enum)o;
        Enum self = this;
        if (self.getClass() != other.getClass() && // optimization
            self.getDeclaringClass() != other.getDeclaringClass())
            throw new ClassCastException();
        return self.ordinal - other.ordinal;
    }

6、getDeclaringClass()方法,这个方法在compareTo()方法中出现了。

    @SuppressWarnings("unchecked")
    public final Class getDeclaringClass() {
        Class clazz = getClass();
        Class zuper = clazz.getSuperclass();
        return (zuper == Enum.class) ? (Class)clazz : (Class)zuper;
    }

7、valueOf方法,通过参数name来返回枚举值,注意,如果name没有与之对应的枚举,返回的不是null,而是抛出异常。

   public static > T valueOf(Class enumType,
                                                String name) {
        T result = enumType.
		().get(name);
        if (result != null)
            return result;
        if (name == null)
            throw new NullPointerException("Name is null");
        throw new IllegalArgumentException(
            "No enum constant " + enumType.getCanonicalName() + "." + name);
    }

五、受保护和私有方法:

(1)finallize()方法,这个没什么好说的,臭名昭著以至于被启用。

    @SuppressWarnings("deprecation")
    protected final void finalize() { }

(2)readObject方法。注释信息很重要,就是防治反序列化的,使用private来定义方法,且在方法内部抛出异常。目的就是为了维护枚举值的唯一性。

    /**
     * prevent default deserializatio
     */
    private void readObject(ObjectInputStream in) throws IOException,
        ClassNotFoundException {
        throw new InvalidObjectException("can't deserialize enum");
    }

(3)readObjectNoData()方法,同readObject方法一样,都是为了防止反序列化的。

    private void readObjectNoData() throws ObjectStreamException {
        throw new InvalidObjectException("can't deserialize enum");
    }

六、遗留问题:

getDeclaringClass()方法内部的实现,是什么原理?

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