Où est la documentation pour les valeurs de() la méthode d'Enum?

Je déclarer une énumération que : 

enum Sex {MALE,FEMALE};

Et puis, itérer enum comme indiqué ci-dessous :

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

J'ai vérifié l'API Java, mais ne peut pas trouver les valeurs de() la méthode? Je suis curieux de savoir où cette méthode vient de la?

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

InformationsquelleAutor rai.skumar | 2012-12-01
  1. 175

    Vous ne pouvez pas voir cette méthode dans la javadoc, car il est ajouté par le compilateur.

    Documenté dans trois endroits :

    Le compilateur ajoute automatiquement certaines méthodes spéciales lorsqu'il crée
    un enum. Par exemple, ils ont des valeurs statiques méthode qui renvoie un
    tableau contenant toutes les valeurs de l'enum dans l'ordre où ils sont
    déclarée. Cette méthode est couramment utilisé en combinaison avec le
    pour chaque construction pour effectuer une itération sur les valeurs d'un type enum.

    • Enum.valueOf classe
      spécial implicite values méthode est mentionné dans la description de valueOf méthode)

    Toutes les constantes d'un type enum peut être obtenu en appelant l'implicite public static T[] valeurs de() la méthode de ce type.

    La values fonction tout simplement la liste de toutes les valeurs de l'énumération.

    • pour quelle raison particulière à cela? pourquoi il ne fait pas partie de l'API?
    • Parce que juste en utilisant le mécanisme standard (sans enum), vous ne pouvez pas avoir cette méthode statique. Les spécifications de java a dû être prolongée pour permettre à ces énumérations, c'est pourquoi il doit être ajouté par le compilateur.
    • Depuis Java 7 ce qui a été ajouté à la javadoc de java.lang.Enum, dans la description de la statique valuOf méthode.
    • Bonne observation. Je donne le lien ici.
    • Drôle qu'il n'est pas répertoriée comme sa propre méthode. J'ai complètement raté!
    • N'appelant "les valeurs de()" créer un nouveau tableau, ou faut-il ré-utiliser le même?
    • il renvoie un nouveau tableau (sinon vous risquez de vous salir avec l'enum)
    • Je vois. Je vous remercie. Savez-vous si c'est écrit quelque part que c'est ce qui est censé être?
    • Non, mais c'est implicite. Il est dit qu'elle retourne un tableau contenant les valeurs de l'énumération. Comme un tableau ne peut pas être constante en java, la seule façon de garantir le tableau n'a pas été changé (peut-être sur un autre thread) est pour en faire une nouvelle.
    • Assurez-vous d'un tableau peut être constant. Suffit de le définir comme "private static final", et à l'intérieur d'un "statique" du bloc, de l'initialiser. Les valeurs peuvent être modifiées, mais cela ne signifie pas qu'il doit avoir une incidence sur l'enum lui-même, ainsi que les valeurs ne sont pas stockées là. En tout cas, je vous remercie.
    • Les valeurs peuvent être modifiées, c'est le point, de sorte que vous ne pouvez pas partager la matrice, par conséquent, vous devez donner un différent à chaque accès.

    InformationsquelleAutor Denys Séguret
  2. 34

    La méthode est implicitement défini (i.e. généré par le compilateur).

    De la JLS:

    En outre, si E est le nom d'un enum type, alors que le type a la suite déclarée implicitement static méthodes:

    /**
* 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);
    • Added by the compiler n'y a pas de .java pour le présent code ou le code est généré par le compilateur? J'ai vérifié le OpenJDK code source d'Enum et il n'y a pas values()
    InformationsquelleAutor NPE
  3. 12

    Exécuter ce 

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

    vous verrez 

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

    Ce sont toutes les méthodes publiques que le "sexe" de la classe a. Ils ne sont pas dans le code source, javac.exe ajouté

    Notes:

    1. ne jamais utiliser le sexe comme un nom de classe, il est difficile de lire votre code, nous utilisons le Sexe en Java

    2. face à un Java puzzle comme celui-ci, je vous recommande d'utiliser un bytecode decompiler outil (j'utilise Andrey Loskutov du bytecode contour Eclispe plugin). Cela permettra de montrer à tous ce qui est à l'intérieur d'une classe

    • merci pour la correction...ont corrigé la faute de frappe dans le nom enum 🙂
    InformationsquelleAutor Evgeniy Dorofeev