JDK源码解析之 Java.lang.Enum

2022-12-01 20:12:33 浏览数 (1)

Enum是一个特殊的类. 我们不能以class Xxx extends Enum的方式手动继承, 必须写成enum Xxx的形式; 然而这段枚举类的定义在编译之后又变回了class Xxx extends Enum.

一、类定义

代码语言:javascript复制
public abstract class Enum<E extends Enum<E>>
        implements Comparable<E>, Serializable {}
  • Enum是一个虚基类,
  • 继承了Number抽象类,可以用于数字类型的一系列转换;
  • 实现了Comparable接口,强行对实现它的每个类的对象进行整体排序

二、成员常量和取值器

代码语言:javascript复制
//成员常量name,被声明为final类型,意为不可变,同时只提供取值器。
private final String name; 
public final String name() {
    return name;
}
//成员常量ordinal,被声明为final类型,意为不可变,同时只提供取值器。
private final int ordinal;
public final int ordinal() {
    return ordinal;
}

三、构造函数

代码语言:javascript复制
    protected Enum(String name, int ordinal) {
        this.name = name;
        this.ordinal = ordinal;
    }

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

四、常用方法

1、toString()

返回成员常量name的值。

代码语言:javascript复制
    public String toString() {
        return name;
    }
2、equals()

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

代码语言:javascript复制
    public final boolean equals(Object other) {
        return this==other;
    }
3、hashCode()

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

代码语言:javascript复制
    public final int hashCode() {
        return super.hashCode();
    }
4、clone()

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

代码语言:javascript复制
    protected final Object clone() throws CloneNotSupportedException {
        throw new CloneNotSupportedException();
    }
5、compareTo()

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

代码语言:javascript复制
    public final int compareTo(E o) {
        Enum<?> other = (Enum<?>)o;
        Enum<E> self = this;
        if (self.getClass() != other.getClass() && // optimization
            self.getDeclaringClass() != other.getDeclaringClass())
            throw new ClassCastException();
        return self.ordinal - other.ordinal;
    }
6、getDeclaringClass()

这个方法在compareTo()方法中出现了。

代码语言:javascript复制
    @SuppressWarnings("unchecked")
    public final Class<E> getDeclaringClass() {
        Class<?> clazz = getClass();
        Class<?> zuper = clazz.getSuperclass();
        return (zuper == Enum.class) ? (Class<E>)clazz : (Class<E>)zuper;
    }
7、valueOf()

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

代码语言:javascript复制
public static <T extends Enum<T>> T valueOf(Class<T> enumType,
                                                String name) {
        T result = enumType.enumConstantDirectory().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);
    }
8、readObject()

防治反序列化的,使用private来定义方法,且在方法内部抛出异常。目的就是为了维护枚举值的唯一性。

代码语言:javascript复制
private void readObject(ObjectInputStream in) throws IOException,
        ClassNotFoundException {
				 throw new InvalidObjectException("can't deserialize enum");
   }
9、readObjectNoData()

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

代码语言:javascript复制
    private void readObjectNoData() throws ObjectStreamException {
        throw new InvalidObjectException("can't deserialize enum");
    }

0 人点赞