Enum的values()方法的文档在哪里?

我声明一个枚举为:

enum Sex {MALE,FEMALE}; 

然后,迭代枚举如下所示:

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

我检查了Java API,但无法findvalues()方法? 我很好奇这个方法从哪里来的?

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

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

logging在三个地方:

  • 枚举types , Java教程

编译器在创build枚举时会自动添加一些特殊的方法。 例如,它们具有一个静态值方法,该方法返回一个包含声明顺序的所有枚举值的数组。 此方法通常与for-each构造结合使用,以遍历枚举types的值。

  • Enum.valueOf
    (在valueOf方法的描述中提到了特殊的隐式values方法)

一个枚举types的所有常量可以通过调用该types的隐式公共静态T [] values()方法获得。

  • 枚举types,第8.9节 , Java语言规范

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

该方法是隐式定义的(即由编译器生成)。

从JLS :

另外,如果E是一个enumtypes的名字,那么这个types具有以下隐式声明的static方法:

 /** * 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); 

运行这个

  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添加了它们

笔记:

  1. 从不使用性作为类名,很难读取你的代码,我们在Java中使用Sex

  2. 当面对这样的Java拼图时,我推荐使用一个字节码反编译器工具(我使用Andrey Loskutov的字节码轮廓Eclispe插件)。 这将显示一个class级内的所有内容