枚举类和注解

枚举类的使用

类的对象只有有限个，确定的。我们称此类为枚举类，举例如下：

●星期：星期一、.....星期天。

●季节:春夏秋冬

●性别：男、女

●线程状态：创建、就绪、运行、阻塞、死亡

............

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

如何定义枚举类

●枚举类的属性

枚举类对象的属性不应允许被改动，所以应该使用private final修饰

枚举类使用private final修饰的属性应该在构造器中为其赋值

若枚举类显式的定义了带参的构造器，则在列出枚举值时也必须对应的传入参数

方式一：jdk5.0之前，自定义枚举类

示例代码

//自定义枚举类
class Season{
    //1.声明Season对象的属性：private final修饰
    private final String seasonName;
    private final String seasonDesc;
​
    //2.私有化类的构造器,并给对象属性赋值
    private Season(String seasonName,String seasonDesc) {
        this.seasonDesc=seasonDesc;
        this.seasonName=seasonName;
    }
​
    //3.提供当前枚举类的多个对象,声明为 public static final
    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 WINDER=new Season("冬天","冰天雪地");
​
    //其他诉求1.获取枚举类对象的属性
    public String getSeasonName() {
        return seasonName;
    }
​
    public String getSeasonDesc() {
        return seasonDesc;
    }
​
    //其他诉求2.提供toString
    @Override
    public String toString() {
        return "Season{" +
                "seasonName='" + seasonName + '\'' +
                ", seasonDesc='" + seasonDesc + '\'' +
                '}';
    }
}
方式二：jdk5.0，可以使用enum关键字来定义枚举类

enum Season{
    //提供当前枚举类的对象,多个对象之间用","隔开,末尾对象用";"结束
    SPRING("春天","春暖花开"),
    SUMMER("夏天","夏日炎炎"),
    AUTUMN("秋天","秋高气爽"),
    WINDER("冬天","冰天雪地");
    //1.声明Season对象的属性：private final修饰
    private final String seasonName;
    private final String seasonDesc;
​
    //2.私有化类的构造器,并给对象属性赋值
    private Season(String seasonName,String seasonDesc) {
        this.seasonDesc=seasonDesc;
        this.seasonName=seasonName;
    }
​
​
    //其他诉求1.获取枚举类对象的属性
    public String getSeasonName() {
        return seasonName;
    }
​
    public String getSeasonDesc() {
        return seasonDesc;
    }
}

注意：定义的枚举类默认继承与java.lang.Enum类

Enum类的主要方法

values():返回枚举类型的对象数组。该方法可以很方便的遍历所有的枚举值

valueOf(String str):返回枚举类中对象名是str的对象，如果没有此对象，则抛异常

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

情况一：实现接口，实现接口中的抽象方法

//接口
interface info{
    void show();
}
​
enum Season implements info{
​
    SPRING("春天","春暖花开"),
    SUMMER("夏天","夏日炎炎"),
    AUTUMN("秋天","秋高气爽"),
    WINDER("冬天","冰天雪地");
​
    private final String seasonName;
    private final String seasonDesc;
​
    private Season(String seasonName,String seasonDesc) {
        this.seasonDesc=seasonDesc;
        this.seasonName=seasonName;
    }
    //实现抽象方法
    @Override
    public void show() {
        System.out.println("季节");
    }
}

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

interface info{
    void show();
}
​
enum Season implements info{
    //提供当前枚举类的对象,多个对象之间用","隔开,末尾对象用";"结束
    SPRING("春天","春暖花开"){
        @Override
        public void show() {
            System.out.println("春季");
        }
    },
    SUMMER("夏天","夏日炎炎"){
        @Override
        public void show() {
            System.out.println("夏季");
        }
    },
​
    AUTUMN("秋天","秋高气爽"){
        @Override
        public void show() {
            System.out.println("秋季");
        }
    },
    WINDER("冬天","冰天雪地"){
        @Override
        public void show() {
            System.out.println("冬季");
        }
    };
    //1.声明Season对象的属性：private final修饰
    private final String seasonName;
    private final String seasonDesc;
​
    //2.私有化类的构造器,并给对象属性赋值
    private Season(String seasonName,String seasonDesc) {
        this.seasonDesc=seasonDesc;
        this.seasonName=seasonName;
    }
}

注解（Annotation）概述

●从 JDK5.0开始，Java增加了对元数据（MetaData）的支持，也就是Annotation（注解）

●Annotation其实就是代码里的特殊标记，这些标记可以在编译，类加载，运行时被读取，并进行相应的处理。通过Annotation，程序员可以在不改变原有逻辑的情况下，在源文件中嵌入运行补充信息。代码分析工具、开发工具和部署工具可以通过这些补充信息进行验证或者进行部署

●Annotation可以像修饰符一样被使用，可用于修饰包，类，构造器，方法，成员变量，参数，局部变量的声明。这些信息被保存在Annotation的“name=value”对中

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

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

示例一：生成文档相关的注解

@author:标明开发该类模块的作者，多个作者之间使用,分隔
@version：标明该类模块的版本
@see：参考转向，也就是相关主题
@since：从哪个版本开始增加的
@param：对方法中某参数的说明，如果没有参数就不能写
@return：对方法返回值的说明，如果方法的返回值是void就不能写
@exception：对方法可能抛出的异常进行说明，如果方法没有用throws显式抛出的异常就不能写
    其中
        @param @return @exception这三个标记都是只用于方法的
        @param的格式要求：@param 形参名 形参类型 形参说明
        @return的格式要求：@return 返回值类型 返回值说明
        @exception格式要求：@exception 异常类型 异常说明
        @param和@exception可以并列多个

示例二：在编译时进行格式检查（JDK内置的三个基本注解）

@Override:限定重写父类方法，该注解只能用于方法
@Deprecated：用于表示所修饰的元素（类，方法）已过时。通常是因为所修饰的结构危险或存在更好的选择
@SuppressWarnings：抑制编译器警告    

如何自定义注解

●1.注解声明为：@interface

●2.内部定义成员，通常使用value表示

●3.可以指定成员的默认值，使用default定义

●4.如果自定义注解没有成员，表明是一个标识作用

示例代码

package Demo;
​
public @interface MyAnnotation {
    String value() default "hello";
}

如果注解有成员，在使用注解时，需要指明成员的值

自定义注解必须配上注解的信息处理流程（使用反射）才有意义。

自定义注解通常都会指明两个元注解：@Retention、@Target

JDK中的元注解

元注解：对现有的注解进行解释说明的注解

●JDK的元Annotation用于修饰其他的Annotation定义

●JDK5.0提供了4个标准的meta-annotation类型，分别是：

●@Retention：只能用于修饰一个Annotation定义，同于指定该Annotation的生命周期，@Retention包含一个RetentionPolicy类型的成员变量，使用@Retention时必须为该value成员变量指定值：

RetentionPolicy.SOURCE:在源文件中有效（即源文件保留），编译器直接丢弃这种策略的注释
RetentionPolicy.CLASS:在class文件中有效（即class保留），当运行java程序时，JVM不会保留注释，这是默认值
RetentionPolicy.RUNTIME:在运行时有效（即运行时保留），当运行java程序时，保留注释。程序可以通过反射获取该注释 

●@Target：用于修饰Annotation定义，用于指定被修饰的Annotation能用于修饰哪些程序元素。@Target也包含一个名为value的成员变量。

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

●@Documented：用于指定被该元Annotation修饰的Annotation类将被javadoc工具提取成文档。默认情况下，Javadoc是不包括注解的

定义为Documented的注解必须设置Retention值为RUNTIMEE

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