理解Java注解原理:Annotation

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();
}