JDK源码-java.lang.annotation-第一部分-源码学习

1.java.lang.annnotation包结构

---

2.Annontation(接口)

接口解释:
注解接口,所有注解类型的父类型,定义了4个方法,类似Object,但是因为是接口所以无法重写方法,只能实现方法

方法解释:
Class

3.ElementType(枚举)

解释:
程序元素类型,元素常用分类

源码解释:

public enum ElementType {
    /** 可以修饰类,接口,枚举类型 */
    TYPE,

    /** 修饰成员变量 */
    FIELD,

    /** 修饰方法 */
    METHOD,

    /** 修饰参数 */
    PARAMETER,

    /** 修饰构造函数 */
    CONSTRUCTOR,

    /** 修饰局部变量 */
    LOCAL_VARIABLE,

    /** 修饰注解 */
    ANNOTATION_TYPE,

    /** 修饰包 */
    PACKAGE
}

---

4.RetentionPolicy(枚举)

解释:
注解保留策略

源码解释:

public enum RetentionPolicy {
    /**
     * 注解保留到源码中,编译时去除
     */
    SOURCE,

    /**
     * 注解记录到class文件中,程序运行时JVM中不保留
     */
    CLASS,

    /**
     * 注解记录到class文件中,程序运行时JVM中保留注解信息
     * 可以通过反射获取到
     * @see java.lang.reflect.AnnotatedElement
     */
    RUNTIME
}

---

5.AnnotationFormatError(错误)

解释:当注释分析器试图从类文件读取注释并确定注释出现异常时，抛出该错误

---

6.AnnotationTypeMismatchException(错误)

解释:若某个注释的类型在对该注释进行编译（或序列化）后发生了更改，而程序试图访问该注释的元素时，抛出此异常。

参数:
element:注释元素的方法(Method)对象
foundType:在注释中找到的数据的（错误）类型。此字符串可以，但不一定包含该值。没有指定字符串的确切格式。

---

7.Documented

解释:如果定义了某个注解(A),使用了@Documented修饰时,使用javadoc和类似的工具进行格式化,所有使用注解(A),将会包含注解A的说明

---

8.Inherited

解释:指定具有继承性质.标记注解,如果一个使用了@Inherited修饰的annotation类型被用于一个class，则这个annotation将被用于该class的子类。只能用户类上使用,其他地方使用不起作用(包括接口)

---

9.Target

解释说明注解的使用范围,作用域,使用枚举类ElementType

源代码:

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.ANNOTATION_TYPE)
public @interface Target {
    ElementType[] value();
}

---

10.Retention

解释:描述注解使用范围,在整个工程保留多久,使用枚举类RetentionPolicy

源代码:

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.ANNOTATION_TYPE)
public @interface Retention {
    RetentionPolicy value();
}

---