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

172

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

enum Sex {MALE,FEMALE};

Затем выполните итерацию enum, как показано ниже:

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

java enums rai.skumar
источник

Ответы:

178

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

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

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

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

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

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

Денис Сегюре
источник
6
какая-то конкретная причина для этого? почему это не часть API?
rai.skumar
10
Поскольку используя только стандартный механизм (без enum), у вас не может быть этого статического метода. Спецификация java должна была быть расширена, чтобы разрешить эти перечисления, поэтому она должна быть добавлена ​​компилятором.
Денис Сегюре
4
Начиная с Java 7 это было добавлено в javadoc java.lang.Enum, в описании статического метода valuOf.
Catweazle
3
Создает ли «values ​​()» новый массив, или он повторно использует тот же?
Android-разработчик
3
@androiddeveloper возвращает новый массив (в противном случае вы можете возиться с перечислением)
Денис Сегюре,
35

Метод неявно определяется (т. Е. Генерируется компилятором).

Из 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);
NPE
источник
Added by the compilerозначает, что для этого кода нет .java или код сгенерирован компилятором? Я проверил исходный код OpenJDK для Enum и его нетvalues()
Marco Sulla
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, я рекомендую использовать инструмент декомпиляции байт-кода (я использую плагин Eclispe схемы байт-кода Андрея Лоскутова). Это покажет все, что внутри класса

Евгений Дорофеев
источник