Java注解与反射(一)

138 阅读3分钟

这是我参与11月更文挑战的第18天,活动详情查看:2021最后一次更文挑战

Java_注解和反射


一、注解(Annotation)

1.1 基本概念

  • 注解是从JDK5.0之后引进的一门技术

  • 作用:

    • 不是程序本身,可以对程序作出解释
    • 可以被其他程序(比如:编译器)读取
  • 格式:

    • @注解名(参数值)
    • 举例:@SuppressWarning(value ="unchecked")
  • 使用位置:

    • 附加在package、class、method、field等上面,相当于添加了额外的辅助信息,可以通过反射机制编程对这些元数据进行访问

1.2 内置注解

@override : java.lang.Override之中,只适用于修辞方法,表示打算重写某个方法

@Deprecated:java.lang.Deprecated之中,适用于修辞方法、属性、类,表示不鼓励程序员使用这些元素,通常是因为其危险或者有更好的选择

@SuppressWarnings : java.lang.SuppressWarnings之中,用来抑制编译时的警告信息,这个是有参数的

 package annotation.demo1;
 ​
 import java.util.ArrayList;
 import java.util.List;
 ​
 public class Test01 {
     @SuppressWarnings("all")    // 镇压警告的注解
     public static void main(String[] args){
         List list = new ArrayList();
     }
 }
 ​

1.3 元注解

  • 作用:负责解释其他的注解,Java定义了4个标准的meta-annotation类型,他们被用来提供对其他的注解进行说明

  • 这些类型都在java.lang.annotaton中找到

  • 分别是:

    • @Target: 用于描述注解使用的范围

    • @Retention:表示需要在什么级别保存该注释信息,用于描述注解的生命周期

      • (SOURCE < CLASS < RUNTIME),一般是RUNTIME
    • @Document: 说明该注解将被包含在javadoc当中

    • @Inherited: 说明子类可以继承父类中的该注解

 package annotation.demo1;
 ​
 import java.lang.annotation.*;
 ​
 // 测试元注解
 public class Test02 {
 ​
   @MyAnnotation
     public void Test(String str){
 ​
     }
 ​
 }
 ​
 // 自定义注解
 @Target(value = {ElementType.METHOD,ElementType.TYPE})
 @Retention(value = RetentionPolicy.RUNTIME)         // 表示在那个级别还有效
 ​
 @Documented
 @Inherited
 @interface MyAnnotation{
 ​
 }
 ​

1.4 自定义注解

  • 使用@interface进行注解,表示自动继承了java.lang.annotation.Annotation接口 分析:

    • @interface用来声明一个注解,格式 :public @interface 注解名{定义内容}
    • 其中的每一个方法实际上是声明了一个配置参数
    • 方法的名称就是参数的名称
    • 返回值类型就是参数的类型(只能是基本类型或者String\class\enum)
    • 可以通过default来声明参数的默认值
    • 如果只有一个参数成员,一般的参数名称为value
    • 注解元素必须要有值,我们自定义注解元素时,经常使用空字符串,作为默认值
 package annotation.demo1;
 ​
 import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
 ​
 // 自定义注解
 public class Test03 {
 ​
     // 如果注解里有参数,那么一定要有值,否则报错
     // 或者在注解当中添加一个默认值default
     @MyAnnotation2(name = "" , schools = "Hua")
     public void test03(){
         
     }
     
 }
 ​
 // 下面是注解
 @Target(value = {ElementType.TYPE,ElementType.METHOD})
 @Retention(value = RetentionPolicy.RUNTIME)
 @interface MyAnnotation2{
 ​
     // 注解的参数 : 参数类型 + 参数名称
     String name()  ;
     String name2 () default "" ;
     int age () default 0 ;
     int id() default -1 ;  // 如果默认值是-1 , 表示不存在
     
     String[] schools();
  
 }
 ​
 // 如果注解当中只有一个值,建议用value命名,因为可以在调用的时候不写参数名称
 @Target({ElementType.TYPE,ElementType.METHOD})
 @Retention(RetentionPolicy.RUNTIME)
 @interface MyAnnotation3{
     String value();
 }