Java перечисления - это классы. Они скомпилированы как классы.
Как будет скомпилирован следующий пример? Какова его "классная версия"? Каков точный код класса? Я хочу фактический код Java.
public enum Ordinals {
FIRST("st"),
SECOND("nd"),
THIRD("rd");
private String notation;
private Ordinals(String notation) {
this.notation = notation;
}
public String getNotation() {
return notation;
}
}
Каждый класс enum компилируется как класс, являющийся подклассом java.lang.Enum. Каждая константа enum становится константой static final в этом классе. Затем создается массив $VALUES со всеми константами перечисления в порядке объявления.
Вы можете разобрать код, используя команду javap -p -c Ordinals (в скомпилированном файле .class), чтобы узнать подробности.
Compiled from "Ordinals.java"
public final class Ordinals extends java.lang.Enum<Ordinals> {
public static final Ordinals FIRST;
public static final Ordinals SECOND;
public static final Ordinals THIRD;
private java.lang.String notation; // your custom field
private static final Ordinals[] $VALUES; // all enum constants
public static Ordinals[] values(); // every enum class has this static method
Code:
0: getstatic #1 // Field $VALUES:[LOrdinals;
3: invokevirtual #2 // Method "[LOrdinals;".clone:()Ljava/lang/Object;
6: checkcast #3 // class "[LOrdinals;"
9: areturn
public static Ordinals valueOf(java.lang.String); // every enum class has this static method
Code:
0: ldc_w #4 // class Ordinals
3: aload_0
4: invokestatic #5 // Method java/lang/Enum.valueOf:(Ljava/lang/Class;Ljava/lang/String;)Ljava/lang/Enum;
7: checkcast #4 // class Ordinals
10: areturn
private Ordinals(java.lang.String);
Code:
0: aload_0
1: aload_1
2: iload_2
3: invokespecial #6 // Method java/lang/Enum."<init>":(Ljava/lang/String;I)V
6: aload_0
7: aload_3
8: putfield #7 // Field notation:Ljava/lang/String;
11: return
public java.lang.String getNotation();
Code:
0: aload_0
1: getfield #7 // Field notation:Ljava/lang/String;
4: areturn
static {}; // fills the $VALUES array and initializes the static fields corresponding to the enum constants
Code:
0: new #4 // class Ordinals
3: dup
4: ldc #8 // String FIRST
6: iconst_0
7: ldc #9 // String st
9: invokespecial #10 // Method "<init>":(Ljava/lang/String;ILjava/lang/String;)V
12: putstatic #11 // Field FIRST:LOrdinals;
15: new #4 // class Ordinals
18: dup
19: ldc #12 // String SECOND
21: iconst_1
22: ldc #13 // String nd
24: invokespecial #10 // Method "<init>":(Ljava/lang/String;ILjava/lang/String;)V
27: putstatic #14 // Field SECOND:LOrdinals;
30: new #4 // class Ordinals
33: dup
34: ldc #15 // String THIRD
36: iconst_2
37: ldc #16 // String rd
39: invokespecial #10 // Method "<init>":(Ljava/lang/String;ILjava/lang/String;)V
42: putstatic #17 // Field THIRD:LOrdinals;
45: iconst_3
46: anewarray #4 // class Ordinals
49: dup
50: iconst_0
51: getstatic #11 // Field FIRST:LOrdinals;
54: aastore
55: dup
56: iconst_1
57: getstatic #14 // Field SECOND:LOrdinals;
60: aastore
61: dup
62: iconst_2
63: getstatic #17 // Field THIRD:LOrdinals;
66: aastore
67: putstatic #1 // Field $VALUES:[LOrdinals;
70: return
}
Это переведет на Java как
public final class Ordinals extends java.lang.Enum<Ordinals> {
public static final Ordinals FIRST;
public static final Ordinals SECOND;
public static final Ordinals THIRD;
private String notation;
private static final Ordinals[] $VALUES;
public static Ordinals[] values() {
return $VALUES.clone();
}
public static Ordinals valueOf(String name) {
return (Ordinals) Enum.valueOf(Ordinals.class, name);
}
private Ordinals(String name, int ordinal, String notation) {
super(name, ordinal);
this.notation = notation
}
static {
FIRST = new Ordinals("FIRST", 0, "st");
SECOND = new Ordinals("SECOND", 1, "nd");
THIRD = new Ordinals("THIRD", 2, "rd");
Ordinals[] $VALUES = new Ordinals[3];
$VALUES[0] = FIRST;
$VALUES[1] = SECOND;
$VALUES[2] = THIRD;
Ordinals.$VALUES = $VALUES;
}
}
Версия класса полностью не связана с этим - это зависит от версии используемого вами компилятора Java (или от явной настройки компилятора, чтобы заставить его скомпилировать более старую версию Java).
Вы можете думать о перечислениях как о классе с типизированными константами. Вы можете представить свой код как:
public enum Ordinals {
public static final FIRST = "st";
public static final SECOND = ..;
// ...
private String notation;
private Ordinals(String notation) {
this.notation = notation;
}
public String getNotation() {
return notation;
}
}
Команда javap может быть вам полезна, попробуйте следующее:
javap Example.class:
public final class Example extends java.lang.Enum<Example> {
public static final Example FIRST;
public static final Example SECOND;
public static final Example THIRD;
public static Example[] values();
public static Example valueOf(java.lang.String);
public java.lang.String getNotation();
static {};
}
Используя команду javap - p Ordinals.class, вы получите следующий код:
public final class Ordinals extends java.lang.Enum<Ordinals> {
public static final Ordinals FIRST;
public static final Ordinals SECOND;
public static final Ordinals THIRD;
private java.lang.String notation;
private static final Ordinals[] $VALUES;
public static Ordinals[] values();
public static Ordinals valueOf(java.lang.String);
private Ordinals(java.lang.String);
public java.lang.String getNotation();
static {};
}
Итак, каждое значение enum переводится в поле public static final типа класса. Если я правильно понял, в блоке static это поле инициализируется с помощью конструктора private, так что
static {
Ordinals.FIRST = new Ordinals("st");
Ordinals.SECOND = new Ordinals("nd");
Ordinals.THIRD = new Ordinals("rd");
// ...
}
Как указано в статье 3 книги Эффективная Java, enum обрабатывается более или менее как и Синглтон, и это отражается на использовании выше указанных полей public final static.
Class version - это то, что сообщает, с какой версией Java скомпилирован файл класса. Вероятно, вас это не интересовало.
Ваш enum будет скомпилирован нормально, при Ordinals неявно расширяя класс enum и с тремя переменными уровня класса, все экземпляры класса Ordinals.
Вывод javap -private для этого:
public final class Ordinals extends java.lang.Enum<Ordinals> {
public static final Ordinals FIRST;
public static final Ordinals SECOND;
public static final Ordinals THIRD;
private java.lang.String notation;
private static final Ordinals[] $VALUES;
public static Ordinals[] values();
public static Ordinals valueOf(java.lang.String);
private Ordinals(java.lang.String);
public java.lang.String getNotation();
static {};
}
Как вы видите, компилятор добавил несколько вещей.
Существует синтетический массив $VALUES, который будет копироваться всякий раз, когда вы вызываете метод values().
Сам метод values() добавляется в класс, чтобы соответствовать требованию каждого перечисления, что должен быть статический метод values(), возвращающий массив всех констант перечисления. Почему он добавляется компилятором, а не унаследован от Enum()? Потому что это статично.
Таким же образом добавлен valueOf. Он реализуется путем вызова статического Enum.valueOf.
Одна вещь, которую вы не видите в этом списке, состоит в том, что конструкторы имеют два дополнительных, невидимых параметра, которые передаются при настройке констант перечисления. Это постоянное имя и его порядковый номер. Они передаются до конструктора super() из Enum и используются для методов name() и ordinal(), которые унаследованы от него.