java注解原理

1.什么是java注解

java 注解（Annotation）又称 Java 标注，是 JDK5.0 引入的一种注释机制，可以理解为为某个东西（类，方法，字段。。。）打个标记的记号，等要使用这个注解时，可以通过反射获取标注里面的内容。

2.注解原理

在编译器生成类文件时，标注可以被嵌入到字节码中。Java 虚拟机可以保留标注内容，在运行时可以获取到标注内容。

3.java内置注解

1.@Override 重写
2.@Deprecated 过期警告
3.@SuppressWarnings 忽略警告
等等

4.元注解和自定义注解

像程序员如何使用注解呢，肯定是自定义一个注解，那这个自定义注解编译器怎么认识呢，所以java提供一些元注解来解释下自定义注解是什么。
举个例子 自定义一个JobInfo注解

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE})
@Inherited 
public @interface JobInfo {
    String jobName() default "";
}

元注解： @Retention 表示这个注解的作用域 ，告知编译器这个JobInfo注解，在代码什么级别保存该注解信息。在实际开发中，我们一般都写RUNTIME，当然根据自己需求而定；枚举有
1.SOURCE：源代码时保留
2.CLASS：class文件中保留
3.RUNTIME：运行时保留
作用范围—》 RUNTIME>CLASS>SOURCE

public enum RetentionPolicy {
    /**
     * Annotations are to be discarded by the compiler.
     */
    SOURCE,

    /**
     * Annotations are to be recorded in the class file by the compiler
     * but need not be retained by the VM at run time.  This is the default
     * behavior.
     */
    CLASS,

    /**
     * Annotations are to be recorded in the class file by the compiler and
     * retained by the VM at run time, so they may be read reflectively.
     *
     * @see java.lang.reflect.AnnotatedElement
     */
    RUNTIME
}

元注解：@Documented 作用文档 将此注解包含在 javadoc 中 ，它代表着此注解会被javadoc工具提取成文档

元注解：@Target 标记这个注解应该是使用在哪种 Java 成员上面

public enum ElementType {
    /** Class, interface (including annotation type), or enum declaration */
    TYPE,

    /** Field declaration (includes enum constants) */
    FIELD,

    /** Method declaration */
    METHOD,

    /** Formal parameter declaration */
    PARAMETER,

    /** Constructor declaration */
    CONSTRUCTOR,

    /** Local variable declaration */
    LOCAL_VARIABLE,

    /** Annotation type declaration */
    ANNOTATION_TYPE,

    /** Package declaration */
    PACKAGE,

    /**
     * Type parameter declaration
     *
     * @since 1.8
     */
    TYPE_PARAMETER,

    /**
     * Use of a type
     *
     * @since 1.8
     */
    TYPE_USE
}

@Target(ElementType.TYPE)——接口、类、枚举、注解

@Target(ElementType.FIELD)——字段、枚举的常量

@Target(ElementType.METHOD)——方法

@Target(ElementType.PARAMETER)——方法参数

@Target(ElementType.CONSTRUCTOR) ——构造函数

@Target(ElementType.LOCAL_VARIABLE)——局部变量

@Target(ElementType.ANNOTATION_TYPE)——注解

@Target(ElementType.PACKAGE)——包

元注解@Inherited 表示继承，比如类A上打了@JobInfo注解，那么类B继承了类A,那么类B也可以拿到类A上的@JobInfo注解信息

其他元注解

@SafeVarargs - Java 7 开始支持，忽略任何使用参数为泛型变量的方法或构造函数调用产生的警告。

@FunctionalInterface - Java 8 开始支持，标识一个匿名函数或函数式接口。

@Repeatable - Java 8 开始支持，标识某注解可以在同一个声明上使用多次。

5.总结

程序员要使用自定义注解，必须使用元注解标识一些信息，告知编译器这个自定义注解的一些信息，这样编译器才知道怎么去校验和保留该自定义注解信息到字节码中

6.TODO

1.注解的使用（打标记）
2.注解的获取（获取注解标记的信息，拿到这些信息做其他事情。。。）通常我们说一个注解的作用时，说的是获取这个注解打标记的内容然后干了什么事情，这个作用。