Java学习之路（十）：枚举类和注解

一、枚举类的使用

• 当类的对象只有有限个，确定的(此类称为枚举类)，如

  1. 星期：周一，… ， 周日
  2. 性别：男（man），女（woman）
  3. 支付方式：Cash（现金），WeChatPay（微信支付），Alipay（支付宝），BandCard（银行卡）
  4. 线程的状态：创建、就绪、运行、阻塞、死亡

• 即当需要定义一组常量时，强烈建议使用枚举类

• 若枚举类只有一个对象，则可以作为一种单例模式的实现方式

1. 如何自定义枚举类（JDK5.0之前）

• 枚举类的属性
  1. 枚举类对象的属性不应允许被改动，所以应该使用private final修饰
  2. 枚举类的使用private final修饰的属性应该在构造器中为其赋值
  3. 若枚举类显式定义了带参数的构造器，则在列出枚举值时也必须对应的传入参数
• 自定义枚举类的步骤
  1. 枚举类对象的属性，要用private final修饰
  2. 私有化构造器，并对被private final修饰的属性初始化
  3. 提供当前枚举类的多个对象
  4. 其他述求1：提供枚举类对象属性的get方法
  5. 其他述求2：提供toString方法

//自定义枚举类
class Season{

    // 1. 枚举类对象的属性，要用private final修饰
    private final String seasonName;
    private final String seasonDesc;

    //2. 私有化构造器，并对被private final修饰的属性初始化
    private Season(String seasonName,String seasonDesc){
        this.seasonName = seasonName;
        this.seasonDesc = seasonDesc;
    }

    //3.提供当前枚举类的多个对象
    public static final Season SPRING = new Season("春","春暖花开");
    public static final Season SUMMER = new Season("夏","夏日炎炎");
    public static final Season AUTUMN = new Season("秋","秋高气爽");
    public static final Season WINTER = new Season("冬","寒风瑟瑟");

    //4.其他述求1：提供枚举类对象属性的get方法

    public String getSeasonName() {
        return seasonName;
    }

    public String getSeasonDesc() {
        return seasonDesc;
    }

    //5.其他述求2：提供toString方法
    @Override
    public String toString() {
        return "Season{" +
                "seasonName='" + seasonName + '\'' +
                ", seasonDesc='" + seasonDesc + '\'' +
                '}';
    }
}

2. 如何使用关键字enum定义枚举类（关键字enum是JDK5.0的新特性）

• 使用关键字enum定义枚举类的步骤
  1. 提供当前枚举类的多个对象，多个对象之间用“,”隔开，末尾对象用“;”结束
  2. 枚举类对象的属性，要用private final修饰
  3. 私有化构造器，并对被private final修饰的属性初始化
  4. 其他述求：提供枚举类对象属性的get方法

说明：定义的枚举类默认继承于java.lang.Enum类（该类重写了toString方法，默认返回对象名）

//：使用Enum关键字定义枚举类
//说明：定义的枚举类默认继承于java.lang.Enum类（该类重写了toString方法，默认返回对象名）
enum Season1{
    
    //1.提供当前枚举类的多个对象，多个对象之间用“,”隔开，末尾对象用“;”结束
     SPRING("春","春暖花开"),
     SUMMER("夏","夏日炎炎"),
     AUTUMN("秋","秋高气爽"),
     WINTER("冬","寒风瑟瑟");

    // 2. 枚举类对象的属性，要用private final修饰
    private final String seasonName;
    private final String seasonDesc;

    //3. 私有化构造器，并对被private final修饰的属性初始化
    private Season1(String seasonName,String seasonDesc){
        this.seasonName = seasonName;
        this.seasonDesc = seasonDesc;
    }

    //4.其他述求：提供枚举类对象属性的get方法

    public String getSeasonName() {
        return seasonName;
    }

    public String getSeasonDesc() {
        return seasonDesc;
    }
    
}

3. Enum类的主要方法

• 常用的三个方法
  1. values()方法：返回枚举类型的对象数组。该方法可以很方便的遍历所有的枚举值
  2. valueOf(String str)：可以把一个字符串转为对应的枚举类对象。要求字符串必须是枚举类对象的“名字”。如不是，会有运行时异常：IllegalArgumentException
  3. toString()：返回当前枚举对象常量的名称

 @Test
    public void test(){
        //测试Enum类三个常用的方法
        Season1 summer = Season1.SUMMER;
        //1.toString()
        System.out.println(summer.toString());//SUMMER
        //2. values()
        System.out.println(Arrays.toString(Season1.values()));//[SPRING, SUMMER, AUTUMN, WINTER]
        //3. valueOf(String objName)：根据提供的objName，返回枚举类对象中对象名为objName的对象
        //如果没有objName的枚举类对象，则会抛异常IllegalArgumentException
        Season1 winter = Season1.valueOf("WINTER");
        System.out.println(winter);//WINTER
    }

}

