【Java SE】枚举类和注解

1.枚举类的使用

当类的对象由有限个，确定的时候，我们称这种类为枚举类。当需要定义一组常量时，建议使用枚举类。而当枚举类中只有一个对象时，可以使用单例模式。

1.1 enmu关键字

省略private finnal以及new Season部分：

enum Season {
 SPRING("春天", "春暖花开"),
 SUMMER("夏天", "热");

private final String seasonName;
private final String seasonDesc;

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

public String getSeasonName() {
    return seasonName;
}

public String getSeasonDesc() {
    return seasonDesc;
}

public static Season getSPRING() {
    return SPRING;
}

public static void setSPRING(Season SPRING) {
    Season.SPRING = SPRING;
}
}

1.2 自定义枚举类

    private final String seasonName;
    private final String seasonDesc;

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

    public static Season SPRING = new Season("春天", "春暖花开");

    public String getSeasonName() {
        return seasonName;
    }

    public String getSeasonDesc() {
        return seasonDesc;
    }

    public static Season getSPRING() {
        return SPRING;
    }

    public static void setSPRING(Season SPRING) {
        Seasoon.SPRING = SPRING;
    }
}

1.4 Enum类的主要方法

values()	Season[] values = Season.values();查看类的所有枚举对象
valueOf(String objName)	返回对象名是objName的对象，如果没有则抛出IllegalArgumentException异常
toString()	返回当前枚举对象常量的名称

1.5 Enum关键字定义的枚举类实现接口

情况一：枚举类中实现接口中的抽象方法。

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

SPRING("春天", "春暖花开"){
        void show() {
            System.out.println("Spring");
        }
    },
    SUMMER("夏天", "热") {
        @Override
        public void show() {

        }
    };

2.注解 Annotation

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

示例一：


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

@ Override:限定重写

@ Deprecated:所修饰的元素(类、方法)已过时

@ SuppressWarnings:抑制编译器警告

如：SuppressWarnings("unused"), SuppressWarnings("rawtypes")

示例三：跟踪代码依赖性，实现替换配置文件功能

servlet3.0提供了注解，使得不需要在web.xml文件中进行servlet的部署。

自定义注解

@ interace 声明注解

public @interface  MyAnnotation {
    String value();
}
@goodsTest.MyAnnotation(value = "hello")
class Person {

} 

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

@goodsTest.MyAnnotation()
class Person {

}

内部使用成员只有一个时通常用value，可以指定成员的默认值，使用default定义。如果自定义注解没有成员，则表明注解只有标识作用。

jdk提供的元注解

修饰其他现有的Annotation注解进行解释说明的注解，需要加载注解的定义而不是声明处。

@Retention：用于指明Annotation的声明周期

@Retention(RetentionPolicy.RUNTIME)

包含一个RetentionPolicy类型的成员变量，使用Retention必须为该value指定值：

RetentionPolicy.SOURCE	源文件保留
RetentionPolicy.CLASS	class保留，不会加载到内存中
RetentionPolicy.RUNTIME	运行时保留，只有声明为RUNTIME生命周期的注解，才能通过反射获取。

@Target：用于指定被修饰的Annotation能修饰哪些元素

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

包含一个类型的成员变量，使用Retention必须为该value指定值：

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

@Documented：表示所修饰的注解被javadoc解析时会被保留到javadoc文档中，默认不保留。

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(value={CONSTRUCTOR, FIELD, LOCAL_VARIABLE, METHOD, PACKAGE, PARAMETER, TYPE})
public @interface Deprecated {
}

@Inherited：被修饰过的Annotation具有继承性。

3.jdk8注解的新特性

3.1 可重复注解

jdk8之前的写法：

public @interface MyAnnotation {
    String value() default "hello";
}
public @interface MyAnnotations {
    MyAnnotation[] value();
}
@MyAnnotations({@MyAnnotation(value = "hello"), @MyAnnotation(value = "hello")})

jdk8之后的写法：在MyAnnotation上声明@Repeatable,成员值为MyAnnotations.class。

@Repeatable(MyAnnotations.class)
public @interface MyAnnotation {
    String value();
}

3.2 类型注解

ElementType.TYPE_PARAMETER 该注解能写在类型变量的声明语句中（如泛型声明）。

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