Java annotation入门：http://www.blogjava.net/ericwang/archive/2005/12/13/23743.html
Java annotation 手册： http://www.blogjava.net/mlh123caoer/archive/2007/09/06/143260.html
Java annotation 高级应用： http://www.blogjava.net/wuxufeng8080/articles/93046.html
试验代码：
客户端代码TestAnnotaion，这个客户端可以是一个AOP的advisor，也可以是框架的Controlller
package org.airlinkmatrix.sample;
import java.lang.reflect.Method;
import org.airlinkmatrix.sample.annotation.IsWired;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
@IsWired
public class TestAnnotation {
static private Log log = LogFactory.getLog(TestAnnotation.class);
@IsWired(kidding="are you crazy?")
private void wired(){
}
@IsWired public void wired1(int k){
}
public static void main(String[] args) {
Class clazz = TestAnnotation.class;
if (clazz.isAnnotationPresent(IsWired.class)){
log.info("class is wired!");
}
try {
Method[] methods = clazz.getMethods();
for (Method method : methods) {
if (method.isAnnotationPresent(IsWired.class)){
log.info("the method " + method.getName() +
" is wired!!");
}else{
log.info("the method " + method.getName() +
" is not wired!!");
}
}
} catch (SecurityException e) {
e.printStackTrace();
}
}
}
标注的定义代码：
package org.airlinkmatrix.sample.annotation;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
@Retention(RetentionPolicy.RUNTIME)
public @interface IsWired {
public String kidding() default "";
}
运行结果：
TestAnnotation - class is wired!
TestAnnotation - the method wired1 is wired!!
TestAnnotation - the method main is not wired!!
TestAnnotation - the method hashCode is not wired!!
TestAnnotation - the method getClass is not wired!!
TestAnnotation - the method wait is not wired!!
TestAnnotation - the method wait is not wired!!
TestAnnotation - the method wait is not wired!!
TestAnnotation - the method equals is not wired!!
TestAnnotation - the method notify is not wired!!
TestAnnotation - the method notifyAll is not wired!!
TestAnnotation - the method toString is not wired!!
按照我的理解，annotation的本意就是允许开发者描述程序元素（类、方法、属性等等）的元数据，这样会衍生出多种应用。
其一，就是代替以前的ad hoc annotation，例如XDoclect，transeint关键字，java doc某些标注，以及各种框架的配置中的某些内容（例如hibernate对PO的配置）。
其二，这是我自己想到的应用，其实annotation可以用作一个弱契约的接口，可以间接的实现多继承，这是非常令人兴奋的用法。
可能大家都知道interface vs abstract superclass的利弊考虑：用interface可以实现多继承，但麻烦之处在于必须每个“子类”都必须自己实现接口的方法，可能会有很多重复代码； 用abstract superclass可以提供缺省实现，子类可以不必重写该方法，但缺点是必须强迫子类显式地继承抽象父类，有时造成了不必要的侵入。
类似于接口的使用，annotation可以约定实现某个方法（例如getMethodName()）签名作为IoC回调方法。但这是个弱契约，编译器决不会检查和强制标注annotation的“子类”一定要实现annotation所约定的这个方法。框架或回调该“子类”的模板方法可以在子类没有提供getMethodName()的时候，由框架或模板方法自己提供缺省实现。 也就是说，annotaion达到了“声明即拥有”的奇效。 与interface不同，“子类”允许重写实现，但不必作强制实现，标注本身也不负责实现。相反，保证标注功能的实现的职责转移到了客户代码（框架或者模板方法）中。
进一步学习中，请大家不吝赐教。
