枚举类与注解（笔记）

十.枚举类与注解

（1）枚举类的理解

1.枚举类的理解：当一个类的对象是有限个，确定的。我们称此类为枚举类
2.当需要定义一组常量时，强烈建议使用枚举类
3.如果枚举类中只有一个对象，则可以作为单例模式的实现方式

（2）定义枚举类

方式一：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 WINTER = new Season("冬天","冰天雪地");

    //4.其他诉求1：获取当前枚举类对象的属性（只能生成get方法）
    public String getSeasonName() {
        return seasonName;
    }

    public String getSeasonDesc() {
        return seasonDesc;
    }


    //4.其他诉求2：提供toString()
    @Override
    public String toString() {
        return "Season{" +
                "seasonName='" + seasonName + '\'' +
                ", seasonDesc='" + seasonDesc + '\'' +
                '}';
    }
}

方式二：JDK5.0时，可以使用enum关键字定义枚举类

/**
 * 使用enum关键字来定义枚举类
 * 说明：定义的枚举类默认继承于java.lang.Enum
 * 
 * 
 * @author: ccw
 * @date: 2022/4/28 21:03
 */
public class SeasonTest1 {
    public static void main(String[] args){
        Season1 summer = Season1.SUMMER;
        System.out.println(summer);//Enum重写toString,输出对象名SUMMER
    }
    
}

//使用enum关键字来定义枚举类
enum Season1{
    //1.提供当前枚举类的对象，多个对象之间用逗号隔开，末尾的对象分号结束
    SPRING("春天","春暖花开"),
    SUMMER("夏天","夏日炎炎"),
    AUTUMN("秋天","秋高气爽"),
    WINTER("冬天","冰天雪地");

    //2.声明Season对象的属性：需要private和final来修饰
    private final String seasonName;
    private final String seasonDesc;

    //3.私有化类的构造器,并给对象属性赋值
    private Season1(String seasonName, String seasonDesc){
        this.seasonDesc=seasonDesc;
        this.seasonName=seasonName;
    }


    //4.其他诉求1：获取当前枚举类对象的属性（只能生成get方法）
    public String getSeasonName() {
        return seasonName;
    }

    public String getSeasonDesc() {
        return seasonDesc;
    }

}

（3）Enum类的主要方法

/**
 * Enum类的常用方法
 * values()方法:返回枚举类型的对象数组。该方法可以很方便地遍历所有的枚举值。
 * valueOf(String str):可以把一个字符串转为对应的枚举类对象。要求字符串必须是枚举类对象的“名字”。如不是，会有运行时异常
 * toString():返回当前枚举类对象常量的名称
 * 
 * @author: ccw
 * @date: 2022/4/28 22:23
 */
public class SeasonTest2 {
        public static void main(String[] args){
           Season2 summer = Season2.SUMMER;
            //toString方法
            System.out.println(summer.toString());//Enum重写toString,输出对象名SUMMER

            //values():
            Season2[] values = Season2.values();
            for(int i = 0;i < values.length;i++){
                System.out.println(values[i]);
        }

            //valueOf(String objName):返回枚举类中对象名是objName的对象。
            Season2 winter = Season2.valueOf("WINTER");
            System.out.println(winter);

        }

    //使用enum关键字来定义枚举类
    enum Season2{
        //1.提供当前枚举类的对象，多个对象之间用逗号隔开，末尾的对象分号结束
        SPRING("春天","春暖花开"),
        SUMMER("夏天","夏日炎炎"),
        AUTUMN("秋天","秋高气爽"),
        WINTER("冬天","冰天雪地");

        //2.声明Season对象的属性：需要private和final来修饰
        private final String seasonName;
        private final String seasonDesc;

        //3.私有化类的构造器,并给对象属性赋值
        private Season2(String seasonName, String seasonDesc){
            this.seasonDesc=seasonDesc;
            this.seasonName=seasonName;
        }


        //4.其他诉求1：获取当前枚举类对象的属性（只能生成get方法）
        public String getSeasonName() {
            return seasonName;
        }

        public String getSeasonDesc() {
            return seasonDesc;
        }

    }
}

（4）枚举类实现接口

/**
 * 使用enum关键字定义的枚举类实现接口的情况
 * 一：实现接口,在enum类中实现抽象方法
 * 二：让枚举类的对象分别实现接口中的抽象方法
 * 
 * 
 * @author: ccw
 * @date: 2022/4/28 22:38
 */
public class SeasonTest3 {
    public static void main(String[] args){
        Season3 winter = Season3.WINTER;
        winter.show();
    }
}

//定义接口
interface Info {
    void show();
}

enum Season3 implements Info{
    //1.提供当前枚举类的对象，多个对象之间用逗号隔开，末尾的对象分号结束
    SPRING("春天","春暖花开"){
        @Override
        public void show() {
            System.out.println("春天在哪里？");
        }
    },
    SUMMER("夏天","夏日炎炎"){
        @Override
        public void show() {
            System.out.println("宁夏");
        }
    },
    AUTUMN("秋天","秋高气爽"){
        @Override
        public void show() {
            System.out.println("秋天不回来");
        }
    },
    WINTER("冬天","冰天雪地"){
        @Override
        public void show() {
            System.out.println("大约在冬季");
        }
    };

    //2.声明Season对象的属性：需要private和final来修饰
    private final String seasonName;
    private final String seasonDesc;

    //3.私有化类的构造器,并给对象属性赋值
    private Season3(String seasonName, String seasonDesc){
        this.seasonDesc=seasonDesc;
        this.seasonName=seasonName;
    }


    //4.其他诉求1：获取当前枚举类对象的属性（只能生成get方法）
    public String getSeasonName() {
        return seasonName;
    }

    public String getSeasonDesc() {
        return seasonDesc;
    }

}

（5）注解（Annotation）概述

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

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

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

生成文档的相关注解

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

（6）自定义注解

如何自定义注解：

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

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