标签：
Java注解是附加在代码中的一些元信息，用于一些工具在编译、运行时进行解析和使用，起到说明、配置的功能。
注解不会也不能影响代码的实际逻辑，仅仅起到辅助性的作用
下面我们来详细说说这个注解，到底是怎么一回事，一步一步看下去，总会后收获。
注解起源：Annotation(注解)是JDK5.0及以后版本引入的。在java.lang.annotation包中。
注解作用：它可以用于创建文档，跟踪代码中的依赖性，甚至执行基本编译时检查。
注解格式：注解是以‘@注解名’在代码中存在的
注解分类：标记注解、单值注解、完整注解三类
另外：它都不会直接影响到程序的语义，只是作为注解（标识）存在，我们可以通过反射机制编程实现对这些元数据的访问。
元注解说，我先来上阵-----
------------------------------main-----------------------------------
元注解功能：就是对其他注解进行注解。
我们它的功能划分为三类：
编写文档：通过代码里标识的元数据生成文档；
代码分析：通过代码里标识的元数据对代码进行分析；
编译检查：通过代码里标识的元数据让编译器能实现基本的编译检查。
元注解包括：@Retention @Target @Document @Inherited四种。
@Target 注解：
---------------------------------------------------
@Target解释：
@Target说明了Annotation所修饰的对象范围：
Annotation可被用于 packages、types（类、接口、枚举、Annotation类型）、类型成员（方法、构造方法、成员变量、枚举值）、方法参数和本地变量（如循 环变量、catch参数）。
在Annotation类型的声明中使用了target可更加明晰其修饰的目标。
@Target作用：用于描述注解的使用范围（即：被描述的注解可以用在什么地方）
@Target 的java源码：
@Documented @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.ANNOTATION_TYPE) public @interface Target { ElementType[] value(); }
备注：先解释一下 interface 表示接口，而@interface表示annotation
——————————————————————————
ElementType取值：
通过源码可以看到，ElementType ，它的取值有：
1.CONSTRUCTOR:用于描述构造器
2.FIELD:用于描述域
3.LOCAL_VARIABLE:用于描述局部变量
4.METHOD:用于描述方法
5.PACKAGE:用于描述包
6.PARAMETER:用于描述参数
7.TYPE:用于描述类、接口(包括注解类型) 或enum声明
------------------------------------------------
实例： （我们自定义了两个自定义注解，按照上面我们给出的取值含义，@table将会用于类、接口或enum声明）
@Target(ElementType.TYPE) public @interface Table { /** * 数据表名称注解，默认值为类名称 * @return */ public String tableName() default "className"; } @Target(ElementType.FIELD) public @interface NoDBColumn { }
那么到这里，我们的@Target 元注解解释完毕，有不明白地方， @企鹅：2783309477
@Retention注解：
@Retention 精简解释：
就是对自定义注解的生命周期的管理。
@Retention 详细解释：
@Retention定义了该Annotation被保留的时间长短：某些Annotation仅出现在源代码中，而 被编译器丢弃；而另一些却被编译在class文件中；编译在class文件中的Annotation可能会被虚拟机忽略，而另一些在class被装载时将 被读取（请注意并不影响class的执行，因为Annotation与class在使用上是被分离的）。使用这个meta-Annotation可以对 Annotation的“生命周期”限制
——————————————————————————————
@Retention: 定义注解的保留策略
——————————————————————————————
@Retention java源码：
@Documented @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.ANNOTATION_TYPE) public @interface Retention { RetentionPolicy value(); }
通过源代码可以看到RetentionPolicy可取值。那么接下来
———————————————————————————————
@Retention 取值：
RetentionPolicy可取值：
1.SOURCE:在源文件中有效（即源文件保留）
2.CLASS:在class文件中有效（即class保留）
3.RUNTIME:在运行时有效（即运行时保留）
@Retention 实例：
@Target(ElementType.FIELD) @Retention(RetentionPolicy.RUNTIME) public @interface Column { public String name() default "fieldName"; public String setFuncName() default "setField"; public String getFuncName() default "getField"; public boolean defaultDBValue() default false; }
备注：也同样，可以看出来，Column将会有在运行时有效范围。
一般格式：
@Retention(RetentionPolicy.SOURCE) //注解仅存在于源码中，在class字节码文件中不包含
@Retention(RetentionPolicy.CLASS) // 默认的保留策略，注解会在class字节码文件中存在，但运行时无法获得，
OK，这个就解释到这里，有不明白 @小企鹅：2783309477（如是），接下来
@Documented 元注解：
@Documented用于描述其它类型的annotation应该被作为被标注的程序成员的公共API，
因此可以被例如javadoc此类的工具文档化。
Documented是一个标记注解，没有成员。
@Document java源码：
@Documented @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.ANNOTATION_TYPE) public @interface Documented { }
@Document 实例：
@Target(ElementType.FIELD) @Retention(RetentionPolicy.RUNTIME) @Documented public @interface Column { public String name() default "fieldName"; public String setFuncName() default "setField"; public String getFuncName() default "getField"; public boolean defaultDBValue() default false; }
【java】细说 JAVA中 标注 注解（annotation）
标签：
原文地址：http://www.cnblogs.com/hyhnet/p/5613394.html
