Wo ist die Dokumentation für die values ​​() -Methode von Enum?

Ich erkläre eine Aufzählung als:

enum Sex {MALE,FEMALE};

Und dann iterieren Sie die Aufzählung wie unten gezeigt:

for(Sex v : Sex.values()){
    System.out.println(" values :"+ v);
}

Ich habe die Java-API überprüft, kann aber die Methode values ​​() nicht finden. Ich bin gespannt, woher diese Methode kommt.

API-Link: https://docs.oracle.com/javase/8/docs/api/java/lang/Enum.html

Sie können diese Methode in Javadoc nicht sehen, da sie vom Compiler hinzugefügt wurde.

An drei Stellen dokumentiert:

• Aufzählungstypen aus den Java-Tutorials

Der Compiler fügt beim Erstellen einer Aufzählung automatisch einige spezielle Methoden hinzu. Beispielsweise verfügen sie über eine statische Wertemethode, die ein Array zurückgibt, das alle Werte der Aufzählung in der Reihenfolge enthält, in der sie deklariert sind. Diese Methode wird üblicherweise in Kombination mit dem for-each-Konstrukt verwendet, um die Werte eines Aufzählungstyps zu durchlaufen.

• Enum.valueOfKlasse
  (Die spezielle implizite valuesMethode wird in der Beschreibung der valueOfMethode erwähnt.)

Alle Konstanten eines Aufzählungstyps können durch Aufrufen der impliziten öffentlichen statischen T [] values ​​() -Methode dieses Typs erhalten werden.

• Aufzählungstypen, Abschnitt 8.9 , Java-Sprachspezifikation

Die valuesFunktion listet einfach alle Werte der Aufzählung auf.

Die Methode ist implizit definiert (dh vom Compiler generiert).

Aus dem JLS :

Wenn Ees sich um den Namen eines enumTyps handelt, verfügt dieser Typ außerdem über die folgenden implizit deklarierten staticMethoden:

/**
* 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);

Führen Sie dies aus

    for (Method m : sex.class.getDeclaredMethods()) {
        System.out.println(m);
    }

du wirst sehen

public static test.Sex test.Sex.valueOf(java.lang.String)
public static test.Sex[] test.Sex.values()

Dies sind alles öffentliche Methoden, die die "Sex" -Klasse hat. Sie sind nicht im Quellcode enthalten, javac.exe hat sie hinzugefügt

Anmerkungen:

1. Verwenden Sie niemals Sex als Klassennamen. Es ist schwierig, Ihren Code zu lesen. Wir verwenden Sex in Java

2. Wenn Sie sich einem Java-Puzzle wie diesem stellen, empfehle ich die Verwendung eines Bytecode-Dekompiler-Tools (ich verwende das Eclispe-Plugin für den Bytecode-Umriss von Andrey Loskutov). Dies zeigt alles, was sich in einer Klasse befindet