Java基础---枚举和注解

枚举

创建season对象有如下特点

季节的值是有限的几个值
只读，不需要修改

package com.lyn.enum_;

/**
 * @author L.yn
 * @version 1.0
 * @date 2021/12/28 20:22
 */
public class Enumeration01 {
    public static void main(String[] args) {
        //使用
        Season spring = new Season("春天", "温暖");
        Season winter = new Season("冬天", "寒冷");
        Season summer = new Season("夏天", "炎热");
        Season autumn = new Season("秋天", "凉爽");
        //因为对于季节而言，他的对象（具体值），是固定的四个，不会有更多
        //设计类的思路，不能体现季节是固定的四个对象
        //因此这样的设计不好======>枚举类【即把具体的对象一个一个的列举出来的类，就称为枚举类】
        Season other = new Season("....", "....");
    }
}

class Season {
    private String name;
    private String desc;

    public Season(String name, String desc) {
        this.name = name;
        this.desc = desc;
    }

    public String getName() {
        return name;
    }

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

    public String getDesc() {
        return desc;
    }

    public void setDesc(String desc) {
        this.desc = desc;
    }
}

解决方案--枚举
- 枚举对应英文：enumeration，简称 enum
- 枚举是一组常量的集合
- 可以这里理解：枚举属于一种特殊的类，里面只包含一组有限的特定的对象

枚举的二种实现方式

字定义实现枚举

不需要提供setXxx方法，因为枚举对象值通常为只读
对枚举对象/属性使用final+static共同修饰，实现底层优化
枚举对象名通常使用全部大写，常量的命名规范
枚举对象根据需要，也可以有多个属性

package com.lyn.enum_;

/**
 * @author L.yn
 * @version 1.0
 * @date 2021/12/28 20:32
 */
public class Enumeration02 {
    public static void main(String[] args) {
        System.out.println(Season.SPRING);
    }
}


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

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

    //一、将构造器私有化，目的防止直接new
    //二、去掉set方法，防止属性被修改
    //三、在season内部直接创建固定的对象
    //四、优化。可以加入final修饰符
    private Season(String name, String desc) {
        this.name = name;
        this.desc = desc;
    }

    public String getName() {
        return name;
    }

    public String getDesc() {
        return desc;
    }

    @Override
    public String toString() {
        return name + " " + desc;
    }
}

使用enum关键字实现枚举

package com.lyn.enum_;

/**
 * @author L.yn
 * @version 1.0
 * @date 2021/12/28 20:39
 */
public class Enumeration03 {
    public static void main(String[] args) {
        System.out.println(Season2.AUTUMN);
    }
}

//演示使用enum关键字实现枚举
enum Season2 {


    //如果使用了enum来实现枚举类
    //一、使用关键字enum代替class
    //二、public final static Season SPRING = new Season("春天", "温暖");直接使用SPRING("春天","温暖")代替
    //解读：常量名（实参列表【跟构造器对应】）
    //三、如果有多个，用,好间隔即可
    //四、如果使用enum来实现枚举，要求将定义常量对象，写在前面
    SPRING("春天", "温暖"),

    WINTER("冬天", "寒冷"),

    SUMMER("夏天", "炎热"),

    AUTUMN("秋天", "凉爽");

    private String name;
    private String desc;

    private Season2(String name, String desc) {
        this.name = name;
        this.desc = desc;
    }

    public String getName() {
        return name;
    }

    public String getDesc() {
        return desc;
    }

    @Override
    public String toString() {
        return name + " " + desc;
    }
}

enum关键字实现枚举注意事项
1. 当我们使用enum关键字开发一个枚举类时，默认会继承enum类
  1. $[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-fj3oeSzK-1640781803202)(C:\Users\MSI-NB\AppData\Roaming\Typora\typora-user-images\image-20211229181207907.png)]$
2. 传统的public final static Season SPRING = new Season("春天", "温暖");简化成SPRING("春天","温暖")，这里必须知道，它调用的是哪个构造器
3. 如果使用无参构造器创建枚举对象，则实参列表和小括号都可以省略
4. 当有多个枚举对象时，使用,号间隔，最后一个分号结尾
5. 枚举对象必须放在枚举类的行首

enum常用方法说明

