枚举类和注解的基础知识概述

枚举类和注解

10-1 枚举类的使用

一、定义

枚举类就是对象的数量是有限的、确定的，

• 当需要定义一组常量时，强烈建议使用枚举类

二、定义枚举类的方法

有两种方式，

自定义枚举类

用enum关键字定义枚举类

三、枚举类的规范

若枚举只有一个对象, 则可以作为一种单例模式的实现方 式。

枚举类对象的属性不应允许被改动, 所以应该使用 private final 修饰

枚举类的使用 private final 修饰的属性应该在构造器中为其赋值

若枚举类显式的定义了带参数的构造器, 则在列出枚举值时也必须对应的 传入参

下面是一个例子：

四、方式一：自定义的枚举类

public class SeasonTest {

    public static void main(String[] args) {
        Season spring = Season.SPRING;
        System.out.println(spring);

    }

}
//自定义枚举类
class Season{
    //1.声明Season对象的属性: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;
    }
    //4.其他诉求1：提供toString()
    @Override
    public String toString() {
        return "Season{" +
                "seasonName='" + seasonName + '\'' +
                ", seasonDesc='" + seasonDesc + '\'' +
                '}';
    }
}

五、方式二：使用enum定义枚举类

规范：

使用 enum 定义的枚举类默认继承了 java.lang.Enum类，因此不能再继承其他类

枚举类的构造器只能使用 private 权限修饰符

枚举类的所有实例必须在枚举类中显式列出(, 分隔 ; 结尾)。列出的 实例系统会自动添加 public static final 修饰 必须在枚举类的第一行声明枚举类对象

//使用enum关键字枚举类
enum Season1 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;

    //2.私有化类的构造器,并给对象属性赋值

    private Season1(String seasonName,String seasonDesc){
        this.seasonName = seasonName;
        this.seasonDesc = seasonDesc;
    }

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

    public String getSeasonDesc() {
        return seasonDesc;
    }

枚举类自带的方法;

 values()方法：返回枚举类型的对象数组。该方法可以很方便地遍历所有的 枚举值。

 valueOf(String str)：可以把一个字符串转为对应的枚举类对象。要求字符 串必须是枚举类对象的“名字”。如不是，会有运行时异常： IllegalArgumentException。

 toString()：返回当前枚举类对象常量的名称

枚举类可以实现接口：

若需要每个枚举值在调用实现的接口方法呈现出不同的行为方式, 则可以让每个枚举值分别来实现该方法

例如上面的例子，就是自定义了一个接口info

然后让不同的枚举值都自己分别实现了不同逻辑的show方法。

10-2注解

一、定义

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

代 码分析工具、开发工具和部署工具可以通过这些补充信息进行验证 或者进行部署。

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

二、示例

示例一：解释文档用到的注解

package com.annotation.javadoc;
/**
* @author shkstart
* @version 1.0
* @see Math.java
*/
public class JavadocTest {
/**
* 程序的主方法，程序的入口
* @param args String[] 命令行参数
*/
public static void main(String[] args) {
}
/**
* 求圆面积的方法
* @param radius double 半径值
* @return double 圆的面积
*/
public static double getArea(double radius){
return Math.PI * radius * radius;
}
}

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

@Override: 限定重写父类方法, 该注解只能用于方法

@Deprecated: 用于表示所修饰的元素(类, 方法等)已过时。通常是因为所修饰的结构危险或存在更好的选择

@SuppressWarnings: 抑制编译器警告

package com.annotation.javadoc;
public class AnnotationTest{
public static void main(String[] args) {
@SuppressWarnings("unused")
int a = 10;
}
@Deprecated
public void print(){
System.out.println("过时的方法");
}
@Override
public String toString() {
return "重写的toString方法()";
}
}

示例三：跟踪代码依赖性，替代配置文件的作用

很重要的一个功能，就是实现配置文件的功能

三、自定义注解

注解是与类、接口并列的结构，要自己创建，然后用@interface修饰。

public @interface MyAnnotation {

    String value() default "hello";
}

但是自定义的注解一般没什么用，要配上信息处理流程才有意义。

四、元注解

元注解：用来修饰其他注解的注解

JDK5.0提供了4个标准的meta-annotation类型，分别是：

Retention

Target

Documented

Inherited

1.@Retention ：用于指定该注解的生命周期

使用 @Rentention 时必须为该 value 成员变量指定值:

RetentionPolicy.SOURCE:在源文件中有效（即源文件保留），编译器直接丢弃这种策略的 注释 RetentionPolicy.CLASS:在class文件中有效（即class保留） ， 当运行 Java 程序时, JVM 不会保留注解。 这是默认值

RetentionPolicy.RUNTIME:在运行时有效（即运行时保留），当运行 Java 程序时, JVM 会 保留注释。程序可以通过反射获取该注释。

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-EaSKYP0W-1644413216181)(C:\Users\86198\AppData\Roaming\Typora\typora-user-images\image-20220209151253361.png)]

@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnnotation {

    String value() default "hello";
}

2.@Target

用于指定被修饰的 Annotation 能用于修饰哪些程序元素

@Target 也包含一个名为 value 的成员变量:

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-Bd1q198L-1644413216182)(C:\Users\86198\AppData\Roaming\Typora\typora-user-images\image-20220209151642456.png)]

3.其他的

@Documented: 用于指定被该元 Annotation 修饰的 Annotation 类将被 javadoc 工具提取成文档。默认情况下，javadoc是不包括注解的。 定义为Documented的注解必须设置Retention值为RUNTIME。

@Inherited: 被它修饰的 Annotation 将具有继承性。如果某个类使用了被 @Inherited 修饰的 Annotation, 则其子类将自动具有该注解。 比如：如果把标有@Inherited注解的自定义的注解标注在类级别上，子类则可以继承父类类级别的注解 实际应用中，使用较少

五、利用反射获取注解信息

当一个 Annotation 类型被定义为运行时 Annotation 后, 该注解才是运行时 可见, 当 class 文件被载入时保存在 class 文件中的 Annotation 才会被虚拟机读取

• 程序可以调用 AnnotatedElement对象的如下方法来访问 Annotation 信息

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-T9mnPgeE-1644413216182)(C:\Users\86198\AppData\Roaming\Typora\typora-user-images\image-20220209211134977.png)]

六、JDK8中注解的新特性

Java 8对注解处理提供了两点改进：可重复的注解

以及可用于类型的注解。

1.可重复注解

意思就是，这种注解可以重复使用。

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-Z88R0Dxu-1644413216182)(C:\Users\86198\AppData\Roaming\Typora\typora-user-images\image-20220209212044383.png)]

至于如何自定义可重复注解的，就不叙述了

2.可用于类型的注解