4. 使用enum关键字定义的枚举类实现接口的情况

• 情况一：使用implements实现接口后，在enum类中实现抽象方法
• 情况二：让枚举类的对象分别实现接口中的抽象方法

enum Season1 implements Info{

    //1.提供当前枚举类的多个对象
     SPRING("春","春暖花开"){
        @Override
        public void show() {
            System.out.println("春天在哪里");
        }
    },
     SUMMER("夏","夏日炎炎"){
         @Override
         public void show() {
             System.out.println("夏蝉");
         }
     },
     AUTUMN("秋","秋高气爽"){
         @Override
         public void show() {
             System.out.println("秋风");
         }
     },
     WINTER("冬","寒风瑟瑟"){
         @Override
         public void show() {
             System.out.println("20000年的第一场雪");
         }
     };

    // 2. 枚举类对象的属性，要用private final修饰
    private final String seasonName;
    private final String seasonDesc;

    //3. 私有化构造器，并对被private final修饰的属性初始化
    private Season1(String seasonName,String seasonDesc){
        this.seasonName = seasonName;
        this.seasonDesc = seasonDesc;
    }

    //4.其他述求：提供枚举类对象属性的get方法

    public String getSeasonName() {
        return seasonName;
    }

    public String getSeasonDesc() {
        return seasonDesc;
    }

}

interface Info{
    void show();
}

二、注解（Annotation）的使用

1. 注解（Annotation）概述

• 从JDK5.0开始，JDK增加了对元数据（MetaData）的支持，也就是Annotation（注解）
• Annotation其实就是代码里的特殊标记，这些标记可以在编译，类加载，运行时被读取，并执行相应的处理。通过使用Annotation，程序员可以在不改变原有逻辑的情况下，在源文件中嵌入一些补充信息。代码分析工具、开发工具和部署工具可以通过这些补充信息进行验证或者进行部署。
• Annotation可以像修饰符一样被使用，可用于修饰包，类，构造器，方法，成员变量，参数，局部变量的声明，这些信息被保存在Annotation的“name=value”对中
• 在JavaSE中，注解的使用目的比较简单，例如标记过时的功能，忽略警告等。在JavaEE和Android中注解占据了更重要的角色，例如用来配置应用程序的任何切面，代替JavaEE旧版中所遗留的繁冗代码和XML配置等
• 未来的开发模式都是基于注解的，JPA是基于注解的，Spring2.5以上都是基于注解的，Hibernate3.X以后也都是基于注解，现在的Struts2有一部分也是基于注解的了，注解是一种趋势，一定程度上可以说框架 = 注解 + 反射 + 设计模式

2. 常见的Annotation示例

• 示例一：生成文档相关的注解
  
• 示例二：在编译时进行格式检查（JDK内置的三个基本注解）
  
• 示例三：跟踪代码依赖性，实现替代配置文件功能
  
  

3. 自定义Annotation

• 如何自定义注解：参照@SuppressWarnings定义
  
• 步骤：

1. 注解声明为@interface
2. 内部定义成员，通常使用value表示
3. 可以指定内部成员的默认值，使用default定义
4. 如果自定义注解没有成员，表明是一个标识作用

说明：

1. 如果注解有成员（没有设置默认值），则在使用注解时，需要指明成员的值
2. 自定义注解通常都会指明两个元注解：Retention和Target

4. JDK的元注解

• JDK的元Annotation用于修饰其他Annotation定义（元注解：对现有的注解进行解释说明的注解）
• JDk5.0提供了4个标准的meta-annotation类型，分别是
  1. @Retention：指定所修饰的Annotation的生命周期
  2. @Target：用于指定被修饰的Annotation能用于修饰哪些程序元素
  3. @Document：用于指定被修饰的Annotation类将被javadoc工具提取成文档
  4. @Inherited：被它修饰的Annotation具有继承性

5. 利用反射获取注解信息

6. JDK8中注解的新特性

1. 可重复注解
   1. jdk8之前的写法：@MyAnnotations({@MyAnnotation(value="hi"),@MyAnnotation(value="hello")})
   2. jdk8新增的写法：
      ①在MyAnnotation上声明@Repeatable,成员值为MyAnnotations.class
      ②MyAnnotation的Retention和Target等元注解需要与MyAnnotations保持一致
2. 类型注解