Java注解(annotation)简述

Java注解(annotation)简单上手

反射reflect：https://www.jb51.net/article/221282.htm

1、什么是注解？

注解就像商场的商品上都贴有自己的标签一样，它提供了关于这个商品的许多额外信息。你可以根据这些信息对其进行附加的处理。

“打上标签” 以后，框架就可以利用Java的反射能力，扫描、获取各Class/Method/Field上的注解，据此对其进行额外的处理。

2、java内置注解

java中有一些java原生就定义的注解，像@Override

注解可以辅助反射机制，例如帮助我们快速筛选在反射中操作的目标，它在如今流行的框架中被大量使用

java内置了一些注解，有些是辅助编译器一起编译时做验证使用，下面两个注解就是java内置的注解，他们用于为我们定义的注解指定某些特性：

@Target
用于指定我们定义的注解可以被应用在哪里，具体的位置被枚举类型ElementType定义，例如：
    TYPE：在类上可以使用当前注解,即只能标注在类上
    METHOD：在方法上可以使用当前注解,即只能标注在方法上
    FIELD：在属性上可以使用当前注解,即只能标注在属性上
    还有一些其他，可参见API手册
@Retention
用于我们定义的注解的保留级别
     RetentionPolice.RUNTIME：最常用，保留在字节码文件中且在该类运行时可被反射机制利用
     RetentionPolice.CLASS：保留在字节码中，但是反射机制不可用，如若不写默认@Retention就是该级别
     RetentionPolice.SOURCE：保留在源码中

3、注解的基本运

创建注解

创建两个注解类AutoRunClass和TestMethod

/*
   @Target()可以指定在哪使用这个注解
   这个表示是给类(Type)使用的注解，表示只能在类上使用，不能在其他地方使用
   @Target({ElementType.TYPE,ElementType.FIELD})也可以使用数组的方式使用多个
*/
@Target(ElementType.TYPE)
//保留级别
@Retention(RetentionPolicy.RUNTIME)

public @interface AutoRunClass {//这个注解的作用于筛选类
}

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface TestMethod {//这个注解的作用于筛选方法
   /*
       注解里可以定义参数，格式：
       类型 参数名()
       注意：如果当前注解只有一个参数时，通常参数名叫value

当我们定义了参数，那么在使用当前注释时需要为参数指定值，格式：
       @注解名(参数1=参数值1,参数1=参数值1,...)
       参数指定的顺序可以与注解中定义的顺序不一样

例如:
       @TestMethod(5)
       注：上述注解没有指定参数名的原因是该注解只有一个参数，并且参数名叫value
       即:int value();

如果该参数定义时为:int sum();
       那么使用注解时要写成:@TestMethod(sum=5)

注：使用default可以初始化定义值
    */
   int value() default 1;
}

创建一个实体类Person，在其中使用注解标识类和方法

package reflect_text;

/**
* 用于测试反射-注解机制
*/
@AutoRunClass//-----------------------
public class Person {
   private String name = "刘瑜澄";
   private int age = 22;

public Person() {
   }

public Person(String name, int age) {
       this.name = name;
       this.age = age;
   }

//有了初始值，加不加参数都可以
   @TestMethod//-----------------------
   public void sayHi() {
       System.out.println(name + "Hi!!!");
   }

@TestMethod(3)//-----------------------
   public void sayHello() {
       System.out.println(name + "大家好！");
   }

@TestMethod(5)//-----------------------
   public void sayGoodBye() {
       System.out.println(name + "再见！");
   }

public void say(String info) {
       System.out.println(name + ":" + info);
   }

public void say(String info, int sum) {
       for (int i = 0; i < sum; i++) {
           System.out.println(name + ":" + info);
       }
   }

@Override
   public String toString() {
       return "Person{" +
               "name='" + name + '\'' +
               ", age=" + age +
               '}';
   }
}

使用注解

要求判断Person是否被AutoRunClass注解修饰，如果是则遍历Person中所有方法，遍历判断这些方法是否被TestMethod注解修饰，是则根据注解传入的参数去遍历执行该方法。

如果对反射不是很了解，可以看看https://www.jb51.net/article/221282.htm

//加载Person的类对象
       Class cls = Class.forName("reflect_text.Person");

/*
           boolean isAnnotationPresent(Class annoCls)
           检查是否又被annoCls指定的注解修饰
        */
       if (cls.isAnnotationPresent(AutoRunClass.class)) {
           System.out.println(cls.getName() + "被AutoRunClass注解修饰");
           //实例化
           Object obj = cls.newInstance();
           //扫描当前类定义的所有方法
           Method[] methods = cls.getDeclaredMethods();
           for (Method method : methods) {
               if (method.isAnnotationPresent(TestMethod.class)) {
                   System.out.println(method.getName()+"被TestMethod注解修饰");
                   //通过getAnnotation方法获取method方法上的注解@TestMethod
                   TestMethod tm = method.getAnnotation(TestMethod.class);
                   //调用其参数名，获取注解 参数value的值
                   int sum = tm.value();
                   //然后根据注解传入的参数重复调用该方法
                   for (int i = 0; i < sum; i++) {
                       method.invoke(obj);
                   }
               }else{
                   System.out.println(method.getName() + "不被@TestMethod注解修饰");
               }
           }
       } else {
           System.out.println(cls.getName() + "没有被AutoRunClass注解修饰");
       }

来源：https://blog.csdn.net/Grantr/article/details/119973318