1、开发环境
l Eclipse 3.0.1
l AspectWerkz2.0 RC2(http://aspectwerkz.codehaus.org/releases.html)
l AspectWerkz Eclipse plugin 2.0.4(http://aspectwerkz.codehaus.org/downloads/eclipse)
2、对工程使能AspectWerkz
l 创建普通的Java工程:AWHello
l 右击工程名,选择Enable AspectWerkz AOP,使能AspectWerkz
l 在Error Log视图中可以查看插件产生的跟踪信息
3、添加依赖的JAR
目前的插件不会自动添加依赖的AspectWerkz JAR文件到工程中,需要手工添加,这些JAR文件包括(可以在AspectWerkz2.0 RC2的lib目录下找到):
l aspectwerkz-2.0.RC2.jar
l aspectwerkz-core-2.0.RC2.jar
l aspectwerkz-jdk14-2.0.RC2.jar(JDK1.4)或aspectwerkz-jdk5-2.0.RC2.jar(JDK1.5)
l concurrent-1.3.1.jar
l dom4j-1.4.jar
l jarjar-0.3.jar
l jrexx-1.1.1.jar
l piccolo-1.03.jar
l qdox-1.4.jar
l trove-1.0.2.jar
4、创建测试程序
package foo;
public class HelloWorld {
public static void main(String args[]) {
HelloWorld world = new HelloWorld();
world.greet();
}
public void greet() {
System.out.println("Hello World!");
}
}
5、编写Aspect
package foo;
import org.codehaus.aspectwerkz.joinpoint.JoinPoint;
public class MyAspect {
public void beforeGreeting(JoinPoint joinPoint) {
System.out.println("before greeting...");
}
public void afterGreeting(JoinPoint joinPoint) {
System.out.println("after greeting...");
}
}
l MyAspect类包含了用来编织到HelloWorld类中的代码
l 注意:Aspect方法必须包含JoinPoint参数
6、AOP编织(weaving)
l 使用META-INF/aop.xml来定义Aspect(通常位于工程的/src目录下)
<!DOCTYPE aspectwerkz PUBLIC "-//AspectWerkz//DTD//EN" "http://aspectwerkz.codehaus.org/dtd/aspectwerkz2.dtd">
<aspectwerkz>
<system id="AWHello">
<package name="foo">
<aspect class="MyAspect">
<pointcut name="greetMethod"
expression="execution(* foo.HelloWorld.greet(..))"/>
<advice name="beforeGreeting" type="before"
bind-to="greetMethod"/>
<advice name="afterGreeting" type="after"
bind-to="greetMethod"/>
</aspect>
</package>
</system>
</aspectwerkz>
l <package>标记:指定Aspect类所在的包路径
l <aspect>标记:指定Aspect类
l <pointcut>标记:指定在哪里插入Aspect方法(Pointcut)
Ø 该方法只是用来绑定后面<advice>标记指定的 Advice
Ø expression属性:必须是符合Join point选择模式语言的有效表达式,并且要确保全路径的类名包含到模式中
l <advice>标记:指定要插入的Aspect方法(Advice)
Ø name属性:指定Aspect类中对应的方法名
Ø type属性:指定Advice类型,可以是before、after或around
Ø bind-to属性:指定绑定的Pointcut
l 这个例子是在HelloWorld.greet()方法调用之前插入MyAspect.beforeGreeting()方法;在HelloWorld.greet()方法返回之后插入MyAspect.afterGreeting()方法
l 在保存文件时,触发Eclipse Build时,同样会触发基于有效META-INF/aop.xml文件或在Aspect中定义、被编译的Annotation(后面讲述)的AOP编织
7、AOP交叉视图支持
l AOP编织发生后,会在Advice应用的地方使用右指向标记来标记
l 点击该标记,显示Quick fix提示,包括该Join point处应用的Advice及其类型
l 点击具体Advice,会定位到该Advice的源代码处
l 对于当前插件,修改Aspect类不会更新标记处的信息
l 可以通过修改目标文件或手工执行clean build来实现更新
8、运行程序
l 首先要在工程build path中添加依赖的tools.jar(JAVA_HOME/lib/tools.jar)
l 选择Run > Run...
l 在左边列表中选择AspectWerkz Application,点击New按钮
l 后面就按正规应用程序的方法运行
l 本例的运行结果是:
before greeting...
Hello World!
after greeting...
9、Annotations支持
l Annotations提供了一种在Aspect类中添加元数据的方法,而不是在分离的文件(aop.xml)中指定
l 本插件包含了AspectWerkz Java 1.4 Annotation编译器,
l 在Aspect类源代码编译时,Annotations也会被编译
l 可以在Aspect类中使用JavaDoc风格的注释定义Annotations(JDK 1.4),下面是一个使用Annotations的Aspect类:
package foo;
import org.codehaus.aspectwerkz.joinpoint.StaticJoinPoint;
public class MyAspectWithAnnotations {
/**
* @Before execution(* foo.HelloWorld.greet(..))
*/
public void beforeGreeting(StaticJoinPoint joinPoint) {
System.out.println("before greeting with annotation...");
}
/**
* @After execution(* foo.HelloWorld.greet(..))
*/
public void afterGreeting(StaticJoinPoint joinPoint) {
System.out.println("after greeting with annotation...");
}
}
l 对于AspectWerkz 2.x版本,这里可以使用StaticJoinPoint来替代JoinPoint,以优化性能
l 使用Annotations意味着不需要在aop.xml中描述Aspect的细节,但是仍然需要指定Aspect类:
<!DOCTYPE aspectwerkz PUBLIC "-//AspectWerkz//DTD//EN" "http://aspectwerkz.codehaus.org/dtd/aspectwerkz2.dtd">
<aspectwerkz>
<system id="AWHello">
<package name="foo">
<aspect class="MyAspect">
<pointcut name="greetMethod"
expression="execution(* foo.HelloWorld.greet(..))"/>
<advice name="beforeGreeting" type="before"
bind-to="greetMethod"/>
<advice name="afterGreeting" type="after"
bind-to="greetMethod"/>
</aspect>
</package>
<aspect class="foo.MyAspectWithAnnotations"/>
</system>
</aspectwerkz>
l 重新运行的结果如下:
before greeting with annotation...
before greeting...
Hello World!
after greeting...
after greeting with annotation...