class Season{

    //1.声明private final修饰的属性

    private final String name;

    private final String desc;

    //2.私有化类的构造器

    private Season(String name, String desc){

        this.name = name;

        this.desc = desc;

    }

    //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 WINTER = new Season("冬","白雪皑皑");

    //4.如果需要，获取枚举类的属性(get/set)，重写toString()方法等。

    public String toString() {

        return name + ' '+ desc;

    }

}



//使用

Season autumn = Season.AUTUMN;

System.out.println(autumn);

方式二：jdk5.0时，可以使用enum关键字定义

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

enum Season1{

    //1.提供当前枚举类的多个对象, 对象之间用","隔开, 末尾用";"结束

    SPRING("春","春暖花开"),

    SUMMER("夏","夏日炎炎"),

    AUTUMN("秋","秋高气爽"),

    WINTER("冬","白雪皑皑");

    //2.声明private final修饰的属性

    private final String name;

    private final String desc;

    //3.私有化类的构造器

    private Season1(String name, String desc){

        this.name = name;

        this.desc = desc;

    }

    //4.写其他需求

}

3 enum常用方法

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

4 使用enum定义的枚举类实现接口

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

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

SPRING("春","春暖花开"){

    @Override

    public void show() {

    }

},

SUMMER("夏","夏日炎炎"){

    @Override

    public void show() {

    }

},

...

10.2 注解

1 概述

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

2 常见示例

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

@author @version @see@since @param @return @exception

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

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

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

Servlet3.0提供了注解(annotation),使得不再需要在web.xml文件中进行Servlet的部署。

spring框架中关于“事务”的管理

3 如何自定义注解

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

public @interface MyAnnocation {

    String value();

    //String value() default "hello"; //或者可以指定默认值

}



//使用

@MyAnnocation(value="hi")  //如果有默认值，括号内可以不写

//语句

4 jdk提供的4种元注解

元注解：对现有注解进行修饰的注解

Retention：指定该 Annotation 的生命周期成员变量：RetentionPolicy
RetentionPolicy.SOURCE：在源文件中有效（即源文件保留）。编译器直接丢弃这种策略的注释
RetentionPolicy.CLASS：在class文件中有效（即class保留）。这是默认行为
RetentionPolicy.RUNTIME：在运行时有效（即运行时保留）。程序可以通过反射获取该注释

@Retention(RetentionPolicy.RUNTIME)

public @interface MyAnnocation {

String value();

}

Target：指定被修饰的 Annotation 能用于修饰哪些程序元素。成员变量：value
- TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE, ANNOTATION_TYPE, PACKAGE, TYPE_PARAMETER, TYPE_USE
Documented：用于指定被该元 Annotation 修饰的 Annotation 类将被javadoc 工具提取成文档。默认情况下，javadoc是不包括注解的。
Inherited：被它修饰的 Annotation 将具有继承性。

5 通过反射获取注解信息

见反射章节

6 jdk8中注解新特性

可重复注解：
- 在MyAnnocation上声明Repeatable，成员值为MyAnnocations.class
- MyAnnocation的Target和Retention等与MyAnnocations相同。

@Repeatable(MyAnnocations.class)

public @interface MyAnnocation {

    String value();

}



public @interface MyAnnocations {

    MyAnnocation[] value();

}



@MyAnnocation("hello")

@MyAnnocation("hi")

//要注解的内容

类型注解：JDK1.8之后，关于元注解@Target的参数类型ElementType枚举值多了两个：
- ElementType.TYPE_PARAMETER 表示该注解能写在类型变量的声明语句中（如：泛型声明）。
- ElementType.TYPE_USE 表示该注解能写在使用类型的任何语句中。

码农公寓

10.1 枚举类的使用

1 介绍

2 定义枚举类