使用关键字enum时，会隐式继承Enum类，这样我们就可以使用enum类相关的方法

方法名	详细描述
valueOf	传递枚举类型的class对象和枚举常量名称给静态方法valueOf，会的到与参数匹配的枚举常量
toString	得到当前枚举常量的名称。你可以通过重写这个方法来使得到的结果更易读
equals	在枚举类型中可以直接使用“==”来比较两个枚举常量是否相等，enum提供的这个equals方法，也是直接使用“==”实现的。它的存在时为了在set、list和map中使用，注意：equals是不可变得
hashcode	enum实现了hashcode来和equals保持一致，他也是不可变得
getDeclaringClass	得到枚举常量所属枚举类型得class对象，可以用它来判断两个枚举常量是否属于同一个枚举类型
name	得到当前枚举常量得名称，建议优先使用toString
ordinal	得到当前枚举常量得次序
compareTo	枚举类型实现了comparable接口，这样可以比较两个枚举常量得大小
clone	枚举类型不能被clone，为了防止子类实现克隆方法，enum实现了一个仅判处cloneNotSupportedException异常得不变clone

使用enum关键字后，就不能继承其他类了，因为enum会隐式继承Enum，而java是单继承机制
枚举类和普通类一样，可以实现接口，如下定义
- enum 类名 implements 接口1，接口2{}

注解

注解也被称为元数据，用于修饰解释包、类、方法、属性、构造器、局部变量等数据信息
和注释一样，注解不影响程序逻辑，但注解可以被编译或运行，相当于嵌入在代码中得补充信息
在javase中，注解得使用目的比较简单，例如标记过时得功能，忽略警告等等，在javaee中注解占据了更重要得角色，例如用来配置应用程序得任何切面，代替javaee旧版中所遗留得繁冗代码和xml配置等

基本得Annotation介绍

使用Annotation时要在其前面增加@符号，并把该Annotation当成一个修饰符使用，用于修饰它支持得程序元素

三个基本得Annotation
- @Override:限定某个方法，是重写父类方法，该注解只能用于方法
  - override说明
    - @Override表示指定重写父类的方法（从编译层面验证），如果父类没有fly方法，则会报错
    - 如果不写@Override注解，而父类仍有fly方法，仍然构成重写
    - @Override只能修饰方法，不能修饰其他类，包，属性等
    - 查看@Override注解源码为@Target(ElementType.METHOD)，说明只能修饰方法
    - @Target是修饰注解的注解，称为元注解
- @Deprecated:用于表示某个程序元素（类、方法等）已过时
  - 修饰某个元素已经过时，即不推介使用，但仍然能够使用
- @SuppressWarnings：抑制编译器警告
  - 说明各种值
    - unchecked是忽略没有检查的警告
    - rawtypes是忽略没有指定泛型的警告
    - unused是忽略没有使用某个变量的警告错误
    - @SupperssWarnings可以修饰的程序元素为，查看@Target
    - 生成@SupperssWarnings时，不用背，直接点击左侧的换色提示，就可以选择（注意可以指定生成的位置）
- 补充说明：@interface得说明
  - @interface不是interface，是注解类是jdk1.5之后加入得
  - ```
  @Target(ElementType.METHOD)
  @Retention(RetentionPolicy.SOURCE)
  public @interface Override {
  }
```
元注解的基本介绍
- JDK的元Annotation用于修饰其他Annotation
  - 元注解：本身作用不大
- 元注解的种类（使用不多，了解，不用深入研究）
  - Retention：指定直接的作用范围：三种：SOURCE CLASS RUNTIME
    - 说明：只能用于修饰一个Annotation定义，用于指定该Annotation可以保留多长时间 @Retention包含一个RetentionPolicy类型的成员变量，使用@Retention时必须为该value成员变量指定值
    - @Retention的三种值
      - SOURCE：编译器使用后，直接丢弃这种策略的注释
      - CLASS：编译器将把注释记录在class文件中，当运行java程序时，JVM不会保留注解，这是默认值
      - RUNTIME：编译器将把记录在class文件中，当运行java程序时，JVM会保留注释，程序可以通过反射获取该注释
  - Target：指定注解可以在哪些地方使用
  - Documented：指定该注解是否会在javadoc体现
  - Inherited：子类会继承父类注解