枚举与注解（枚举可以重点看一下，注解还是比较简单的）

枚举与注解

1、枚举

（1）基本介绍

Java的枚举（Enumerations）被用来创建自己的数据类型，例如月份，星期，日志等。它是一种特殊的类，可以有自己的常量和方法。枚举提供了一种限制变量只能是预设的几个值之一的方式。枚举是一组常量的集合。

理解： 枚举是一种特殊的类，里面只包含一组有限的特定的对象。

（2）两种实现方式

自定义实现枚举：

实现步骤：
- 构造器私有化
- 本类内部创建一组对象
- 对外暴露对象（通过为对象加入public final static 修饰符）
- 可以提供get方法，但是不能提供set方法
注意事项：
1. 枚举对象名通常使用全部大写，常量的命名规范。
2. 枚举对象根据需要，也可以有多个属性

举例：

/演示自定义枚举
class Season{
    private String name;
    private String desc;//描述

    //定义四个对象
    public final static Season SPRING = new Season("春天", "温暖");
    public final static Season SUMMER = new Season("夏天", "炎热");
    public final static Season AUTUMN = new Season("秋天","凉爽");
    public final static Season WINTER = new Season("冬天","寒冷");

    //1、将构造器私有化，防止直接new
    //2、去掉SetXXX方法，防止属性被修改
    //3、在Seaon内部，直接创建固定的对象。
    //4、可以加入final修饰符，进行优化
    private Season(String name, String desc) {
        this.name = name;
        this.desc = desc;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

使用enum关键字实现枚举

实现步骤：

换成枚举类，用enum替换class,默认是继承Enum 类，而且还是一个final 类,所以不能继续继承其他类，但是可以实现一些接口。
定义常量名，定义方式为常量名（参数列表），必须写在前面
有多个对象，需要使用逗号，进行间隔
枚举对象必须放在枚举类的首行
如果使用无参构造器创建枚举对象，则实参列表和小括号都可以省略。

举例：

//演示枚举关键字实现
enum Season2{
    SPRING("春天", "温暖"),SUMMER("夏天", "炎热"), AUTUMN("秋天","凉爽"),WINTER("冬天","寒冷");
    private String name;
    private String desc;//描述
    //1、将class 用enum替换
    //2、定义常量名，定义方式为常量名（参数列表），必须写在前面
    //3、有多个对象，需要使用逗号，进行间隔
    //4、如果是无参构造器，直接可以省略括号。

    private Season2(String name, String desc) {
        this.name = name;
        this.desc = desc;
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
}

（3）枚举类的常用方法说明

1. values()

此方法返回枚举类中所有值的数组，数组中的值的顺序与它们在enum中声明的顺序相同。

Day[] days = Day.values();
for (Day day: days) {
    System.out.println(day);

在此例中，将输出：

SUNDAY
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY

valueOf(String s)

这个方法返回指定名称的枚举常量，该名称必须与在此类型中声明的枚举常量标识符完全匹配。如果找不到匹配的常量，将抛出IllegalArgumentException

Day day = Day.valueOf("MONDAY");
System.out.println(day);

在此例中，将输出

MONDAY

ordinal()

该方法返回枚举常量的序数（在枚举声明中的位置，序数值从零开始）。

Day day = Day.MONDAY;
System.out.println(day.ordinal())

在此例中，将输出：

compareTo(E o)

跟所有实现Java Comparable 接口的类一样，枚举的此方法会比较枚举与指定对象的顺序。返回的是一个负整数、零，或一个正整数，这取决于此枚举常量是小于、等于还是大于指定的对象。

name() 和 toString()

name() 方法返回此枚举常量的名称，与它的枚举声明中的名称完全相同。toString() 方法返回枚举常量的名称，它在Object类中被覆盖。

2、注解（Annotation）

（1）基本介绍

注解（Annotation）又被称为元数据（Metadata），用于修饰包、类、方法、属性、构造器、局部变量等数据信息。和注释一样，注解不影响程序逻辑，但是注解可以被编译和运行，相当于嵌入在代码中的补充信息。

注解本身是没有作用的，仅仅起到标识的作用，通常我们使用注解可以包含一些元信息，例如配置信息、函数签名、要执行的静态代码等。

在JavaSE中，注解使用比较简单，主要包括标记过时的功能，忽略警告等，在JavaEE中担任更重要的角色，配置应用程序的任何切面，代替Java EE旧版中繁冗的代码的XML配置。

（1）@Override

限定某个方法，重写父类的方法，该注解只能用于方法

举例：

class Father{
    public void fly(){
        System.out.println("父类的飞");
    }
}
class Son extends Father{
    //重写父类的方法，不写也会重写
    // 但是写了Override注解，编译器就会去检查是否真的重写
    //如果的确重写了，编译器通过，如果没有重写，就会编译错误
    /* 如果发现了一个@interface，说明是一个注解类
    源码：
        @Target({ElementType.METHOD})  //说明只能修饰方法
        @Retention(RetentionPolicy.SOURCE)
        public @interface Override
     */
    @Override
    public void fly() {
        System.out.println("子类重写了父类的方法");
    }
}

注意事项：

@Override只能修饰方法，不能修饰其他类、包、属性等等
@Target 是修饰注解的注解，称为元注解

（2） @Deprecated

用于表示某个程序元素（类，方法等）已经过时

举例：

//表示某个元素已经过时了，不推荐使用，但是仍然可以使用
//可以修饰方法，类，字段，包，参数，等等
//可以用来版本升级兼容过渡使用
/*源码
@Documented 
@Retention(RetentionPolicy.RUNTIME) 
@Target({ElementType.CONSTRUCTOR,ElementType.FIELD,ElementType.LOCAL_VARIABLE,ElementType.METHOD,ElementType.PACKAGE,ElementType.PARAMETER,ElementType.TYPE}) 
 */
@Deprecated
class A{
    public int n1 = 10;
    public void hi(){
    }
}

注意事项：

可以修饰方法，类，字段，包，参数，等等
@Deprecated可以用来新旧版本的兼容与过渡

（3）@SuppressWarning

抑制编译器的警告

举例：

public class SuppressWarnings_ {
    @SuppressWarnings("all")
    public static void main(String[] args) {
        //1、不希望看到警告信息，可以加入SuppressWarning注解抑制警告信息
        //2、在{""}中，可以写入你希望抑制（不显示）的警告信息
        //3、可以指定很多警告类型
        /*源码
        @Target({ElementType.TYPE,ElementType.FIELD,ElementType.METHOD,ElementType.PARAMETER,ElementType.CONSTRUCTOR,ElementType.LOCAL_VARIABLE})
        @Retention(RetentionPolicy.SOURCE)
        public @interface SuppressWarnings
         */
        @SuppressWarnings({"unused", "rawtypes"})
        List list = new ArrayList();
        list.add("jack");
        int i = 1;
        System.out.println(list.get(i));
    }
}

（4）元注解（了解即可）

注解的注解。本身作用不大，在看源码是，可以知道这个是干啥的

元注解的种类：

Retention 指定注解的范围，三种（SOURCE、CLASS、RUNTIME）
Target 指定注解在哪些地方使用（TYPE、FIELD、METHOD等等）
Documented 指定注解是否会在javadoc中体现
Inherited 子类会继承父类的注解

Phil_jida