枚举类与注解

1. 枚举类

JDK1.5之前需要自定义枚举类；JDK 1.5 新增的 enum 关键字用于定义枚举类。对于枚举类的属性，有如下的要求：

1. 枚举类对象的属性不应允许被改动, 所以应该使用 private final 修饰
2. 枚举类的使用 private final 修饰的属性应该在构造器中为其赋值
3. 若枚举类显式的定义了带参数的构造器, 则在列出枚举值时也必须对应的传入参数

自定义枚举类

class Season {
    private final String seasonName;
    private final String seasonDesc;

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

    public final Season SPRING = new Season("春天","春暖花开");
    public final Season SUMMER = new Season("夏天","暑气蒸人");
    public final Season AUTUMN = new Season("秋天","秋高气爽");
    public final Season WINTER = new Season("冬天","银装素裹");
    
}

使用enum关键字定义枚举类

• 使用说明

1. 使用 enum 定义的枚举类默认继承了 java.lang.Enum类，因此不能再继承其他类。
2. 枚举类的构造器只能使用 private 权限修饰符
3. 枚举类的所有实例必须在枚举类中显式列出(, 分隔 ; 结尾)。列出的实例系统会自动添加 public static final 修饰
4. 必须在枚举类的第一行声明枚举类对象
5. JDK 1.5 中可以在 switch 表达式中使用Enum定义的枚举类的对象作为表达式, case 子句可以直接使用枚举值的名字, 无需添加枚举类作为限定。

enum Season {
    SPRING("春天", "春暖花开"),
    SUMMER("夏天", "暑气蒸人"),
    AUTUMN("秋天", "秋高气爽"),
    WINTER("冬天", "银装素裹");

    private final String seasonName;
    private final String seasonDesc;

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

}

Enum类常用的方法

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

public class Test {
    public static void main(String[] args)  {
        Season summer = Season.SUMMER;
        //toString:返回枚举类对象的名称
        System.out.println(summer.toString());

        //values():返回枚举类对象组成的数组
        Season[] seasons = Season.values();
        for (Season season : seasons) {
            System.out.println(season);
        }
        //valueOf(String obj):返回枚举类对象中名称为obj的枚举对象
        Season autumn = Season.valueOf("AUTUMN");
        System.out.println(autumn);
    }

}

enum Season {
    SPRING("春天", "春暖花开"),
    SUMMER("夏天", "暑气蒸人"),
    AUTUMN("秋天", "秋高气爽"),
    WINTER("冬天", "银装素裹");

    private final String seasonName;
    private final String seasonDesc;

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

}

2. 注解

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

注解示例：

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

自定义注解
① 注解声明为：@interface
② 内部定义成员，通常使用value表示
③ 可以指定成员的默认值，使用default定义
④ 如果自定义注解没成员，表明是一个标识作用。

public class StringTest {
    public static void main(String[] args)  {
        Class<Student> clazz = Student.class;
        Annotation[] annotations = clazz.getAnnotations();
        for (int i = 0; i < annotations.length; i++) {
            System.out.println(annotations[i]);
        }
    }

}
@MyAnnotation("This is a student class")
@MyAnnotation("Use this class ")
class Student{
    private int id;
    private String name;

    public Student(int id, String name) {
        this.id = id;
        this.name = name;
    }
}

@Inherited
@Retention(RetentionPolicy.RUNTIME)
@Repeatable(MyAnnotations.class)//重复使用的注解
@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE,TYPE_PARAMETER,TYPE_USE})
public @interface MyAnnotation {
    String value() default "hello";
}
@Inherited
@Retention(RetentionPolicy.RUNTIME)
@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE,TYPE_PARAMETER,TYPE_USE})
public @interface MyAnnotations {
    MyAnnotation[] value();
}

3. 元注解

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

• Retention
• Target
• Documented
• Inherited