10.1 枚举

把具体的对象一一列举出来的类，就称为 枚举类（enumeration）

实现方法：

1. 自定义枚举
2. enum 关键字枚举

10.1.1 自定义枚举

1. 构造器私有化
2. 去掉 set 方法（可保留 get），防止属性被修改。因为枚举对象值通常为只读
3. 在类内部直接创建固定对象。使用 final + static 共同修饰，对象名通常全部大写。
4. 枚举对象按照需要可以有多个属性

10.1.2 enum 关键字

enum Example {
 RED("小红", 10), BLUE("小蓝", 11), YELLOW; //这句话要放在前面，第三个是无参
 private String name;
 private int age;

 private Example(String name, int age) {
     this.name = name;
     this.age = age;
 }

}

1. 用关键字 enum 替代 class
2. 用 常量名.(形参列表); 代替创建对象（放在前面）。多个对象的场合，用 , 间隔。
3. 如果使用 enum 枚举，要求将常量对象写在前面

#10.1.2.1 使用细节

1. 当我们用 enum 关键字开发一个枚举类时，默认会继承 java.lang.Enum 类，而且是一个 final 类。

   这样，我们就能使用 Enum 中的相关方法。

   也正因为如此，enum 类不能继承其他类，亦不能被其它类继承

   不过，enum 类和其他类一样，可以实现接口。

2. 传统的 public ststic final RED("小红", 10); 简化为 RED("小红", 10);

3. 如果使用无参构造器创建枚举对象，则 实参列表 和 ( ) 都能省略

#10.1.2.2 Enum 类中的常用方法

• valueOf：将字符串转换成枚举对象。要求字符串必须是已有的常量名，否则报异常。
• values：返回一个数组 Example[]，其中包含定义的所有枚举对象
• getDeclaringClass：得到枚举常量所属的 class
• name：得到当前枚举常量的名称。建议优先用 toString
• ordinal：输出该枚举对象的次序/编号（从 0 开始编号。如上例 BLUE.ordinal = 1）
• compareTo：比较两个枚举常量的编号（调用常量编号 减去 传入常量编号）
• clone：枚举类不能 clone，所以，这是一个只会抛出异常的方法

10.1.3 Enumeration 接口

Enumeration 接口中定义了一些方法，通过这些方法可以枚举（一次获得一个）对象集合中的元素。这种传统接口已被迭代器取代，虽然 Enumeration 还未被遗弃，但在现代代码中已经被很少使用了。尽管如此，它还是使用在诸如 Vector 和 Properties 这些传统类所定义的方法中，除此之外，还用在一些 API 类，并且在应用程序中也广泛被使用。 下表总结了一些 Enumeration 声明的方法：

1	boolean hasMoreElements( ) 测试此枚举是否包含更多的元素。
2	Object nextElement( ) 如果此枚举对象至少还有一个可提供的元素，则返回此枚举的下一个元素。

实例

以下实例演示了 Enumeration 的使用：

import java.util.Vector;
import java.util.Enumeration;

public class EnumerationTester {

   public static void main(String args[]) {
      Enumeration<String> days;
      Vector<String> dayNames = new Vector<String>();
      dayNames.add("Sunday");
      dayNames.add("Monday");
      dayNames.add("Tuesday");
      dayNames.add("Wednesday");
      dayNames.add("Thursday");
      dayNames.add("Friday");
      dayNames.add("Saturday");
      days = dayNames.elements();
      while (days.hasMoreElements()){
         System.out.println(days.nextElement());
      }
   }
}

Sunday
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday

10.2 注解

注解（Annotation）也被称为元数据（Metadata）。用于修饰 包、类、方法、属性、构造器、局部变量 等数据信息

和注释一样，注解不影响程序逻辑，但注解可以被编译或运行，相当于嵌入在代码中的补充信息

在 JavaSE 中，注解的使用目的比较简单，例如 标记过时的功能，忽略警告 等。在 JavaEE 中注解占据了更重要的角色，例如用于配置应用程序的任何切面，代替 JavaEE 旧版中所遗留的繁冗代码和 XML 配置等。

