Java基础 - @interface(注解)

Java - volatile 及其四大特征线程的三大特性：原子性、有序性、可见性。volatile 是Java虚拟机提供轻量级的同步机制，遵循happen-before规则，解决线程可见性的问题，让一个线程对共享变量的修改能够及时让其它线程看到。对于一个volatile 变量的写操作先行发生于每个后续对该volatile变量的读操作。1、保证可见性操作的变量发生变化时，能够及时通知正在操作该值的

MrDJun

3469人浏览 · 2021-08-22 13:05:32

MrDJun · 2021-08-22 13:05:32 发布

注解是JDK5.0 引入的一种注释机制，核心包是 java.lang.annotation ，下面有一个 Annotation接口，是所有注解都默认继承的（Javap .class可以看到继承关系）。

提供一种为程序元素设置元数据的方法：

元数据是添加到程序元素如方法、字段、类和包.上的额外信息
注解是一种分散式的元数据设置方式, XML是集中式的设置方式
注解不能直接干扰程序代码的运行

注解的功能

作为特定的标记,用于告诉编译器一些信息
编译时动态处理,如动态生成代码
运行时动态处理,作为额外信息的载体,如获取注解信息

注解的分类

标准注解: Override、Deprecated、 SuppressWarnings
元注解: @Retention、@ Target、@Inherited、 @Documented
自定义注解

元注解

用于修饰注解的注解,通常用在注解的定义上

@Target :注解的作用目标

@Retention :注解的生命周期

@Documented :注解是否应当被包含在JavaDoc文档中

@Inherited: 是否允许子类继承该注解

元注解@Target

描述所修饰的注解的使用范围

packages、types( 类、接口、枚举、Annotation类型 )
类型成员(方法、构造方法、成员变量、枚举值)
方法参数和本地变量(如循环变量、catch参数 )

ElementType

public enum ElementType {
    ...
    /** 可作用于本地局部变量上 */
    LOCAL_VARIABLE,

    /** 可作用于注解上（元注解） */
    ANNOTATION_TYPE,
    
    /**
     * Type parameter declaration
     * 可作用于泛型类的实参上
     * 例如：public class Demo <@TypeParamterAnnotation T>{}
     * 在 Spring中的 @RequestParam 就是使用的该类型
     * @since 1.8
     */
    TYPE_PARAMETER,

    /**
     * Use of a type
     * 能作用在任何类型之上
     * @since 1.8
     */
    TYPE_USE
}

元注解@Retention

标注注解被保留时间的长短
用于定义注解的生命周期

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.ANNOTATION_TYPE)
public @interface Retention {
    RetentionPolicy value();
}

public enum RetentionPolicy {
    /**
     * 保留在源代码，不保留在编译后的字节码文件中
     * Annotations are to be discarded by the compiler.
     */
    SOURCE,

    /**
     * 字节码文件中也保留注解
     * Annotations are to be recorded in the class file by the compiler
     * but need not be retained by the VM at run time.  This is the default
     * behavior.
     */
    CLASS,

    /**
     * 在运行时保留注解，如Spring中的@Autowired，可以通过反射来获取
     * Annotations are to be recorded in the class file by the compiler and
     * retained by the VM at run time, so they may be read reflectively.
     *
     * @see java.lang.reflect.AnnotatedElement
     */
    RUNTIME
}

自定义注解

自定义注解不允许以类的形式实现或继承接口，属性的访问修饰符只能定义成public类型。

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-YgOTfbgJ-1629608709198)(.\images\自定义注解.png)]

创建一个注解，定义可作用于类、方法、字段上。

@Target({ElementType.TYPE, ElementType.FIELD, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
public @interface TestAnnotation {
    public String name();

    public String desc();

    public int age() default 18;

    public String[] language();
}

使用该注解：

@Data
@TestAnnotation(name = "用户bo", desc = "用户的实体类描述信息", language = {"Java", "C++", "Go"})
public class User {
    private Integer id;

    @TestAnnotation(name = "用户名", desc = "用户可用于登录认证的账号", language = "Java")
    private String username;
    private String password;
}

使用反射完成进行运行时动态处理：

在Class类中，Class类实现了AnnotatedElement 接口，提供了获取注解的一系列信息

public static void parseTypeAnnotation() throws ClassNotFoundException {
    Class clazz = Class.forName("com.demo.hello.entity.bo.User");
    // 获取类上的TestAnnotation注解
    Annotation[] annotations = clazz.getAnnotations();
    for (Annotation annotation : annotations) {
        TestAnnotation testAnnotation = (TestAnnotation) annotation;
        System.out.println(testAnnotation);
    }
    // 获取字段上的TestAnnotation注解
    Field[] fields = clazz.getDeclaredFields();
    for (Field field : fields) {
        // 获取字段上是否有TestAnnotation注解
        boolean present = field.isAnnotationPresent(TestAnnotation.class);
        if (present){
            TestAnnotation testAnnotation = field.getAnnotation(TestAnnotation.class);
            System.out.println(testAnnotation);
        }
    }
}