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


172

我将枚举声明为:

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


Answers:


178

您无法在javadoc中看到此方法,因为它是由编译器添加的。

记录在三个地方:

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

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

枚举类型的所有常量都可以通过调用该类型的隐式公共静态T [] values()方法来获取。

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


6
有什么具体原因吗?为什么它不属于API?
rai.skumar

10
因为仅使用标准机制(没有枚举),所以无法使用此静态方法。必须扩展Java规范以允许这些枚举,这就是为什么编译器必须添加它。
DenysSéguret'12

4
从Java 7开始,已在静态valuOf方法的描述中将其添加到java.lang.Enum的javadoc中。
Catweazle

3
调用“ values()”会创建一个新数组,还是会重用同一数组?
Android开发者

3
@androiddeveloper它返回一个新数组(否则您可能会
弄混

35

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

JLS

此外,如果Eenum类型的名称,则该类型具有以下隐式声明的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);

Added by the compiler表示此代码没有.java或代码是由编译器生成的?我查了枚举的OpenJDK的源代码,而且也没有values()
马尔科·苏拉

12

运行这个

    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中使用性别

  2. 当面对这样的Java难题时,我建议使用字节码反编译器工具(我使用Andrey Loskutov的字节码大纲Eclispe插件)。这将显示课程中的所有内容

By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.