1. 使用 @Annotation 时要在前面增加 @ 符号，并把该注解当成一个修饰符使用。用于修饰它支持的程序元素。

2. 三个基本的 @Annotation：

   • @Override：限定某个方法，是 重写 父类方法。该注解只能用于方法。如果你写了该注解，编译器会替你校验，看看是不是真的 重写 了父类方法。
   • @Deprecated：用于表示某个程序元素（类、方法等）已经过时
   • @SuppressWarnings()：抑制编辑器警告

3. 如果发现 public @interface XXX{} 这种东西，说明是定义了一个注解类 XXX。这里的 @interface 不代表接口（interface）。

10.2.1 @Override

1. @Override 表示指定重写父类的方法（从编译器层面验证），如果父类没有该方法，就报错
2. 不写该注解，重写依然构成重写
3. @Override 只能修饰方法，不能修饰其他 类、包、属性等
4. 查看 @Override 注解源码为 @Target(ElementType.METHOD) 说明只能修饰方法
5. @Target 是修饰注解的注解，称为 元注解

10.2.2 @Deprecated

1. @Deprecated 表示指定的某个程序元素（类、方法等）已过时

2. 不推荐使用，但仍能使用

3. 可以修饰方法、类、字段、包、参数

   @Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})

4. @Deprecated 可以做到新旧版本的兼容和过度

10.2.3 @SuppressWarnings()

1. 当我们不想看到警告信息时，用 @SuppressWarnings()

   语法：@SuppressWarnings({"..."})

   在后面 ({"unused", "unchecked"}) 这样写入你希望抑制的信息，以下是所有可以输入的关键字

   关键字	用途
   all	抑制所有警告
   boxing	抑制与装箱/解装箱操作相关的警告
   cast	抑制与强制转换操作相关的警告
   dep-ann	抑制与已弃用注释相关的警告
   deprecation	抑制与弃用有关的警告
   fallthrough	抑制与 switch 语句中丢失断点相关的警告
   finally	抑制不返回的 finally 块的相关警告
   hiding	抑制与隐藏变量的局部变量相关的警告
   incomplete-switch	抑制与 switch 语句中缺少条目相关的警告（enum）
   nls	抑制与 非 nls 字符串字面值相关的警告
   null	抑制相对于 null 分析的警告
   rawtypes	在类参数上使用泛型时，抑制与非特定类型相关的警告
   restriction	抑制与不推荐或禁止引用有关的警告
   serial	抑制与可序列化类缺少 serialVersionUID 字段相关的警告
   static-access	抑制与不正确的静态访问有关的警告
   synthetic-access	抑制与未优化的内部类访问相关的警告
   unchecked	抑制与未检查的操作相关的警告
   unqualified-field-access	抑制与字段访问不合格相关的警告
   unused	抑制与未使用代码相关的警告

2. @SuppressWarnings 的范围与你放置的位置相关。

10.2.4 JDK 的元注解（了解即可）

JDK 的 元注解 是用于修饰其他注解的注解

1. @Rentention：指定注解的作用范围，有三种范围 SOURCE CLASS RUNTIME

   @Rentention 的三种值：

   • RententionPolicy.SOURCE：编译器使用后，直接丢弃这种策略的注释
   • RententionPolicy.CLASS：编译器把注解记录在 class 文件中。当运行 Java 程序时， JVM 不会保留注释。这是默认值
   • RententionPolicy.RUNTIME：编译器把注解记录在 class 文件中。当运行 Java 程序时，JVM 会保留注解。程序可以通过反射获取该注解

2. @Target：指定注解的使用范围

   @Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE})

3. @Documented：指定该注解会不会在 Javadoc 体现

4. @Inherited：子类会继承父类注解

更新日志

2026/5/5 18:19

查看所有更新日志

• fde06-docs: 添加 doc 技术文档于 2026/5/5

贡献者: chen, Claude Sonnet 4.6