午后星期午

Spring AOP + AspectJ framework

AOP(Aspect Orient Programming),也就是常说的面向方面编程,它是作为面向对象编程的一种补充,专门用于处理系统中分布于各个模块(不同方法)

中的交叉关注点的问题,在 Java EE 应用中,常常通过 AOP 来处理一些具有横切性质的系统级服务,如事务管理、安全检查、缓存、对象池管理等。

简单点来说,它就是一个拦截器可以拦截一些进程,例如,当某个方法执行时,Spring AOP 可以拦截该执行的方法,并允许在方法执行之前或之后添加额外的功能,

以上如若解释的不好,勿喷 -_- ||

AspectJ 是一个基于 Java 语言的 AOP 框架,提供了强大的 AOP 功能,Spring 从 2.0 起,对 AspectJ 功能都提供了支持 .

几个常用的 AspectJ 注解 : 

    @Before   在方法执行前被执行

    @After     在方法执行后被执行

    @AfterReturning     在方法执行后被执行,并同时拦截方法返回的结果

    @AfterThrowing      在方法抛出异常时候被执行,若方法不抛出异常,则不会被执行

    @Around   这个,不知道要怎么解释了,比较不好解释,就像你拦截了一个方法,并在适当的时候给予放行,放行前后可以做额外的处理,下面看示例就很容易明白了

环境 :

 
eclipse  3.6
maven  3.0.4
spring   3.0.5
aspectj 1.6.11
 


pom.xml 清单 :

 
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation
="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  
<modelVersion>4.0.0</modelVersion>
  
<groupId>com.fancy</groupId>
  
<artifactId>spring-aop</artifactId>
  
<packaging>war</packaging>
  
<version>1.0</version>
  
<name>spring-aop Maven Webapp</name>
  
<url>http://maven.apache.org</url>
  
  
<properties>
    
<spring.version>3.0.5.RELEASE</spring.version>
    
<aspectj.version>1.6.11</aspectj.version>
  
</properties>
  
  
<dependencies>
    
    
<dependency>
      
<groupId>org.springframework</groupId>
      
<artifactId>spring-core</artifactId>
      
<version>${spring.version}</version>
    
</dependency>
 
    
<dependency>
      
<groupId>org.springframework</groupId>
      
<artifactId>spring-context</artifactId>
      
<version>${spring.version}</version>
    
</dependency>
 
    
<!-- Spring AOP + AspectJ -->
    
<dependency>
      
<groupId>org.springframework</groupId>
      
<artifactId>spring-aop</artifactId>
      
<version>${spring.version}</version>
    
</dependency>
 
    
<dependency>
      
<groupId>org.aspectj</groupId>
      
<artifactId>aspectjrt</artifactId>
      
<version>${aspectj.version}</version>
    
</dependency>
 
    
<dependency>
      
<groupId>org.aspectj</groupId>
      
<artifactId>aspectjweaver</artifactId>
      
<version>${aspectj.version}</version>
    
</dependency>
    
    
<dependency>
      
<groupId>junit</groupId>
      
<artifactId>junit</artifactId>
      
<version>4.7</version>
      
<scope>test</scope>
    
</dependency>
    
  
</dependencies>
  
  
<build>
    
<finalName>spring-aop</finalName>
  
</build>
  
</project>
 


applicationContext.xml 清单 :

 
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:p
="http://www.springframework.org/schema/p" xmlns:tx="http://www.springframework.org/schema/tx"
  xmlns:aop
="http://www.springframework.org/schema/aop" xmlns:context="http://www.springframework.org/schema/context"
  xsi:schemaLocation
="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
  http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.0.xsd
  http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.0.xsd
  http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd"
>
    
  
<!-- 开启注解 -->
  
<context:annotation-config/>
  
<!-- 自动扫描 -->
  
<context:component-scan base-package="com.fancy"/>
  
<!-- 启动 AspectJ 支持 -->
  
<aop:aspectj-autoproxy />
    
</beans>
 


还是来编写 HelloWorld :

1 . 编写 HelloWorld 接口

 
package com.fancy.service;

public interface HelloWorld {

    
public void sayHi();
    
    
public void sayHiAround(String username);
    
    
public void sayHiThrowException() throws Exception;
    
    
public String  sayHiReturnValue();
    
}
 


