第十章：枚举类与注解

目录

10.1：枚举类的使用

        当需要定义一组常量时，建议使用枚举类（前提：类的对象只有有限个，确定的）

10.2：注解的使用(Annotation)

        10.2.1：注解概述

        10.2.2：注解的用法

---

10.1：枚举类的使用

        当需要定义一组常量时，建议使用枚举类（前提：类的对象只有有限个，确定的）

                eg：

                        星期：Mondey、.....、Sunday

                        性别：Man、.....、Woman

                        线程状态：创建、就绪、运行、阻塞、死亡

package com.jiayifeng.java;

/**
 * author 爱编程的小贾
 * create 2023-09-17 18:25
 *
 * 一：枚举类的使用
 *      1.理解：类的对象只有有限个，确定的，我们称此类为枚举类
 *      2.如果枚举类中只有一个对象，则可以作为单列设计模式的实现方法
 *
 * 二：如何定义枚举类？
 *      1.方式一：jdk5.0之前，自定义枚举类
 *      2.方式二：jdk5.0，可以使用enum关键字定义枚举类
 *
 * 三：Enum类中常用的方法：
 *      values()方法：返回枚举类的对象数组，该方法可以很方便的遍历所有的枚举值
 *      valueOf(String str)方法：可以把一个字符串转换为对应的枚举类对象。
 *      toString()：返回当前枚举类对象常量的名称
 *
 * 四：使用enum关键字定义的枚举类实现接口的情况
 *      情况一：实现接口，在enum类中实现抽象方法
 *      情况二：让枚举类的对象分别实现接口中的抽象方法
 */
public class SeasonTest {
    public static void main(String[] args) {
        Season spring = Season.SPRING;
//        toString()
        System.out.println(spring);//Season{seasonName='春天', seasonDesc='春暖花开'}
    }
}

//自定义枚举类
class Season{
//   1.声明对象的属性：private final修饰
    private final String seasonName;
    private final String seasonDesc;

//    2.私有化类的构造器,并给对象属性进行赋值(初始化)
    private Season(String seasonName,String seasonDesc){
        this.seasonName = seasonName;
        this.seasonDesc = seasonDesc;
    }

//    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：获取枚举类对象的属性
    public String getSeasonName() {
        return seasonName;
    }

    public String getSeasonDesc() {
        return seasonDesc;
    }

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

package com.jiayifeng.java;

/**
 * author 爱编程的小贾
 * create 2023-09-18 8:14
 *
 * 一：使用enum关键字定义枚举类
 *      1.说明：定义的枚举类默认继承java.lang.Enum类
 */
public class SeasonTest2 {
    public static void main(String[] args) {
        Season1 spring = Season1.SPRING;
//        toString()
        System.out.println(spring);//Season1{seasonName='春天', seasonDesc='春暖花开'}

        System.out.println(Season1.class.getSuperclass());//class java.lang.Enum
//        values()
        Season1[] values = Season1.values();
        for(int i = 0;i < values.length;i++) {
            System.out.println(values[i]);
            values[i].show();
        }
            /*
            Season1{seasonName='春天', seasonDesc='春暖花开'}
            春天在哪里？
            Season1{seasonName='夏天', seasonDesc='夏日炎炎'}
            夏天在哪里？
            Season1{seasonName='秋天', seasonDesc='秋高气爽'}
            秋天在哪里？
            Season1{seasonName='冬天', seasonDesc='冰天雪地'}
            冬天在哪里？
             */
        System.out.println("***************************");
        Thread.State[] values1 = Thread.State.values();
        for(int i = 0;i < values.length;i++){
            System.out.println(values1[i]);
            /*
            NEW
            RUNNABLE
            BLOCKED
            WAITING
             */
            System.out.println("************************");
//            valueOf(String objName)：返回枚举类中对象名是objName的对象
//            如果没有objName的枚举类对象，则抛异常：IllegalArgumentException
            Season1 winter = Season1.valueOf("WINTER");
            System.out.println(winter);//Season1{seasonName='冬天', seasonDesc='冰天雪地'}
//            winter.show();//这是一个季节
        }
    }
}

interface Info{
    void show();
}
//使用enum关键字定义枚举类
enum Season1 implements Info{
    //   1.提供当前枚举类的对象，多个对象之间用","隔开，末尾对象用";"结束
     SPRING("春天","春暖花开"){
         public void show(){
             System.out.println("春天在哪里？");
         }
    },
     SUMMER("夏天","夏日炎炎"){
         public void show(){
             System.out.println("夏天在哪里？");
         }
     },
     AUTUMN("秋天","秋高气爽"){
         public void show(){
             System.out.println("秋天在哪里？");
         }
     },
     WINTER("冬天","冰天雪地"){
         public void show(){
             System.out.println("冬天在哪里？");
         }
     };


