注解使用总结

末蓝、 2023-10-04 20:52 9阅读 0赞

### 一、注解 ###

注解(Annotation):
       也叫元数据是说明程序的。给计算机看的，它与 类、接口、枚举是在同一层次，它可以声明在类、包、字段、方法、局部变量、方法参数 的前面，
       用来对这些元素进行说明和注释。

#### 一、作用分类： ####

(1)：编写文档；
    (2): 编译检查；
    (3): 代码分析；
          通过代码里的标识的注解对代码进行分析。(使用反射)

#### 二、Jdk中预定义的一些注解： ####

(1). @Override:
           检测被该注解标注的方法是否继承自父类或接口的？
    
    (2). @Deprecated：
           该注解标注的内容，表示已过时。
    
    (3). @suppresswarnings: 一般传递参数 null
           用于压制警告。
          
    (4). @suppresswarnings("null"):
           表明压制所有警告。

####  ####

#### 三、自定义注解： ####

##### （1）格式： #####

元注解
     public @interface 注解名称{
        
       // 属性列表
     }

##### （2）使用： #####

@ + 注解名称

##### （3）注解本质： #####

注解本事就是一个接口，该接口默认继承 java.lang.anntation.Anntoting 接口。

##### （4）注解中属性： #####

总结接口中可以定义什么，注解里就可以定义什么。
    接口中可以定义的成员方法。
    
    要求：
      (1)属性的返回值类型：其他的都不行。
           1.基本数据类型 (四类八种)。
           2.字符串:String
           3.枚举
           4.注解。
           5.以上类型的数组。
       (2)定义了属性，在使用时需要给属性赋值,多个值用逗号隔开。
    
       (3)如果说不想赋值，可以给接口里的属性加上“default”默认初始化值，则使用注解时，可以不进行属性的赋值。

public @interface myAoo{
        
     int age;
     String name( ) default "张三"
    }

###### 注意： ######

(1) 如果只有一个属性需要赋值，并且属性的名称是value，则value可以省略，其他的不行。
    (2) 数组的属性赋值时使用 {} 包裹。如果数组中只有一个值，则 {} 可以省略。

##### (5) 元注解： #####

用于描述注解的注解。
      (1) @Target:描述注解能够作用的位置。
      
      (2) @Retention:描述注解被保留的阶段。
             <1>  souRcE
             <2>  class: 类 对象 阶段
             <3>  RUNTIME: 运行阶段       
             
      
      (3) @Documented:描述注解是否被抽取到aAPI文档中？
      
      (4) @Inherited:描述注解是否被子类继承？

(1) Target 中属性值：
       ElemType取值：
          (1)   TYPE:可以作用在内上面。
          (2) METHOO:可以作用在方法上面。
          (3)  FIELD:可以作用于成员变量上面。
          
      即：
      @Target(
        value={
        
          ElemType.TYPE, ElemType.METHOO, ElemType.FIELD
        }
      )
      
      可以作用:类、方法、成员变量 上面。
      
      
    (2)Retention:
      @Retention(RetentionPolicy.RUNTIME):
      当前被描述的注解会保留到class字节码文件中，并被Jvm读取到。
          
     自定义注解时一般用 :RUNTIME 在保留阶段就行。

#### 四、在程序中使用注解： ####

即：
     获取注解中定义了属性值。