2 . 编写 HelloWorld 接口的实现,并将其注解成 spring 的一个组件

 
package com.fancy.service.impl;

import com.fancy.service.HelloWorld;
import org.springframework.stereotype.Component;

@Component
public class HelloWorldImpl implements HelloWorld {

    
public void sayHi() {
        
        System.out.println(
"sayHi ---->> Hi fancy !");
    }

    
public void sayHiAround(String username) {
        
        System.out.println(
"sayHiAround ---->> Hi " + username + " !");
    }

    
public void sayHiThrowException() throws Exception {
        
        System.out.println(
"sayHiThrowException ---->> Hi fancy !");
        
throw new Exception("Throw an exception here !!!!");
    }

    
public String sayHiReturnValue() {
        
        System.out.println(
"sayHiReturnValue ---->> Hi fancy !");
        
return "fancy";
    }
    
}
 


3 . 编写方面代码 :

AspectJ @Before 示例

 
package com.fancy.aspect;

import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Before;
import org.springframework.stereotype.Component;

@Aspect
@Component
public class MyAspect {

    @Before(
"execution (* com.fancy.service.HelloWorld.sayHi(..))")
    
public void logBefore(JoinPoint   joinPoint){
        
        System.out.println(
"logBefore() Method Invoke!");
        System.out.println(
"Hijack Method Name : " + joinPoint.getSignature().getName());
    }
    
}
 

其中,@Before("execution (* com.fancy.service.HelloWorld.sayHi(..))") 中的 execution (* com.fancy.service.HelloWorld.sayHi(..)) 是切入点表达式,

更多的帮助信息可以查看 spring 的帮助文档,spring 3.0.5 的帮助文档中是在 第 7  章的 7.2.3.4 小节,因为文档上说的也不是太清楚,在这里我也不好说话,

其中的 execution 是用于匹配方法执行的连接点,那个 * 号所占的位不知道是不是代表方法的访问权限,文档上没说,网上也没找到相关解释,哪位知道的望告知啊~~

接下来的 com.fancy.service.HelloWorld.sayHi 就很明显了,就是切入点方法名,再接下来的是 (..),(..) 代表匹配任意数量的参数,可以是 0 个也可以是多个 ;

如果你确定这个方法不需要参数,可以直接使用 (),还可以使用 (*) 来匹配一个任意类型的参数,还可以使用 (* , String),这样代表匹配两个参数,第二个参数必须是

String 类型的参数,这些在 spring 帮助文档的 7.2.3.4 小节都有说到,在这里就不多说了,可以自己去看,英文的看起来更带劲 *_*

再接下来的是 JoinPoint 接口,org.aspectj.lang.JoinPoint 接口表示的是目标类连接点对象,这个我也找不到相关的 API,只能手工整理一下了 :

JoinPoint     API 

     java.lang.Object                getThis() :获取代理对象本身;

     java.lang.Object           getTarget() :获取连接点所在的目标对象; 

    Signature                   getSignature() :获取连接点的方法签名对象; 

    java.lang.Object[]             getArgs():获取连接点方法运行时的入参列表; 
             

Junit 测试

 
package junit.test;

import org.junit.Test;
import org.junit.BeforeClass;
import com.fancy.service.HelloWorld;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;

public class TestApp {
    
    
private static ApplicationContext context = null;
    
    @BeforeClass
    
public static void setUpBeforeClass() throws Exception {

        context 
= new ClassPathXmlApplicationContext("applicationContext.xml");
    }
    
    @Test
    
public void testMethod() throws Exception{
        
        HelloWorld helloworld 
= (HelloWorld)context.getBean("helloWorldImpl");
        helloworld.sayHi();
    }

}
 

后台输出 :

 
logBefore() Method Invoke
!
Hijack Method Name : sayHi
sayHi 
---->> Hi fancy !
 


AspectJ @After 示例

 
package com.fancy.aspect;

import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.annotation.After;
import org.aspectj.lang.annotation.Aspect;
import org.springframework.stereotype.Component;

@Aspect
@Component
public class MyAspect {


