这是我参与「第四届青训营 」笔记创作活动的的第3天

Java枚举类｜ 青训营笔记

枚举类

自定义枚举类

枚举类的使用

• 类的对象有限个且确定时
• 定义一组常量时
• 如果枚举类只有一个对象，那就是单例模式

如何定义枚举

/**
 * Created with IntelliJ IDEA.
 *
 * @Author: 谭铭豪
 * @Date: 2022/07/15/12:38
 * @Description:自定义枚举类
 * 1、声明属性用private final修饰
 * 2、私有化构造器，属性提供构造器初始化
 * 3、提供当前枚举类的多个对象
 * 4、提供其他述求
 */
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 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、提供其他述求
    @Override
    public String toString() {
        return "Season{" +
                "name='" + name + ''' +
                ", desc='" + desc + ''' +
                '}';
    }
}
​
public class SeasonTest {
    public static void main(String[] args) {
        Season spring = Season.SPRING;
        System.out.println(spring);
    }
}

使用关键字enum定义枚举类

/**
 * Created with IntelliJ IDEA.
 *
 * @Author: 谭铭豪
 * @Date: 2022/07/15/12:38
 * @Description:enum定义枚举类
 *
 */
enum Season1 {
    //1、直接定义一组常量，并用逗号隔开
    SPRING("春天","春天"),
    SUMMER("夏天","夏天"),
    AUTUMN("秋天","秋天"),
    WINTER("冬天","冬天");
    
    //2、、声明属性用private final修饰
    private final String name;
    private final String desc;
    
    // * 3、构造器，属性提供构造器初始化
    Season1(String name, String desc) {
        this.name = name;
        this.desc = desc;
    }
    
    // * 4、提供其他述求,一般不重写toString
//    @Override
//    public String toString() {
//        return "Season{" +
//                "name='" + name + ''' +
//                ", desc='" + desc + ''' +
//                '}';
//    }
}

Enum的主要方法

0. toString():返回对象名
1. values():返回对象数组
2. valuesOf(String str):返回对象名为str的对象

实现接口的枚举类

各个对象各自实现抽象方法即可

/**
 * Created with IntelliJ IDEA.
 *
 * @Author: 谭铭豪
 * @Date: 2022/07/15/15:16
 * @Description:enum实现接口中抽象方法
 */
interface Info{
    void show();//展示信息
}
enum Season1 implements Info {
    //各自实现show()
    SPRING("春天", "春天") {
        @Override
        public void show() {
            System.out.println("Spring");
        }
    },
    SUMMER("夏天", "夏天") {
        @Override
        public void show() {
            System.out.println("SUMMER");
        }
    },
    AUTUMN("秋天", "秋天") {
        @Override
        public void show() {
            System.out.println("AUTUMN");
        }
    },
    WINTER("冬天", "冬天") {
        @Override
        public void show() {
            System.out.println("WINTER");
        }
    };
​
    private final String name;
    private final String desc;
​
    Season1(String name, String desc) {
        this.name = name;
        this.desc = desc;
    }
}

注解Annotation

注解概述

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

常见Annotation示例

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

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

• @author 标明开发该类模块的作者，多个作者之间使用,分割

• @version 标明该类模块的版本 @see 参考转向，也就是相关主题

• @since 从哪个版本开始增加的 @param 对方法中某参数的说明，如果没有参数就不能写

• @return 对方法返回值的说明，如果方法的返回值类型是void就不能写

• @exception 对方法可能抛出的异常进行说明 ，如果方法没有用throws显式抛出的异常就不能写 其中

• @param @return 和 @exception 这三个标记都是只用于方法的。

  • @param的格式要求：@param 形参名 形参类型 形参说明
  • @return 的格式要求：@return 返回值类型 返回值说明
  • @exception的格式要求：@exception 异常类型 异常说明
  • @param和@exception可以并列多个

/**
 * Created with IntelliJ IDEA.
 *
 * @Author: 谭铭豪
 * @Date: 2022/07/15/18:12
 * @Description:文档类注解
 */

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

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

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

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

自定义Annotation

/**
 * Created with IntelliJ IDEA.
 *
 * @Author: 谭铭豪
 * @Date: 2022/07/16/9:29
 * @Description:自定义注解，参照@SuppressWarnings()
 * 1、关键字@interface
 * 2、定义内部成员，values
 * 3、指定成员默认值，default
 * 4、如果注解没有成员，就是标识作用
 */
public @interface MyAnnotation {
    String value() default "hello";
}
​
@MyAnnotation(value = "hi")
class Person{
    
}

JDK中的元注解

* @Description:JDK元注解：对注解使用的注解
* 1、@Retention():指定注解的生命周期：SOURCE/CLASS(默认行为)/RUNTIME，只有RUNTIME的注解才能在反射中被获取
* 2、@Target():指定注解可以使用的区域：例如TYPE:就指明该注解可以用在类上
* 3、@Document():指明注解能在javadoc中保留
* 4、@Inherited:指明该注解将会被使用类的子类继承

利用反射获取注解信息（在反射部分涉及）

/**
 * Created with IntelliJ IDEA.
 *
 * @Author: 谭铭豪
 * @Date: 2022/07/16/9:28
 * @Description:利用反射获取注解信息
 */
@MyAnnotation(value = "hi")
class Person{
​
}
public class AnnotationTest {
    public static void main(String[] args) {
        Class<Person> personClass = Person.class;
        for (Annotation annotation : personClass.getAnnotations()) {
            System.out.println(annotation);
        }
​
    }
}

JDK8中注解新特性

可重复注解

/**
 * Created with IntelliJ IDEA.
 *
 * @Author: 谭铭豪
 * @Date: 2022/07/16/10:28
 * @Description:注解数组
 */
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotations {
    MyAnnotation[] value();
}

/**
 * Created with IntelliJ IDEA.
 *
 * @Author: 谭铭豪
 * @Date: 2022/07/16/9:29
 * @Description:可重复注解
 * 1、@Repeatable(MyAnnotations.class)
 * 2、MyAnnotations.class是存储可重复注解的数组
 * 3、两个注解的Retention和Target必须一致
 */
@Repeatable(MyAnnotations.class)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {
    String value() default "hello";
}

类型注解

/**
 * Created with IntelliJ IDEA.
 *
 * @Author: 谭铭豪
 * @Date: 2022/07/16/9:29
 * @Description:类型注解，JDK8中@Targrt新增了两个常量
 * 1、 ElementType.TYPE_PARAMETER 表示该注解能写在类型变量的声明语句中（如：泛型声明）。
 * 2、 ElementType.TYPE_USE 表示该注解能写在使用类型的任何语句中。
 */
@Repeatable(MyAnnotations.class)
@Retention(RetentionPolicy.RUNTIME)
@Target({TYPE_PARAMETER,TYPE_USE})
public @interface MyAnnotation {
    String value() default "hello";
}

/**
 * Created with IntelliJ IDEA.
 *
 * @Author: 谭铭豪
 * @Date: 2022/07/16/9:28
 * @Description:JDK8后的注解使用位置
 */
class Generic<@MyAnnotation T>{
    public void show()throws @MyAnnotation RuntimeException{
        ArrayList<@MyAnnotation String> list = new ArrayList();
        int num=(@MyAnnotation int)10L;
    }
}