java.lang.annotation包类的浅析

2019独角兽企业重金招聘Python工程师标准>>>

1、先看一下annotation包下的类，作者的jdk是1.6版本。

Annotation是接口,the common interface extended by all annotation types,意思就就是说Annotation是所有注解类型的父类型，个人感觉就像是注解’界‘的Object，Annotation有四个方法，但是自定义的注解是不可以重写Annotation这四个方法的。这与Object中的不同之处。

2、@interface Retention

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

Retention：“保留，拘留”的意思。在注解中用于标识注解被保留多久(由于注解的保留的属性不同，在jvm中驻留的时间也不同)如果在注解上没加@Retention注解，则默认的保留策略是ClASS。该注解作用范围就是在注解上，用于属性和方法是不起作用的。

3、RetentionPolicy

接上面的策略说：

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
}

SOURCE:注解将在编译的时候被忽略；

ClASS：编译之后注解将被保留在字节码文件中，但是在不会在vm运行时保留。默认策略；

RUNTIME:注解会保留在字节码文件中，同时在vm运行时始终存在，而且可以通过反射获取相对应的信息。

4、@interface Target

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

Target是指示该注解适用的范围，如果Target元注解没有在注解上声明，该自定义的注解可以在程序的任何地方使用。如果在Target中出现超过一次的同样的ElementType的枚举值，就会报编译时错误。如果在Target（{}）这样使用，该注解就不能在外部使用了。

public enum ElementType {
    /** Class, interface (including annotation type), or enum declaration */
    TYPE,
    /** Field declaration (includes enum constants) */
    FIELD,
    /** Method declaration */
    METHOD,
    /** Parameter declaration */
    PARAMETER,
    /** Constructor declaration */
    CONSTRUCTOR,
    /** Local variable declaration */
    LOCAL_VARIABLE,
    /** Annotation type declaration */
    ANNOTATION_TYPE,
    /** Package declaration */
    PACKAGE
}

使用范围:

TYPE:类、接口、注解、枚举类型；
FIELD:属性；
METHOD：方法；
PARAMETER：参数；
CONSTRUCTOR:构造函数；
LOCAL_VARIABLE:局部变量
ANNOTATION_TYPE：注解类型；
PACKAGE：包；

5、@Inherited

使用该Meta-annotation意思是该注解可以被自动继承。如果自定义注解声明了@Inherited，子类就会沿着继承树去查找有改表示的注解。除了在类上使用外，用在其他地方的都不起作用。只能在继承的情况下起作用，如果实现一个借口@Inherited也是不起作用的。

6、@Documentd

Indicates that annotations with a type are to be documented by javadoc and similar tools by default。

暂时写这些，待更新，如有错误请望轻拍^_^!

转载于:https://my.oschina.net/u/1536972/blog/215878