    @After(
"execution (* com.fancy.service.HelloWorld.sayHi(..))")
    
public void logAfter(JoinPoint   joinPoint){
        
        System.out.println(
"logAfter() Method Invoke!");
        System.out.println(
"Hijack Method Name : " + joinPoint.getSignature().getName());
    }
    
}
 

Junit 测试

 
@Test
    
public void testMethod() throws Exception{
        
        HelloWorld helloworld 
= (HelloWorld)context.getBean("helloWorldImpl");
        helloworld.sayHi();
    }
 

后台输出 :

 
sayHi 
---->> Hi fancy !
logAfter() Method Invoke
!
Hijack Method Name : sayHi
 


AspectJ @AfterReturning 示例

 
package com.fancy.aspect;

import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.annotation.AfterReturning;
import org.aspectj.lang.annotation.Aspect;
import org.springframework.stereotype.Component;

@Aspect
@Component
public class MyAspect {


    @AfterReturning(pointcut 
= "execution (* com.fancy.service.HelloWorld.sayHiReturnValue(..))", returning = "returnValue")
    
public void logAfterReturning(JoinPoint   joinPoint, Object/*String*/ returnValue){
        
        System.out.println(
"logAfterReturning() Method Invoke!");
        System.out.println(
"Hijack Method Name : " + joinPoint.getSignature().getName());
        System.out.println(
"The Return Value Is : " + returnValue);
    }
    
}
 

Junit 测试

 
@Test
    
public void testMethod() throws Exception{
        
        HelloWorld helloworld 
= (HelloWorld)context.getBean("helloWorldImpl");
        helloworld.sayHiReturnValue();
    }
 

后台输出 :

 
sayHiReturnValue 
---->> Hi fancy !
logAfterReturning() Method Invoke
!
Hijack Method Name : sayHiReturnValue
The Return Value Is : fancy
 


AspectJ @AfterThrowing 示例

 
package com.fancy.aspect;

import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.annotation.AfterThrowing;
import org.aspectj.lang.annotation.Aspect;
import org.springframework.stereotype.Component;

@Aspect
@Component
public class MyAspect {


    @AfterThrowing(pointcut 
= "execution (* com.fancy.service.HelloWorld.sayHiThrowException(..))", throwing = "error")
    
public void logAfterThrowing(JoinPoint joinPoint, Throwable error){
        
        System.out.println(
"logAfterThrowing() Method Invoke!");
        System.out.println(
"Hijack Method Name : " + joinPoint.getSignature().getName());
        System.out.println(
"Exception Message  :" + error);
    }
    
}
 

Junit 测试

 
@Test
    
public void testMethod() throws Exception{
        
        HelloWorld helloworld 
= (HelloWorld)context.getBean("helloWorldImpl");
        helloworld.sayHiThrowException();
    }
 

后台输出 :

 
sayHiThrowException 
---->> Hi fancy !
logAfterThrowing() Method Invoke
!
Hijack Method Name : sayHiThrowException
Exception Message  :java.lang.Exception: Throw an exception here 
!!!!
 

若将 HelloWorldImpl 类中 sayHiThrowException 方法的异常抛出注释掉,

 
public void sayHiThrowException() throws Exception {
        
        System.out.println(
"sayHiThrowException ---->> Hi fancy !");
        
//throw new Exception("Throw an exception here !!!!");
    }
 

其余不变,再次执行 Junit 测试,后台输出 :

 
sayHiThrowException 
---->> Hi fancy !
 

这就说明,当该方法能够运行正常的时候,没有抛出异常,则,logAfterThrowing 不会被执行 .


AspectJ @Around 示例

 
package com.fancy.aspect;

import java.util.Arrays;

import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.Around;
import org.aspectj.lang.annotation.Aspect;
import org.springframework.stereotype.Component;

@Aspect
@Component
public class MyAspect {


    @Around(
"execution (* com.fancy.service.HelloWorld.sayHiAround(..))")
    
public void logAround(ProceedingJoinPoint   joinPoint) throws Throwable {
        
        System.out.println(
"logAround() Method Invoke!");
        System.out.println(
"Hijack Method Name  : " + joinPoint.getSignature().getName());
        System.out.println(
"Hijack Arguments Is : " + Arrays.toString(joinPoint.getArgs()));
        System.out.println(
"Around before : can do something here !");
        joinPoint.proceed(); 
//放行
        System.out.println("Around after  : can do something here !");
    }
    
}
 

