Где находится документация для метода 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, потому что он добавлен компилятором.

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

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

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

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

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

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

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

— Денис Сегюре
источник

какая-то конкретная причина для этого? почему это не часть API?

— rai.skumar

Поскольку используя только стандартный механизм (без enum), у вас не может быть этого статического метода. Спецификация java должна была быть расширена, чтобы разрешить эти перечисления, поэтому она должна быть добавлена компилятором.

— Денис Сегюре

Начиная с Java 7 это было добавлено в javadoc java.lang.Enum, в описании статического метода valuOf.

— Catweazle

Создает ли «values ()» новый массив, или он повторно использует тот же?

— Android-разработчик

@androiddeveloper возвращает новый массив (в противном случае вы можете возиться с перечислением)

— Денис Сегюре,

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

Из 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

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

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

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

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

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