Java的Annotation

注解是Java1.5引入的，我们在Java本身及其他框架，如Spring、Hibernate等已经见过很多了。注解的作用这个我的理解还不够深入，大概就是作为数据标记修饰程序，通过Java的反射机制识别注解来做大量重复的工作。

下面是一个注解的示例:

@Documented
@Target(ElementType.METHOD)
@Inherited
@Retention(RetentionPolicy.RUNTIME)
public @interface AnnotationDemo {

	String author() default "canhui";

	String createTime();

	int version() default 1;

	String function() default "";
}

• 注解方法不能有参数。
• 注解方法的返回类型局限于原始类型，字符串，枚举，注解，或以上类型构成的数组。
• 注解方法可以包含默认值。
• 注解可以包含与其绑定的元注解，元注解为注解提供信息，有四种元注解类型：

1. @Documented – 表示使用该注解的元素应被javadoc或类似工具文档化，它应用于类型声明，类型声明的注解会影响客户端对注解元素的使用。如果一个类型声明添加了Documented注解，那么它的注解会成为被注解元素的公共API的一部分。

2. @Target – 表示支持注解的程序元素的种类，一些可能的值有TYPE, METHOD, CONSTRUCTOR, FIELD等等。如果Target元注解不存在，那么该注解就可以使用在任何程序元素之上。

3. @Inherited – 表示一个注解类型会被自动继承，如果用户在类声明的时候查询注解类型，同时类声明中也没有这个类型的注解，那么注解类型会自动查询该类的父类，这个过程将会不停地重复，直到该类型的注解被找到为止，或是到达类结构的顶层（Object）。

4. @Retention – 表示注解类型保留时间的长短，它接收RetentionPolicy参数，可能的值有SOURCE, CLASS, 以及RUNTIME。

注解的测试如下:

public class AnnotationTest {

	String name = "";

	public AnnotationTest(String name) {
		this.name = name;
	}

	public static void main(String[] args) {

		try {
			test(AnnotationTest.class);
		} catch (NoSuchMethodException e) {
			e.printStackTrace();
		} catch (SecurityException e) {
			e.printStackTrace();
		} catch (InstantiationException e) {
			e.printStackTrace();
		} catch (IllegalAccessException e) {
			e.printStackTrace();
		} catch (IllegalArgumentException e) {
			e.printStackTrace();
		} catch (InvocationTargetException e) {
			e.printStackTrace();
		} catch (ClassNotFoundException e) {
			e.printStackTrace();
		}
	}

	public static <T> void test(Class<T> clazz) throws NoSuchMethodException, SecurityException, InstantiationException,
	        IllegalAccessException, IllegalArgumentException, InvocationTargetException, ClassNotFoundException {

		Constructor<T> con = clazz.getConstructor(String.class);
		Object[] arg = new Object[] { "canhui" };
		T test = con.newInstance(arg);
		for (Method method : clazz.getDeclaredMethods()) {
			Annotation[] declaredAnnotations = method.getDeclaredAnnotations();
			System.out.print("方法 " + method.getName());
			if (declaredAnnotations.length != 0) {
				System.out.print(" 的注解有: ");
				for (Annotation anno : declaredAnnotations) {
					System.out.print(anno + ";");
				}
				System.out.println();
			} else {
				System.out.println(" 没有注解");
			}
			if (method.isAnnotationPresent(AnnotationDemo.class)) {
				String introduction = method.getName() + " 包含AnnotationDemo注解的方法";
				method.invoke(test, introduction);
			}
		}
	}

	@Override
	public String toString() {
		return "覆盖tostring方法。";
	}

	@Deprecated
	@AnnotationDemo(author = "c", createTime = "2017-11-28")
	public void oldPrintMethod(String introduction) {
		System.out.println("这是一个过时的方法。" + introduction);
	}

	@AnnotationDemo(author = "cch", function = "输出名字及参数", createTime = "2017-11-28")
	public void newPrintMethod(String introduction) {
		System.out.println("name = " + this.name + " && introduction = " + introduction);
	}
}

输出结果：

方法 main 没有注解
方法 toString 没有注解
方法 test 没有注解
方法 oldPrintMethod 的注解有: @java.lang.Deprecated();@com.canhui.dependence.AnnotationDemo(version=1, author=c, function=, createTime=2017-11-28);
这是一个过时的方法。oldPrintMethod 包含AnnotationDemo注解的方法
方法 newPrintMethod 的注解有: @com.canhui.dependence.AnnotationDemo(version=1, author=cch, function=输出名字及参数, createTime=2017-11-28);
name = canhui && introduction = newPrintMethod 包含AnnotationDemo注解的方法

上面test方法通过Java的反射调用有参构造函数创建对象并且运行了对象的方法，也可以不创建对象直接运行方法，这一部分就和JUnit的@Test注解作用相似了。

大家也许会注意到，toString方法有一个@Override注解，却打印没有注解。这是因为@Override定义的Retention是SOURCE而不是RUNTIME.

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.SOURCE)
public @interface Override {
}

这样已经可以获取到方法，并且运行这个方法了，那么我们Spring中的autowire又是怎么样的呢？。。。我暂时知道的是下面的示例，具体还得看看Spring的源码才能清楚。

	static Map<String,Sup> map = new ConcurrentHashMap<>(16);
	public static <T> void initAnnotation(){
		List<Class<Sup>> clazzList = getAllSubClass(Sup.class,"com.canhui.service");
		for(Class<Sup> clazz : clazzList){
			if(clazz.isAnnotationPresent(AnnotationDemo.class)) {
				// getSimpleName 或者是 getName
				String name = clazz.getSimpleName();
				if(!map.containsKey(name)) {
					map.put(name, (Sup)clazz.newInstance());
				}
			}
		}
	}

参考： http://www.importnew.com/14479.html