java.lang包 分析_java.lang.annotation包类的浅析

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运行时始终存在，而且可以通过反射获取相对应的信息。

@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。

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