Junit 测试

 
@Test
    
public void testMethod() throws Exception{
        
        HelloWorld helloworld 
= (HelloWorld)context.getBean("helloWorldImpl");
        helloworld.sayHiAround(
"fancy");
    }
 

后台输出 :

 
logAround() Method Invoke
!
Hijack Method Name  : sayHiAround
Hijack Arguments Is : [fancy]
Around before : can 
do something here !
sayHiAround 
---->> Hi fancy !
Around after  : can 
do something here !
 

其中,需要提一下 ProceedingJoinPoint 接口 :

ProceedingJoinPoint 继承于 JoinPoint,是其子接口,它新增了两个用于执行连接点方法的方法: 

     java.lang.Object proceed() throws java.lang.Throwable:通过反射执行目标对象的连接点处的方法; 

     java.lang.Object proceed(java.lang.Object[] args) throws java.lang.Throwable:通过反射执行目标对象连接点处的方法,不过使用新的入参替换原来的入参。


最后附上 spring 3.0.5 帮助文档中的一些信息 :

Some examples of common pointcut expressions are given below.

  • the execution of any public method:

    execution(public * *(..))
  • the execution of any method with a name beginning with "set":

    execution(* set*(..))
  • the execution of any method defined by the AccountService interface:

    execution(* com.xyz.service.AccountService.*(..))
  • the execution of any method defined in the service package:

    execution(* com.xyz.service.*.*(..))
  • the execution of any method defined in the service package or a sub-package:

    execution(* com.xyz.service..*.*(..))
  • any join point (method execution only in Spring AOP) within the service package:

    within(com.xyz.service.*)
  • any join point (method execution only in Spring AOP) within the service package or a sub-package:

    within(com.xyz.service..*)
  • any join point (method execution only in Spring AOP) where the proxy implements the AccountService interface:

    this(com.xyz.service.AccountService)

    'this' is more commonly used in a binding form :- see the following section on advice for how to make the proxy object available in the advice body.

  • any join point (method execution only in Spring AOP) where the target object implements the AccountService interface:

    target(com.xyz.service.AccountService)

    'target' is more commonly used in a binding form :- see the following section on advice for how to make the target object available in the advice body.

  • any join point (method execution only in Spring AOP) which takes a single parameter, and where the argument passed at runtime is Serializable:

    args(java.io.Serializable)

    'args' is more commonly used in a binding form :- see the following section on advice for how to make the method arguments available in the advice body.

    Note that the pointcut given in this example is different to execution(* *(java.io.Serializable)): the args version matches if the argument passed at runtime is Serializable, the execution version matches if the method signature declares a single parameter of type Serializable.

  • any join point (method execution only in Spring AOP) where the target object has an @Transactional annotation:

    @target(org.springframework.transaction.annotation.Transactional)

    '@target' can also be used in a binding form :- see the following section on advice for how to make the annotation object available in the advice body.

  • any join point (method execution only in Spring AOP) where the declared type of the target object has an @Transactional annotation:

    @within(org.springframework.transaction.annotation.Transactional)

    '@within' can also be used in a binding form :- see the following section on advice for how to make the annotation object available in the advice body.

  • any join point (method execution only in Spring AOP) where the executing method has an @Transactional annotation:

    @annotation(org.springframework.transaction.annotation.Transactional)

    '@annotation' can also be used in a binding form :- see the following section on advice for how to make the annotation object available in the advice body.

  • any join point (method execution only in Spring AOP) which takes a single parameter, and where the runtime type of the argument passed has the@Classified annotation:

    @args(com.xyz.security.Classified)

    '@args' can also be used in a binding form :- see the following section on advice for how to make the annotation object(s) available in the advice body.

  • any join point (method execution only in Spring AOP) on a Spring bean named 'tradeService':

    bean(tradeService)
  • any join point (method execution only in Spring AOP) on Spring beans having names that match the wildcard expression '*Service':

    bean(*Service)






















 




   [ 转载出处:http://www.blogjava.net/fancydeepin ]

posted on 2013-12-31 13:43 午后星期午 阅读(162) 评论(0)  编辑  收藏 所属分类: JavaEE


只有注册用户登录后才能发表评论。


网站导航: