第11章枚举和注解(P425 - P443)¶

1、枚举¶

枚举（enumeration，简写enum）
枚举是一组常量的集合
可以理解为：枚举属于一种特殊的类，里面只包含一组有限的特定的对象

1、枚举的两种实现方式¶

自定义类实现枚举
使用enum关键字实现枚举

2、自定义类枚举¶

不需要提供setXxx 方法，因为枚举对象值通常为只读
对枚举对象/属性使用 final + static 共同修饰，实现底层优化
枚举对象名通常使用全部大写，常量的命名规范
枚举对象根据需要，也可以有多个属性
//Enumeration02.java

小结：

构造器私有化
本类内部创建一组对象
对外暴露对象（通过为对象添加public,final,static修饰符）
可以提供 get方法，但是不要提供 set

3、enum关键字实现枚举¶

使用关键字 emnu 代替 class
public static final Season2 SPRING = new Season2("春天","温暖") 直接使用 SPRING(”春天“,”温暖“) 解读常量名(实参列表)
如果有多个常量(对象)，使用 , 号间隔即可
如果使用enum 来实现枚举，要求将定义常量对象，写在前面
如果使用的是无参构造器，创建常量对象，则可以省略（）
//Enumeration03.java
注意事项
当使用枚举关键字开发一个枚举类时，默认会继承Enum类（java.lang.Enum）（使用javap工具来演示：反编译）
传统的public static final Season2 SPRING = new Season2("春天","温暖") ；简化成 SPRING(”春天“,”温暖“) ，调用的是哪个构造器
如果使用无参构造器创建枚举对象，则实参列表和小括号都可以省略
当有多个枚举对象时，使用","逗号间隔，最后有一个分号结尾
枚举对象必须放在首行

3、enum常用方法说明¶

说明：使用关键字enum时，会隐式继承Enum类，所以就可以使用Enum类相关方法

enum常用方法表：

应用实例
toStrng：Enum类已经重写过了，返回的是当前对象名，子类可以重写该方法，用于返回对象的属性信息
name：返回当前对象名（常量名），子类中不能重写
ordinal：返回当前对象的位置号，默认从0开始
values：返回当前枚举类中所有常量
valueOf：将字符串转换成枚举对象，要求字符必须为已有的常量名，否则报异常！
compareTo：比较两个枚举常量，比较的就是位置号

//补充
        int[] nums = {1,2,8};
        System.out.println("====普通for====");
        for (int i = 0; i < nums.length; i++) {
            System.out.println(nums[i]);
        }

        System.out.println("====增强for====");
        //执行流程是 依次从nums数组中取出数据，赋给i，如果取出完毕，则退出for
        for (int i : nums) {
            System.out.println("i = " + i);
        }

enum实现接口
使用enum关键字后，就不能再继承其他类了，因为enum会隐式继承Enum，而Java是单继承机制
枚举类和普通类一样，可以实现接口，形式如下

enum 类名 implements 接口1，接口2 {}

2、注解¶

注解（Annotaion）也成为元数据（Metadata），用于修饰解释包、类、方法、属性、构造器、局部变量等数据信息
和注释一样，注解不影响程序逻辑，但注解可以被编译或运行，相当于嵌入在代码中的补充信息
再JavaSE中，注解的使用目的比较简单，例如标记过时的功能，忽略警告等。再JavaEE中注解占据了更重要的角色，例如用来配置应用程序的任何切面，代替Java EE旧版中所遗留的繁冗代码和XML配置等

1、基本的 Annotation 介绍¶

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

三个基本的 Annotation：
@Override：限定某个方法，是重写父类方法，该注解只能用于方法

@interface 表示一个注解类

@Target 是修饰注解的注解，称为元注解
@Deprecated：用于表示某个程序元素（类、方法等）已过时

过时并不代表不能用，即不推荐使用

说明：
1. 用于表示某个程序元素（类、方法等）已过时
2. 可以修饰方法，类，字段，包，参数等等
3. @Target(value = {CONSTRUCTOR,FIELD,LOCAL_VARIABLE,METHOD,PACKAGE,PARAMETER,TYPE})
4. @Deprecated 的作用可以做到新旧版本的兼容过度
@SuppressWarnings：抑制编译器警告

@SuppressWarnings({""}) ==> 在 "" 中，多个用逗号”，“隔开，可以写入你希望抑制（不显示）的警告信息

作用范围：放置的位置相关（方法，类，字段，包，参数）

@SuppressWarning 中的属性介绍以及属性说明

all，抑制所有警告
boxing，抑制与封装/拆装作业相关的警告
cast，抑制与强制转型作业相关的警告
dep-ann，抑制与淘汰注释相关的警告
deprecation，抑制与淘汰的相关警告
fallthrough，抑制与switch陈述式中遗漏break相关的警告
finally，抑制与未传回finally区块相关的警告
hiding，抑制与隐藏变数的区域变数相关的警告
incomplete-switch，抑制与switch陈述式(enum case)中遗漏项目相关的警告
javadoc，抑制与javadoc相关的警告
nls，抑制与非nls字串文字相关的警告
null，抑制与空值分析相关的警告
rawtypes，抑制与使用raw类型相关的警告
resource，抑制与使用Closeable类型的资源相关的警告
restriction，抑制与使用不建议或禁止参照相关的警告
serial，抑制与可序列化的类别遗漏serialVersionUID栏位相关的警告
static-access，抑制与静态存取不正确相关的警告
static-method，抑制与可能宣告为static的方法相关的警告
super，抑制与置换方法相关但不含super呼叫的警告
synthetic-access，抑制与内部类别的存取未最佳化相关的警告
sync-override，抑制因为置换同步方法而遗漏同步化的警告
unchecked，抑制与未检查的作业相关的警告
unqualified-field-access，抑制与栏位存取不合格相关的警告
unused，抑制与未用的程式码及停用的程式码相关的警告

2、JDK 的元 Annotation （元注解，了解）¶

元注解的基本介绍

JDK的元 Annotation 用于修饰其他的 Annoation

元注解：本身作用不大

元注解的种类（使用不多，了解）
Retention 指定注解的作用范围，三种 SOURCE(源码级别),CLASS(类),RUNTIME(运行时)
Target 指定注解可以在那些地方使用
Documented 指定该注解是否会在javadoc体现
Inherited 子类会继承父类注解
@Retention 注解
说明

只能用于修饰一个 Annotation 定义，用于指定该 Annotation 可以保留多长时间，@Retention 包含一个 RetentionPolicy 类型的成员变量，使用 @Retention时必须为该 value 成员变量指定值：
@Retention 的三种值
1. RetentionPolicy.SOURCE：编译器使用后，直接丢弃这种策略的注释
2. RetentionPolicy.CLASS：编译器将把注解记录在 class 文件中，当运行Java程序时，JVM 不会保留注释，这是默认值
3. RetentionPolicy.RUNTIME：编译器将把注解记录在class文件中，当运行Java 程序时，JVM 会保留注释，程序可以通过反射获取该注释
@Target
基本说明：

用于修饰 Annotation 定义，用于指定被修饰的 Annotation 能用于修饰那些程序元素。@Target 也包含一个名为 value 的成员变量
@Documented
基本说明

@Documented：用于指定该元 Annotation 修饰的 Annotation 类将被javadoc 工具提取成文档，即在生成文档时，可以看到该注释

说明：定义为Documented的注解必须设置Retention值为RUNTIME
Inherited 注解

被它修饰的 Annotation 将具有继承性，如果某个类使用了被 @Inherited 修饰的 Annotation，则其子类将自动具有该注解

第11章 枚举和注解(P425 - P443)¶