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

问题

我宣布枚举为:

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


#1 热门回答(156 赞)

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

记录在三个地方:

  • 枚举类型,Java教程

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

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

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

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

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


#2 热门回答(29 赞)

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

JLS

此外,如果E是枚举类型的名称,则该类型具有以下隐式声明的静态方法:/**
*返回一个包含此枚举常量的数组
*按照声明的顺序输入。这种方法可能是
*用于迭代常量,如下所示:

  • for(E c:E.values())
  • System.out.println(c);
  • @return一个包含此枚举常量的数组
    *按照声明的顺序输入
  • /
    public static E [] values();

/**
*返回具有指定的此类型的枚举常量

  • 名称。
    *字符串必须与用于声明的标识符完全匹配
    *此类型的枚举常量。 (无关的空白
    *不允许使用字符。)
  • @return具有指定名称的枚举常量
  • @throws IllegalArgumentException如果此枚举类型没有
    *与指定名称一致
  • /
    public static E valueOf(String name);

#3 热门回答(10 赞)

运行这个

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

笔记:

  • 从不使用性别作为类名,很难阅读你的代码,我们在Java中使用Sex
  • 当面对像这样的Java拼图时,我建议使用字节码反编译工具(我使用Andrey Loskutov的字节码概述Eclispe插件)。这将显示课程内的所有内容