【JavaSE】十、枚举类&注解

枚举类

类的对象只有有限个，确定的

需要定义一组常量时，建议使用枚举类

定义枚举类

方式一：jdk5以前，自定义枚举类

		//1.声明Season对象的属性：private final修饰
    private final String seasonName;
    private final String seasonDesc;
    //2.私有化类的构造器，并给对象属性赋值
    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.其他诉求：获取枚举类对象的属性
    public String getSeasonDesc(){
        return seasonDesc;
    }

方式二：jdk5.0，可以用enum关键字定义枚举类

定义的枚举类默认继承java.lang.Enum类

enum Season1{
    //1.提供当前枚举类的对象，多个对象之间用','隔开，末尾对象用‘;’结束
    SPRING("春天","春暖花开"),
    SUMMER("夏天","夏日炎炎"),
    AUTUMN("秋天","秋高气爽"),
    WINTER("冬天","冰天雪地");
    private final String seasonName;
    private final String seasonDesc;

    private Season1(String seasonName, String seasonDesc) {
        this.seasonName = seasonName;
        this.seasonDesc = seasonDesc;
    }
}

Enum类中的常用方法

values()：返回枚举类型的对象数组

valueOf(String str)：可以把一个字符串转为对应的枚举类对象，要求字符串必须是枚举类对象的“名字”，否则会有异常

toString()：返回当前枚举类对象常量的名称

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

情况一：实现接口，在enum类中实现抽象方法

情况二：枚举类的对象分别实现接口中的抽象方法

interface Info{
    void show();
}
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("大约在冬季");
        }
    };
    private final String seasonName;
    private final String seasonDesc;

    private Season1(String seasonName, String seasonDesc) {
        this.seasonName = seasonName;
        this.seasonDesc = seasonDesc;
    }
}

注解（Annotation）

概述

JDK5.0后增加了对MetaData的支持，也就是注解。

Annotation是代码中的特殊标记，可在编译，类加载，运行时被读取并执行相应处理。使用它能让程序员不改变原有逻辑的情况下在源文件中嵌入一些补充信息。

可以修饰包、类、构造器、方法、成员变量、参数、局部变量的声明

被保存在Annotation中的”name=value”对中

JavaSE中：标记过时的功能，忽略警告等

JavaEE/Andriod中：配置应用程序的任何切面，代替EE旧版中遗留的繁冗代码和XML配置

框架 = 注解 + 反射 + 设计模式

常见Annotation

• 生成文档相关注解
  • @author：表明开发该类模块的作者，多个作者用’,’分割
  • @version：该类模块的版本
  • @see：参考转向，相关主题
  • @since：哪个版本开始增加的
  • @param：对方法中某参数的说明，无参数不能写
    • 只用于方法
    • @param 形参名 形参类型 形参说明
    • 可并列多个
  • @return：对方法返回值的说明，无返回值不能写
    • 只用于方法
    • @return 返回值类型 返回值说明
  • @exception：对方法可能抛出的异常的说明，若没有用throws显式抛出的异常就不能写
    • 只用于方法
    • @exception 异常类型 异常说明
    • 可并列多个
• 编译时进行格式检查JDK内置的三个基本注解
  • @Override：限定重写父类方法，该注解只能用于方法
  • @Deprecated：用于表示所修饰的元素（类，方法等）已过时。因为锁修饰的结构危险/存在更好的选择
  • @SuppressWarnings：抑制编译器警告

自定义Annotation

• 自定义注解自动继承了java.lang.annotation.Annotation接口
• Annotation的成员变量在定义中以无参数方法的形式声明。方法名和返回值定义了该成员的名字和类型。称为配置参数。类型只能是八种基本数据类型、String、Class、enum、Annotation、以上所有类型的数组
• 可在定义成员变量时使用default指定初始值
• 若只有一一个参数成员，建议使用参数名为value
• 若定义的注解有配置参数，使用时必须指定初始值，除非有默认值。格式：”参数名=参数值”，若只有一个参数成员且名称为value，可以省略”value=”
• 没有成员定义的Annotation成为标记，包含成员变量的Annotation称为元数据Annotation
• 自定义注解必须配上注释的信息处理流程【使用反射】才有意义
• 自定义注解通常指明Retention和Target两个元注解
• 如何定义
  • 注解声明为@interface
  • 内部定义成员，通常用value表示
  • 可以指定成员的默认值，用default定义
  • 自定义注解没有成员，起标识作用

public @interface MyAnnotation {
    String value() default "hello";
}
//使用时可以@MyAnnotation或@MyAnnotation(value="hi")

元注解

JDK的元Annotation用于修饰其他Annotation定义【修饰其他注解的注解】

JDK5.0提供了4个标准meta-annotation类型：

• Retention

  • 例：

  	@Retention(RetentionPolicy.SOURCE)
  

  • 只能修饰一个注解，指定注解的生命周期
  • 包含一个RetentionPolicy类型的成员变量，使用时必须为该value成员变量赋值

    • RetentionPolicy.SOURCE：

      在源文件中有效（源文件保留），编译器直接丢弃这种策略的注释

    • RetentionPolicy.CLASS【默认值】：

      在class文件中有效（class保留），运行Java程序时，JVM不会保留注释

    • RetentionPolicy.RUNTIME：

      在运行时有效（运行时保留），运行Java程序时，JVM保留注释。程序可通过反射获取该注释

• Target

  • 例：

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

  • 用于修饰注解定义，指定被修饰的注解能修饰哪些程序元素
  • 包含一个名为value的成员变量

  取值(ElementType)	用于修饰
  CONSTRUCTOR	描述构造器
  FIELD	描述域
  LOCAL_VARIABLE	描述局部变量
  METHOD	描述方法
  PACKAGE	描述包
  PARAMETER	描述参数
  TYPE	描述类、接口（包括注解类型）或enum声明

• Documented

  • 指定该元注解修饰的注解类将被javadoc工具提取成文档。默认情况下javadoc不包括注解
  • 定义为Documented的注解必须设置Retention值为RUNTIME

• Inherited

  • 被它修饰的注解将具有继承性，若某类使用了被Inherited修饰的注解，则其子类将自动具有该注解
  • 比如把@Inherited注解的自定义注解标注在类级别上，子类可以继承父类级别的注解

利用反射获取注解信息

JDK8注解新特性

• 可重复注解
  • 在MyAnnotation上声明@Repeatable，成员值为MyAnnotations.class
  • MyAnnotation的元注解需和My Annotations的相同
• 类型注解

  • ElementType.TYPE_PARAMETER：

    该注解能写在类型变量的声明语句中【如泛型声明】

  • ElementType.TYPE_USE：

    该注解能写在使用类型的任何语句中