The Java Language Specification, Third Edition

CLASSES Enums 8.9
DISCUSSION
This implies that it is impossible to define a local (§14.3) enum, or to define an enum in an
inner class (§8.1.3).
Any constructor or member declarations within an enum declaration apply to
the enum type exactly as if they had been present in the class body of a normal
class declaration unless explicitly stated otherwise.
The direct superclass of an enum type named E is Enum. In addition to the
members it inherits from Enum, for each declared enum constant with the
name n the enum type has an implicitly declared public static final field
named n of type E. These fields are considered to be declared in the same order as
the corresponding enum constants, before any static fields explicitly declared in
the enum type. Each such field is initialized to the enum constant that corresponds
to it. Each such field is also considered to be annotated by the same annotations as
the corresponding enum constant. The enum constant is said to be created when
the corresponding field is initialized.
It is a compile-time error for an enum to declare a finalizer. An instance of an
enum may never be finalized.
In addition, if E is the name of an enum type, then that type has the following
implicitly declared static methods:
/**
* 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();
DRAFT
/**
* 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
251