枚举和注解

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

注意事项
1. 当使用枚举关键字开发一个枚举类时，默认会继承Enum类（java.lang.Enum）（使用javap工具来演示：反编译）
2. 传统的public static final Season2 SPRING = new Season2("春天","温暖") ；简化成 SPRING(”春天“,”温暖“) ，调用的是哪个构造器
3. 如果使用无参构造器创建枚举对象，则实参列表和小括号都可以省略
4. 当有多个枚举对象时，使用","逗号间隔，最后有一个分号结尾
5. 枚举对象必须放在首行

3、enum常用方法说明

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

enum常用方法表：

应用实例
1. toStrng：Enum类已经重写过了，返回的是当前对象名，子类可以重写该方法，用于返回对象的属性信息
2. name：返回当前对象名（常量名），子类中不能重写
3. ordinal：返回当前对象的位置号，默认从0开始
4. values：返回当前枚举类中所有常量
5. valueOf：将字符串转换成枚举对象，要求字符必须为已有的常量名，否则报异常！
6. 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实现接口
1. 使用enum关键字后，就不能再继承其他类了，因为enum会隐式继承Enum，而Java是单继承机制
2. 枚举类和普通类一样，可以实现接口，形式如下
  enum 类名 implements 接口1，接口2 {}

2、注解

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

1、基本的 Annotation 介绍

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

三个基本的 Annotation：
1. @Override：限定某个方法，是重写父类方法，该注解只能用于方法
  @interface 表示一个注解类
  @Target 是修饰注解的注解，称为元注解
2. @Deprecated：用于表示某个程序元素（类、方法等）已过时
  过时并不代表不能用，即不推荐使用
  说明：
  1. 用于表示某个程序元素（类、方法等）已过时
  2. 可以修饰方法，类，字段，包，参数等等
  3. @Target(value = {CONSTRUCTOR,FIELD,LOCAL_VARIABLE,METHOD,PACKAGE,PARAMETER,TYPE})
  4. @Deprecated 的作用可以做到新旧版本的兼容过度
3. @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
元注解：本身作用不大
元注解的种类（使用不多，了解）
1. Retention 指定注解的作用范围，三种 SOURCE(源码级别),CLASS(类),RUNTIME(运行时)
2. Target 指定注解可以在那些地方使用
3. Documented 指定该注解是否会在javadoc体现
4. 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，则其子类将自动具有该注解