    //   2.声明对象的属性：private final修饰
    private final String seasonName;
    private final String seasonDesc;

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


    //   4.其它诉求1：获取枚举类对象的属性
    public String getSeasonName() {
        return seasonName;
    }

    public String getSeasonDesc() {
        return seasonDesc;
    }

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


//    @Override
//    public void show() {
//        System.out.println("这是一个季节");
//    }
}

10.2：注解的使用(Annotation)

        10.2.1：注解概述

                从JDK 5.0开始，Java增加了对元数据(MetaData)的支持，也就是Annotation

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

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

                可以说：框架 = 注解 + 反射 + 设计模式

        10.2.2：注解的用法

package com.jiayifeng.java1;

/**
 * author 爱编程的小贾
 * create 2023-09-18 18:13
 *
 * 一：注解的使用
 *      1.理解Annotation
 *
 *      2.Annotation的使用示例
 *          示例一：生成文档相关的注解
 *          示例二：在编译时进行格式检查(JDK内置的三个基本注解)
 *                  @Override：限定重写父类方法，该注解只能用于方法
 *                  @Deprecated：用于表示所修饰的元素(类、方法等)已过时。通常是因为所修饰的结构危险或存在更好的选择
 *                  @SuppressWarnings：抑制编译器警告
 *          示例三：跟踪代码依赖性，实现替代配置文件功能
 *
 *      3.如何自定义注解：参照@SuppressWarnings定义
 *          ①注解声明为：@interface
 *          ②内部定义成员，通常使用value()表示
 *          ③可以指定成员的默认值，使用default定义
 *          ④如果自定义注解没有成员，表明是一个标识作用
 *          ⑤如果注解有成员，在使用注解时，需要指明成员的值
 *          ⑥自定义注解必须配上注解的信息处理流程(使用反射)才有意义
 *          ⑦自定义注解通常都会指明两个元注解：Retention、Target
 *
 *      4.jdk提供的四种元注解
 *          元注解：对现有的注解进行解释说明的注解
 *              Retention：指定所修饰的Annotation的声明周期：SOURCE\CLASS(默认行为)\RUNTIME
 *                  只有声明为RUNTIME生命周期的注解，才能通过反射获取
 *              Target：用于指定被修饰的Annotation能用于修饰哪些程序元素
 *              **********出现的频率较低********************
 *              Documented：表示所修饰的注解在被javadoc解析时，保留下来
 *              Interited：被它修饰的Annotation将具有继承性
 *
 *      5.jdk 8注解的新特性：可重复注解、类型注解
 */
public class AnnotationTest {
    public static void main(String[] args) {
        Person p1 = new Student();
        p1.walk();
    }
}

@MyAnnotation("hello")
class Person{
    private String name;
    private int age;

    public Person(){

    }

    public Person(String name, int age) {
        this.name = name;
        this.age = age;
    }

    public void walk(){
        System.out.println("人走路");
    }

    public void eat(){
        System.out.println("人吃饭");
    }
}

interface info{
    void show();
}

class Student extends Person implements info{
    @Override
    public void walk() {
        System.out.println("学生走路");
    }

    public void show(){

    }
}

package com.jiayifeng.java1;

import java.lang.annotation.*;

import static java.lang.annotation.ElementType.*;
import static java.lang.annotation.ElementType.LOCAL_VARIABLE;

/**
 * author 爱编程的小贾
 * create 2023-09-18 18:54
 */
@Inherited
@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE})
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
    String value();
}

package com.jiayifeng.java1;

import java.util.ArrayList;

/**
 * author 爱编程的小贾
 * create 2023-09-18 18:45
 */
public class AnnotationTest1 {
    public static void main(String[] args) {
        @SuppressWarnings("unused")
        int num = 10;

        @SuppressWarnings({"unused","rawtypes"})
        ArrayList list = new ArrayList();
    }
}