自制笔记 | Java基础——注解（持续更新...）

Annotation表示注解，是JDK1.5的新特性

注解的主要作用：对我们的程序进行标注，通过注解可以给类增加额外的信息

注解是给编译器或JVM看的，编译器或JVM可以根据注解来完成对应的功能

Java中已经存在的注解（掌握）：

① @Override：表示方法的重写
② @Deprecated：表示修饰的方法已过时
③ @SuppressWarnings("all")：压制警告

除此之外，还需要掌握第三方框架中提供的注解，比如Junit的：@Test、Before、After

自定义注解（了解）：

自定义注解单独存在是没有什么意义的，一般会跟反射结合起来使用，会用反射去解析注解。针对于注解，只要掌握别人已经写好的注解即可。关于注解的解析，一般是在框架的底层已经写好了

自定义注解就是自己做一个注解来使用

public @interface 注解名称 {
    public 属性类型 属性名() default 默认值;
}

这里的属性类型只可以是：基本数据类型、String、Class、注解、枚举以及以上类型的一维数组

使用：

@注解名(属性名1 = 值1, 属性名2 = 值2)

注意：

① 使用自定义注解时要保证注解每个属性都有值
② 注解可以使用默认值

示例：

public @interface MyAnno {
    public String name();
    public int age();
}

特殊属性（掌握）：

① value属性，如果只有一个value属性，使用value属性的时候可以省略value名称不写
② 但是如果有多个属性，且多个属性没有默认值，那么value名称是不能省略的

元注解：

元注解就是注解注解的注解，也就是写在注解上面的注解

元注解有两个：

① @Target：约束自定义注解只能在哪些地方使用
② @Retention：申明注解的声明周期

@Target中可使用的值定义在ElementType中，常用值如下：

① Type：类、接口
② FIELD：成员变量
③ METHOD：成员方法
④ PARAMETER：方法参数
⑤ CONSTRUCTOR：构造器
⑥ LOCAL_VARIABLE：局部变量

@Retention中可使用的值定义在RetentionPolicy枚举类中，常用值如下：

① SOURCE：注解只作用在源码阶段，生成的字节码文件中不存在
② CLASS：注解作用在源码阶段，字节码文件阶段，运行阶段不存在，默认值
③ RUNTIME：注解作用在源码阶段，字节码文件阶段，运行阶段（开发常用）

示例：

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface MyAnno {
    public String age();
    public String name() default "2";
}

注解的解析：

注解的操作中经常需要进行解析，注解的解析就是判断是否存在注解，存在注解就解析出内容

与注解解析相关的接口：

Annotation：注解的顶级接口

可以利用反射解析注解：

方法	说明
`Annotation[] getDeclaredAnnotations()`	获得当前对象上使用的所有注解，返回注解数组
`T getDeclaredAnnotations(Class<T> annotationClass)`	根据注解类型获得对应注解对象
`boolean isAnnotationPresent(Class<Annotation> annotationClass)`	判断当前对象是否使用了指定的注解，如果使用了则返回true，否则false

所有的类成分Class，Method，Field，Constructor，都实现了AnnotatedElement接口，他们都拥有解析注解的能力

解析注解的技巧：

① 注解在哪个成分上，我们就先拿哪个成分对象
② 比如注解作用成员方法，则要获得该成员方法对应的Method对象，再来拿上面的注解
③ 比如注解作用在类上，则要获得该类的Class对象，再来拿上面的注解
④ 比如注解作用在成员变量上，则要获得该成员变量对应的Field对象，再来拿上面的注解

案例：模拟Junit框架

需求：定义若干个方法，只要加了MyTest注解，就可以在启动时被触发执行

分析：

① 定义一个自定义注解MyTest，只能注解方法，存活范围是一直都在
② 定义若干个方法，只要有@MyTest注解的方法就能在启动时被触发执行，没有这个注解的方法不能执行

代码：

MyTest注解：

//表示着我们的注解可以写在方法上面，其他地方不能写
@Target(ElementType.METHOD)
//表示我们的注解可以在任意时期都存在
//如果写source，那么只能在源码阶段存在，利用反射无法解析，因为反射是通过字节码文件执行的
@Retention(RetentionPolicy.RUNTIME)
public @interface MyTest {
}

使用该注解的类（测试类）：

public class MyTestDemo {

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

    @MyTest
    public void method2() {
        System.out.println("method2");
    }
    
    public void method3() {
        System.out.println("method3");
    }
}

类似Junit底层的实现：

public class MyAnnoDemo {
    public static void main(String[] args) throws ClassNotFoundException, InvocationTargetException, IllegalAccessException {
        //1.获取main这个类的字节码文件对象
        Class<?> clazz = Class.forName("p1.MyTestDemo");

        //对象
        main mtd = new MyTestDemo();
        
        //2.获取所有方法
        Method[] methods = clazz.getDeclaredMethods();

        //3.遍历得到每一个方法
        for (Method method : methods) {
            //4.临时修改权限
            method.setAccessible(true);
            //5.判断当前方法上面有没有MyTest注解
            if(method.isAnnotationPresent(MyTest.class)) {
                method.invoke(mtd);
            }
        }
    }
}

自制笔记 | Java基础——注解（持续更新...）

悦读