一分钟理解注解

注解这个东西我们肯定每天都能看见，也许有时候看的太多了到是会忽略注解这东西具体是如何工作的。今天在这里用最短的篇幅快速讲解下注解的原理，对这块记的不太清楚的同学也可以再次看看，下次有人详细问这块的话不至于一知半解。

一句话描述：就是元数据，即一种描述数据的数据。所以，可以说注解就是源代码的元数据。

package com.qk365.annotation;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * @Target说明了Annotation所修饰的对象范围
 *
 * @Retention定义了该Annotation被保留的时间长短
 * 
 * @Documented可以被例如javadoc此类的工具文档化
 * 
 * @Inherited是否可继承
 */
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
public @interface LogForController {

	/**
	 * 功能描述
	 */
	public String optMemo() default "";

	/**
	 * 操作模块
	 */
	public String optModel() default "";

}

关键字解析：

1. @Rentention用来标记自定义注解的有效范围 ，即注解的生命周期

• RetentionPolicy.SOURCE – 在编译阶段丢弃。这些注解在编译结束之后就不再有任何意义，所以它们不会写入字节码。@Override, @SuppressWarnings都属于这类注解。
• RetentionPolicy.CLASS – 在类加载的时候丢弃。在字节码文件的处理中有用。注解默认使用这种方式。
• RetentionPolicy.RUNTIME– 始终不会丢弃，运行期也保留该注解，因此可以使用反射机制读取该注解的信息。我们自定义的注解通常使用这种方式。

 

      2.@Target – 表示该注解用于什么地方。如果不明确指出，该注解可以放在任何地方。以下是一些可用的参数。需要说明的是：属性的注解是兼容的，如果你想给7个属性都添加注解，仅仅排除一个属性，那么你需要在定义target包含所有的属性。

• ElementType.TYPE:用于描述类、接口或enum声明
• ElementType.FIELD:用于描述实例变量
• ElementType.METHOD
• ElementType.PARAMETER
• ElementType.CONSTRUCTOR
• ElementType.LOCAL_VARIABLE
• ElementType.ANNOTATION_TYPE 另一个注释
• ElementType.PACKAGE 用于记录java文件的package信息

3.@Documented 使用了@Documented的可以在javadoc中找到

4.@Interited 可继承性的标识，使用了Interited表示注解里的内容可以被子类继承.

5.@interface 这个东西在声明注解的时候必须得使用，用@interface就意味着这个东西已经继承了java.lang.annotation.Annotation，也说明了它是一个注解。

 

注解用途： 1.生成文档。

                    2. 跟踪代码依赖性，实现替代配置文件功能

                   3. 在编译时进行格式检查。

                   4.反射