MyAnnotation1.javapublic @interface MyAnnotation1 {/** * value method * @return value */public String value();}
MyAnnotation1具有一个名为value的方法。MyAnnotation1使用：TestMyAnnotation1.java
@MyAnnotation1("hello")public class TestMyAnnotation1 {@MyAnnotation1(value="world")public void testMethod() {}}
可以通过@Annotation名(方法名1=值1, 方法名2=值2, …)的形式给annotation赋值。只有一个方法的时候，可以直接省略为：@Annotation名(值1) 的赋值形式。当方法返回一个数组时，可以用 方法名={值1, 值2, …}给其赋值。
具有一个value方法和一个属性Annotation范例：
如果必要，还可以在annotation里为其定义属性。如下：MyAnnotation2.java
@interface MyAnnotation2 {public String value();public String myProperty = "hello world";}
其中，myProperty只能申明为public或无public修饰（无public修饰时也默认为public）为static, final属性（即使不写也默认为static, final）。使用例：TestMyAnnotation2
class TestMyAnnotation2 {public static void main(String[] args) {System.out.println(MyAnnotation2.myProperty);}@MyAnnotation2("")public void testMethod1() {}}
上例会打印出：
hello world
复杂型annotation的定义与使用
本节介绍较为复杂的annotation定义与使用。先看代码：MyAnnotation3.java
public @interface MyAnnotation3 {public String value();public String[] multiValues();int number() default 0;}
MyAnnotation3具有一个返回String的value方法，返回String[]的multiValues 方法；还有一个返回int 的number方法。其中number方法具有默认值0。使用例： TestMyAnnotation3.java
class TestMyAnnotation3 {@MyAnnotation3(value = "call testMethod1", multiValues={"1", "2"}, number = 1)public void testMethod1() {}@MyAnnotation3(value = "call testMethod2", multiValues={"1", "2"})public void testMethod2() {}}
number具有默认值，所以标注时可以不为其赋值。其余方法则必须通过上面介绍的方法赋值。multiValues返回一个String[]数组，所以可以通过multiValues={"1", "2"}为其赋值。这样说来，annotation到底能起什么作用呢？1，编译工具或其他工具可以根据被附加在代码里的annotation信息自动生成配置文件或文档等外部文件。比如，sun公司就提供了apt（Annotation Processing Tool）工具，apt工具是一个可以处理annotation的命令行工具，apt提供了在编译期针对源代码级别的解析，并可以在解析时生成新的源代码和其他文件，同时还可以对生成的源代码进行编译。2，其他程序可以在运行时动态解析将要被执行的程序里的annotation信息，并根据被附加的annotation信息来执行不同的操作。比如，EJB3规范就比较广泛地使用了annotation特性。比如只要在POJO为class注明@Stateless注释，EJB容器便会根据此annotation把该POJO注册为无状态的Session Bean。EJB3使用了annotation大大地简化了EJB的开发和配置过程。我们会在其他文章里专门介绍EJB Annotation的原理与使用方法，这里不做详述。本文通过一个简单地例子来说明怎么在运行期动态解析annotation。Apt工具的使用我们会在近期其他文章里对其加以介绍。比如，我们定义了MyAnnotation3注释：
MyAnnotation3.java
package com.test.annotation;import java.lang.annotation.Annotation;import java.lang.annotation.Inherited;import java.lang.annotation.Retention;import java.lang.annotation.RetentionPolicy;@Retention(RetentionPolicy.RUNTIME)public @interface MyAnnotation3 {public String value();public String[] multiValues();int number() default 0;}
上面定义了一个名为MyAnnotation3的注释。我们再定义一个GetMyAnnotation类，该类使用了MyAnnotation3注释：GetMyAnnotation.java：
package com.test.annotation.test;import java.lang.annotation.Annotation;import java.lang.reflect.Field;import java.lang.reflect.Method;import javax.ejb.EJB;import javax.naming.InitialContext;import javax.naming.NamingException;import com.test.annotation.MyAnnotation3;// 为GetMyAnnotation类附加MyAnnotation3 注释@MyAnnotation3(value = "Class GetMyAnnotation", multiValues = {"1","2"})public class GetMyAnnotation {// 为testField1属性附加MyAnnotation3 注释@MyAnnotation3(value = "call testField1", multiValues={"1"}, number = 1)private String testField1;// 为testMethod1方法附加MyAnnotation3 注释@MyAnnotation3(value = "call testMethod1", multiValues={"1", "2"}, number = 1)public void testMethod1() {}@Deprecated@MyAnnotation3(value = "call testMethod2", multiValues={"3", "4", "5"}) public void testMethod2() {}}
上面的例子GetMyAnnotation非常简单，里面没有任何功能，但是分别为类（class），属性（field），方法（method）申明（附加）了MyAnnotation3 注释。下面我们用程序TestMyAnnotation3对GetMyAnnotation里MyAnnotation3注释进行解析。运行时解析annotationTestMyAnnotation3.java
public class TestMyAnnotation3 {public static void main(String[] args) {System.out.println("–Class Annotations–");if (GetMyAnnotation.class.isAnnotationPresent(MyAnnotation3.class)) {System.out.println("[GetMyAnnotation].annotation:");MyAnnotation3 classAnnotation = GetMyAnnotation.class.getAnnotation(MyAnnotation3.class);printMyAnnotation3(classAnnotation);}System.out.println("–Fields Annotations–");Field [] fields = GetMyAnnotation.class.getDeclaredFields();for (Field field : fields) {if (field.isAnnotationPresent(MyAnnotation3.class)) {System.out.println("[GetMyAnnotation." + field.getName() + "].annotation:");MyAnnotation3 fieldAnnotation = field.getAnnotation(MyAnnotation3.class);printMyAnnotation3(fieldAnnotation);}}System.out.println("–Methods Annotations–");Method[] methods = GetMyAnnotation.class.getDeclaredMethods();for (Method method : methods) {System.out.println("[GetMyAnnotation." + method.getName() + "].annotation:");if (method.isAnnotationPresent(MyAnnotation3.class)) {MyAnnotation3 methodAnnotation = method.getAnnotation(MyAnnotation3.class);printMyAnnotation3(methodAnnotation);}}}private static void printMyAnnotation3(MyAnnotation3 annotation3) {if (annotation3 == null) {return;}System.out.println("{value=" + annotation3.value());String multiValues = "";for (String value: annotation3.multiValues()) {multiValues += "," + value;}System.out.println("multiValues=" + multiValues);System.out.println("number=" + annotation3.number() + "}");}}
输出：
–Class Annotations–[GetMyAnnotation].annotation:{value=Class GetMyAnnotationmultiValues=,1,2number=0}–Fields Annotations–[GetMyAnnotation.testField1].annotation:{value=call testField1multiValues=,1number=1}–Methods Annotations–[GetMyAnnotation.testMethod1].annotation:{value=call testMethod1multiValues=,1,2number=1}[GetMyAnnotation.testMethod2].annotation:{value=call testMethod2multiValues=,3,4,5number=0}
JDK1.5以后的版本提供的跟annotation有关的接口：
interface java.lang.reflect.AnnotatedElement {boolean isAnnotationPresent(Class<? extends Annotation> annotationClass);<T extends Annotation> T getAnnotation(Class<T> annotationClass);Annotation[] getAnnotations();Annotation[] getDeclaredAnnotations();}
该接口主要用来取得附加在类（class），构造方法（constructor），属性（field），方法（method），包（package）上的annotation信息。JDK1.5与此有关的几个类都实现了AnnotatedElement接口：
java.lang.reflect.AccessibleObject, java.lang.reflect.Class, java.lang.reflect.Constructor, java.lang.reflect.Field, java.lang.reflect.Method, java.lang.reflect.Package
所以可以利用反射（reflection）功能在程序里动态解析附加的annotation信息。总结：本文通过举例简单地说明了怎么动态解析annotation，大家可以举一反三，利用Java的annotation特性，完成更复杂功能等。
年轻是胜利的一半。
