从oracle的官方文档来学习annotations：
地址在： http://docs.oracle.com/javase/tutorial/java/javaOO/annotations.html
总结如下：
Annotations我理解就是程序的一些元数据，没有它程序也是ok的。它的主要用途体现在以下几个方面：
1. 替代以前简单的注释；
比如以前的注释可能是：
@Author( name = "Benjamin Franklin", date = "3/27/2010")class MyClass() { }再复杂一点的注释：
public class Generation3List extends Generation2List { // Author: John Doe // Date: 3/17/2002 // Current revision: 6 // Last modified: 4/12/2004 // By: Jane Doe // Reviewers: Alice, Bill, Cindy // class code goes here}用Annotations:
@interface ClassPreamble { String author(); String date(); int currentRevision() default 1; String lastModified() default "N/A"; String lastModifiedBy() default "N/A"; // Note use of array String[] reviewers();}@ClassPreamble ( author = "John Doe", date = "3/17/2002", currentRevision = 6, lastModified = "4/12/2004", lastModifiedBy = "Jane Doe", // Note array notation reviewers = {"Alice", "Bob", "Cindy"})public class Generation3List extends Generation2List {// class code goes here}其中，@interface是定义一个annotation的关键字，看上去像接口，其实不是。
如果要让@ClassPreamble的信息出现在javadoc生成的文档中，你必须给刚才定义的@ClassPreamble加上@Documented这个保留的annotation。
如下所示：
// import this to use @Documentedimport java.lang.annotation.*;@Documented@interface ClassPreamble { // Annotation element definitions }2. 编译器保留的注解， 例如@Deprecated, @Override, 和 @SuppressWarnings.
@Deprecated意思是这个方法过时了，你最好不要再用了，你用我就给你来个warning；
@Override是提示你这个方法是覆盖了父类的一个方法；
@SuppressWarnings是告诉编译器这个方法可能会抛出warning，但你不要告诉我啦。
3. 在runtime用这些注解信息；
一般的用法在runtime的时候JVM不会load这些annotation信息，如果要让runtime知道，就要使用java.lang.annotation.RetentionPolicy了，这是个enum，有三个可选值，
分别是
- CLASS：annotation会被记录在class文件里但不会被jvm load。
- RUNTIME:记录在class文件里也会被jvm load，可以通过反射读取。
- SOURCE：会被compiler丢弃。
具体看下面这个例子：
先定义一个annotation：
import java.lang.annotation.ElementType;import java.lang.annotation.Retention;import java.lang.annotation.RetentionPolicy;import java.lang.annotation.Target;@Retention(RetentionPolicy.RUNTIME)@Target(ElementType.FIELD)public @interface Test_Target { public String doTestTarget();}@Retention(RetentionPolicy.RUNTIME) 就是上面所说的在runtime时候我也要知道注解的信息。
@Target(ElementType.FIELD) 是指这个注解可以加在Field前面（所以你加到方法签名会编译不过的），java.lang.annotation.ElementType也是一个enum，其他可选择的值包括如下，不翻译了。
CONSTRUCTOR
Constructor declaration
FIELD
Field declaration (includes enum constants)
LOCAL_VARIABLE
Local variable declaration
METHOD
Method declaration
PACKAGE
Package declaration
PARAMETER
Parameter declaration
TYPE
Class, interface (including annotation type), or enum declaration
定义了这个注解，看怎么在runtime时候访问它：
import java.lang.reflect.Field;public class TestAnnotations { @Test_Target(doTestTarget="Hello World !") private String str; public static void main(String[] args) throws Exception { // We need to use getDeclaredField here since the field is private. Field field = TestAnnotations.class.getDeclaredField("str"); Test_Target ann = field.getAnnotation(Test_Target.class); if (ann != null) { System.out.println(ann.doTestTarget()); } }}注意在变量str前面使用了定义的注解，在main方法里通过反射获取到了注解中doTestTarget对应的值，所以输出是
Hello World !
