| 由 “@+annotation类型+带有括号的成员-值列表”组成。这些成员的值必须是编译 时常量（即在运行时不变）。
A：下面是一个使用了RequestForEnhancement annotation的方法声明：
清单2:
@RequestForEnhancement(
id = 2868724,
synopsis = "Enable time-travel",
engineer = "Mr. Peabody",
date = "4/1/3007"
)
public static void travelThroughTime(Date destination) { ... }
B：当声明一个没有成员的annotation类型声明时，可使用以下方式：
清单3:
/**
* Indicates that the specification of the annotated API element
* is preliminary and subject to change.
*/
public @interface Preliminary { }
作为上面没有成员的annotation类型声明的简写方式：
清单4:
@Preliminary public class TimeTravel { ... }
C：如果在annotations中只有唯一一个成员，则该成员应命名为value：
清单5:
/**
* Associates a copyright notice with the annotated API element.
*/
public @interface Copyright {
String value();
}
更为方便的是对于具有唯一成员且成员名为value的annotation（如上文）， 在其使用时可以忽略掉成员名和赋值号（=）：
清单6:
@Copyright("2002 Yoyodyne Propulsion Systems")
public class OscillationOverthruster { ... }
Java Annotation入门(3)
时间:2011-05-20 blogjava cleverpig
3。一个使用实例：
结合上面所讲的，我们在这里建立一个简单的基于annotation测试框架。首先 我们需要一个annotation类型来表示某个方法是一个应该被测试工具运行的测试 方法。
清单7:
import java.lang.annotation.*;
/**
* Indicates that the annotated method is a test method.
* This annotation should be used only on parameterless static methods.
*/
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface Test { }
值得注意的是annotaion类型声明是可以标注自己的，这样的annotation被称 为“meta-annotations”。
在 上面的代码中，@Retention(RetentionPolicy.RUNTIME)这个meta- annotation表示了此类型的 annotation将被虚拟机保留使其能够在运行时通过反 射被读取。而@Target(ElementType.METHOD)表示此类型的 annotation只能用于 修饰方法声明。
下面是一个简单的程序，其中部分方法被上面的annotation所标注：
清单8:
public class Foo {
@Test public static void m1() { }
public static void m2() { }
@Test public static void m3() {
throw new RuntimeException("Boom");
}
public static void m4() { }
@Test public static void m5() { }
public static void m6() { }
@Test public static void m7() {
throw new RuntimeException("Crash");
}
public static void m8() { }
}
Here is the testing tool:
import java.lang.reflect.*;
public class RunTests {
public static void main(String[] args) throws Exception {
int passed = 0, failed = 0;
for (Method m : Class.forName(args[0]).getMethods()) {
if (m.isAnnotationPresent(Test.class)) {
try {
m.invoke(null);
|
