Java高级-注解

1.介绍

注解 Annotation

• 就是Java代码里的特殊标记，作用是让其他程序根据注解信息来决定什么是执行该程序
• 注解：注解可以在类上、构造器上、方法上、成员变量上、参数上等位置

自定义注解

/**
 * 自定义注解
 */
public @interface MyTest1 {
    String aaa();
    boolean bbb() default true;
    String[] ccc();
}

特殊属性名：value

• 如果注解中只有一个vlue属性，使用注解时，value名称可以不写

public @interface MyTest2 {
    String value(); // 特殊属性
}

注解的原理

• 注解本质是一个接口，Java中所有的注解都是继承了Annotation接口的
• @注解(…): 其实就是一个实现类对象，实现了该注解以及Annotation接口
  

2.元注解

元注解

• 指的是：修饰注解的注解
• @Target 声明被修饰的注解在哪些位置使用
  • 类，成员变量，成员方法，成员参数，构造器，局部变量
• @Retention 声明注解的保留周期
  • SOURCE 只作用在源码阶段，字节码文件中不存在
  • CLASS (默认值)保留到字节码文件阶段，运行阶段不存在
  • RUNTIME (开发常用)一直保留到运行解阶段

3.注解的解析

什么是注解的解析

• 就是判断类上、方法上、成员变量上是否存在注解，并把注解里的内容给解析出来

如何解析注解

• 指导思想：要解析谁上面的注解，就应该先拿到谁
• 比如要解析类上面的注解，则应该先获取该类的Class对象，在通过Class对象解析其上面的注解
• 比如要解析成员方法上的注解，则应该获取到该成员方法的Method对象，再通过Method对象解析其上面的注解
• Class、Method、Field、Constructor 都实现了AnnotatedElement接口，都拥有解析注解的能力
  

案例
先定义注解MyTest4

@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
public @interface MyTest4 {
    String value();
    double aaa() default 100;
    String[] bbb();
}

在Demo类中定义test1方法，在类和方法上使用MyTest4的注解

@MyTest4(value = "蜘蛛精", aaa = 991, bbb = {"Java", "Python"})
public class Demo {
    @MyTest4(value = "孙悟空", aaa = 22, bbb = {"HTML", "CSS"})
    public void test1() {
    }
}

在AnnotationTest3测试类上，解析Demo类中的全部注解

public class AnnotationTest3 {
    @Test
    public void parseClass() throws NoSuchMethodException {
        // 1.先得到Class对象
        Class demoClass = Demo.class;
        // 2.解析类上的注解
        // 判断类上是否包含了某个注解
        if (demoClass.isAnnotationPresent(MyTest4.class)) {
            MyTest4 myTest4 = (MyTest4) demoClass.getDeclaredAnnotation(MyTest4.class);
            System.out.println(myTest4.value());
            System.out.println(myTest4.aaa());
            System.out.println(Arrays.toString(myTest4.bbb()));
        }

        // 3.解析方法上的注解
        Method test1 = demoClass.getDeclaredMethod("test1");
        if (test1.isAnnotationPresent(MyTest4.class)) {
            MyTest4 myTest4 = test1.getDeclaredAnnotation(MyTest4.class);
            System.out.println(myTest4.value());
            System.out.println(myTest4.aaa());
            System.out.println(Arrays.toString(myTest4.bbb()));
        }
    }
}

4.注解的应用场景

案例：模拟Junit框架
需求：定义若干个方法，只有加了MyTest注解，就会触发该方法执行
分析：

1. 定义一个自定义注解MyTest，只能注解方法，存放范围是一直都在
2. 定义若干个测试方法，部分方法加上@MyTest注解，部分方法不加
3. 模拟Junit程序，可以触发加了@MyTest注解的方法执行

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyTest {
}


public class AnnotationTest4 {
    public void test1() {
        System.out.println("==test1==");
    }

    @MyTest
    public void test2() {
        System.out.println("==test2==");
    }

    public void test3() {
        System.out.println("==test3==");
    }

    @MyTest
    public void test4() {
        System.out.println("==test4==");
    }
    
	public static void main(String[] args) throws Exception {
        // 1.获取对象
        Class annotationTest4Class = AnnotationTest4.class;
        // 2.获取所有方法
        Method[] methods = annotationTest4Class.getDeclaredMethods();
        // 3.遍历所有方法
        AnnotationTest4 annotationTest4 = new AnnotationTest4();
        for (Method method : methods) {
            // 4.判断如果存在MyTest注解
            if (method.isAnnotationPresent(MyTest.class)) {
                // 5.存在MyTest注解，执行该方法
                method.invoke(annotationTest4);
            }
        }
    }
}