理解Java注解原理:Annotation

野性酷女 2022-12-27 12:37 156阅读 0赞

Annotation注解

*  jdk1.5开始引入的新技术
 *  作用：不是程序本身，可以对程序作出解释，可以被其他程序读取，如编译器
 *  格式："@注释名"，可以添加参数值
    
    例如@SuppressWarnings(value=“unchecked”)
 *  使用：可以附加在package，class，method，field等上面，可相当于添加了额外的辅助信息，可以通过反射机制编程实现对这些元数据的访问

内置注解

1.  @Override：定义在java.lang.Override中，只适用于修辞方法，表示一个方法声明打算重写超类中的另一个方法声明
2.  @Deprecated：定义在java.lang.Deprecated中，可用于修辞方法，属性，类，不鼓励使用，因为它很危险或存在更好的选择
3.  @SuppressWarnings：定义在java.lang.SuppressWarnings中，用来抑制编译时的警告信息，选择使用
    
    @SuppressWarnings（“all”）
    
    @SuppressWarnings（“unchecked”）
    
    @SuppressWarnings（"value=\{“unchecked”,“deprecation”\}）
    
    等等…

元注解

1.  作用：负责注解其他注解，java定义了4个标准的meta-annotation类型，被用来提供对其他annotation类型作说明，这些类型和他们所支持的类在java.lang.annotation包中可以找到（**@Target，@Retention，@Documented，@Inherited**）
    
     *  **@Target**：用于描述注解的使用范围（即：可以用在什么地方）
     *  **@Retention**：表示需要在什么级别保存该注释信息，用于描述注解的生命周期
        
         *  （SOURCE < CLASS < **RUNTIME**）
     *  @Document：说明该注解将被包含在javadoc中
     *  @Inherited：说明子类可以**继承**父类中的该注解

import java.lang.annotation.*;
    
    /** * @Description: 测试元注解 */
    public class Test02 { 
        @MyAnnotation
        public void test(){ 
        }
    }
    
    //定义一个注解
    //Target:表示我们的注解可以用在哪些地方
    @Target(value = { ElementType.METHOD,ElementType.TYPE})
    
    //Retention:表示我们的注解在什么地方还有效
    //RUNTIME>CLASS>SOURCE
    @Retention(value = RetentionPolicy.RUNTIME)
    
    //Documented:表示是否将我们的注解生成在javadoc中
    @Documented
    
    //Inherited:子类可以继承父类的注解
    @Inherited
    @interface MyAnnotation{ 
    
    }

自定义注解

1.  使用 \*\*@interface \*\*自定义注解时，自动继承了java.lang.annotation.Annotation接口
2.  **分析**
    
     *  @interface 用来声明一个注解，格式：public @interface 注解名\{定义内容\}
     *  其中的每一个方法实际上是声明了一个配置参数
     *  方法的名称就是参数的名称
     *  返回值类型就是参数的类型（返回值只能是基本类型，Class，String，enum）
     *  可以通过default来声明参数的默认值
     *  如果只有一个参数成员，一般参数名为value
     *  注解元素必须要有值，我们定义注解元素时，经常用空字符串，0作为默认值

import java.lang.annotation.*;
    
    /** * @Description: 自定义注解 */
    public class Test03 { 
        //注解可以显示赋值，如果没有默认值，就必须赋值
        @MyAnnotation2(name = "Java",schools = { "bilibili"})
        public void test(){ }
        
        //只有一个值，并且为value时才可以省略
        @MyAnnotation3("")
        public void test2(){ }
    }
    
    @Target(value = { ElementType.TYPE,ElementType.METHOD})
    @Retention(RetentionPolicy.RUNTIME)
    @interface MyAnnotation2{ 
        //注解的参数：参数类型 + 参数名 ();
        String name();
        int age() default 0; //设置默认值
        int id() default -1; //默认值为-1，代表不存在
        
        String[] schools();
    }
    
    @Target(value = { ElementType.TYPE,ElementType.METHOD})
    @Retention(RetentionPolicy.RUNTIME)
    @interface MyAnnotation3{ 
        String value();
    }

![1][]

[1]: /images/20221120/e52d3c600a09484a8574d26d5d762d38.png