Где документация для метода values () для Enum?

Я объявляю перечисление как:

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

Вы не можете увидеть этот метод в javadoc, потому что он добавлен компилятором.

Документально оформлено в трех местах:

Типы Enum, из Учебников по Java

Компилятор автоматически добавляет некоторые специальные методы при создании перечисления. Например, у них есть метод статических значений, который возвращает массив, содержащий все значения перечисления в порядке их объявления. Этот метод обычно используется в сочетании с конструкцией for-each для итерации по значениям типа enum.

Enum.valueOf class
(Специальный метод неявных values упоминается в описании метода valueOf)

Все константы типа enum могут быть получены путем вызова неявного открытого статического метода T [] values () этого типа.

Типы Enum, Раздел 8.9, Спецификация языка Java

Функция values просто перечисляет все значения перечисления.

Ответ 2

Метод неявно определен (т.е. сгенерирован компилятором).

Из JLS:

Кроме того, если E - это имя типа enum, то этот тип имеет следующие неявно объявленные методы 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);

Ответ 3

Запустите этот

    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 in Java
когда вы сталкиваетесь с головоломкой Java, подобной этой, я рекомендую использовать инструмент декомпилятора байт-кода (я использую плагин Eclispe для байт-кода Андрея Лоскутова). Это покажет все, что внутри класса