Enum的values（）方法的文档在哪里？

Question

我声明枚举为：

enum Sex {MALE,FEMALE};

然后，如下所示迭代枚举：

for(Sex v : Sex.values()){
    System.out.println(" values :"+ v);
}

我检查了Java API，但找不到values（）方法？我很好奇这种方法是从哪里来的？

API链接：https://docs.oracle.com/javase/8/docs/api/java/lang/Enum.html

Answer 1

运行这个

    for (Method m : sex.class.getDeclaredMethods()) {
        System.out.println(m);
    }

你会看到的

public static test.Sex test.Sex.valueOf(java.lang.String)
public static test.Sex[] test.Sex.values()

这些都是“性”类的公开方法。它们不在源代码javac中。exe添加了它们

注意事项：

>

永远不要使用sex作为类名，很难阅读代码，我们在Java中使用sex

当遇到像这样的Java难题时，我建议使用字节码反编译工具（我使用Andrey Loskutov的字节码大纲eLispe插件）。这将显示类中的所有内容

Answer 2

方法是隐式定义的（即由编译器生成）。

来自JLS：

此外，如果E是enum类型的名称，则该类型具有以下隐式声明的静态方法：

/**
* Returns an array containing the constants of this enum 
* type, in the order they're declared.  This method may be
* used to iterate over the constants as follows:
*
*    for(E c : E.values())
*        System.out.println(c);
*
* @return an array containing the constants of this enum 
* type, in the order they're declared
*/
public static E[] values();

/**
* Returns the enum constant of this type with the specified
* name.
* The string must match exactly an identifier used to declare
* an enum constant in this type.  (Extraneous whitespace 
* characters are not permitted.)
* 
* @return the enum constant with the specified name
* @throws IllegalArgumentException if this enum type has no
* constant with the specified name
*/
public static E valueOf(String name);

Answer 3

在javadoc中看不到这个方法，因为它是由编译器添加的。

记录在三个地方：

• 枚举类型，来自Java教程

编译器在创建枚举时会自动添加一些特殊方法。例如，它们有一个静态值方法，该方法返回一个数组，该数组按声明的顺序包含枚举的所有值。此方法通常与for each构造结合使用，以迭代枚举类型的值。

• Enum。valueOfclass
  （特殊的隐式values方法在valueOf方法的描述中提到）

枚举类型的所有常量都可以通过调用该类型的隐式公共静态T[]值（）方法获得。

• 枚举类型，第8.9节，Java语言规范

values函数只列出枚举的所有值。