show: step

version: 1.0

enable_checker: true

SpringFramework AOP简述

前言介绍

在前面章节的学习中,我们对Spring框架的IOC实现源码有了一定的了解,接着本文继续学习Springframework一个核心的技术点AOP技术。
在学习Spring AOP源码之前,您是否对AOP有足够熟悉的理解?在对应用都不熟悉之前就去学习源码,肯定是很难理解的,所以本文先不描述源码的实现,先通过本篇博客了解熟悉Spring AOP,然后再学习源码

什么是AOP技术?

引用Spring官网对AOP技术的概述:

Aspect-Oriented Programming (AOP) complements Object-Oriented Programming (OOP) by providing another way of thinking about program structure. The key unit of modularity in OOP is the class, whereas in AOP the unit of modularity is the aspect. Aspects enable the modularization of concerns such as transaction management that cut across multiple types and objects. (Such concerns are often termed crosscutting concerns in AOP literature.)

挑重点来说,所谓AOP(Aspect-Oriented Programming)也即面向方面的编程,是指通过跨领域关注点的分离来实现模块化的一种面向对象技术。

  • 跨领域也即跨多种类型和对象的事务管理等等;
  • 关注点通常被称为横切关注点,OOP中模块化的关键单元是类,而在AOP中模块化是方面关注点通常被称为横切关注点

    AOP的本质目的

    AOP本质:在不改变原有业务逻辑的情况下增强横切逻辑,这个横切逻辑可以是权限校验逻辑、日志监控、事务控制等等

    AOP相关知识详情可以参考:Spring AOP官方文档

AOP的相关术语

名词 描述
连接点(Joinpoint) 连接点是一个程序的执行,如方法的执行或异常的处理过程中的一个点
切入点(Pointcut) 指的是将增强代码织入到业务主线进来之后的连接点
通知/增强(Advice) Advice可以翻译为通知或者增强,指的是切面类中用于提供增强功能的方法
目标对象(Target) 指代理的目标对象,即被代理对象
代理(Proxy) 指一个类被AOP织入增强之后,产生的代理类,即代理对象
织入(Weaving) 指的是将增强(Advice)应用到目标对象(Target)产生代理对象(Proxy)的过程。ps:AspectJ采用的是编译期织入和类装载期织入,而Spring AOP采用的是动态代理织入
切面(Aspect) 切面也就是AOP的关注点,也就是说是Advice代码的关注点,切面是对上述概念的一个综合。将这些Advice代码放在一个类中,这个类就是切面类,切面类是跨多个类的关注点的模块化类

看了前面这些理论,您可能不是很理解,所以引用国外网站的图例进行说明AOP概念,图来自链接
9. SpringFramework AOP 简述 - 图1
综上所述,其实所谓的目的其实只是要锁定在某个切入点(Pointcut)织入(Weaving)特定的增强逻辑(Advice)

Spring AOP和AspectJ

有了前面对AOP概念的概述之后,我们能够大致理解AOP了,不过本文还是要理理Spring AOP和AspectJ的关系
9. SpringFramework AOP 简述 - 图2
Spring官网给指出了Spring AOP和AspectJ的关系,官网明确指出其立场,表明Spring AOP不会和AspectJ项目竞争哪个项目能提供更成熟的AOP解决方案,Spring AOP和AspectJ是一种互补的关系,Spring AOP无缝结合了IOC和AspectJ,从而使Spring AOP能够符合大部分的AOP需求,这是一种能提供代理对象的模式
从官网也可以知道了Spring AOP和AspectJ的大致关系,其实这是两种AOP的实现技术,Spring AOP是集成了AspectJ部分功能,同时结合IOC实现的,AspectJ则是一种比较完善成熟的AOP解决方案,接着本文做下简单对比

  • Spring AOP
    • Spring AOP是SpringFramework的组件,属于Springframework的一个比较核心的功能,Spring AOP是结合了AspectJ和IOC实现的,提供了AspectJ的功能
    • Spring AOP 致力于解决的是企业级开发中最普遍的 AOP 需求(方法织入),Spring AOP不会和AspectJ竞争
    • Spring AOP 只能作用于 Spring 容器中的 Bean
    • 性能方面,Spring AOP是在运行时进行动态织入的,所以性能比不上AspectJ
    • Spring AOP使用动态代理的方式进行方法织入,有两种动态代理方法,一种是CGLIB,另外一种是JDK提供的动态代理
      引用https://www.baeldung.com/spring-aop-vs-aspectj的图进行说明
      9. SpringFramework AOP 简述 - 图3
  • AspectJ
    • AspectJ来自Eclipse的开源项目,链接:https://www.eclipse.org/aspectj
    • AspectJ是一种比较成熟的AOP解决方案,能够提供比Spring AOP更多的AOP功能
    • AspectJ的方法织入属于静态织入,它的织入时机可以是:compile-time(编译期)、post-compile(编译后)、load-time(JVM类加载器加载时候)
    • AspectJ在编译时进行方法织入,所以性能比Spring AOP好

ok,前面已经简单列举了Spring AOP和AspectJ的主要不同,现在可以用表格列举出不同点对比,表格参考自国外网站

对比 Spring AOP AspectJ
实现语言 使用存Java语言 使用Java编程语言的扩展实现
编译过程 无需单独的编译过程 除非设置了LTW,否则需要AspectJ编译器(ajc)
织入时机 动态代理,在运行时织入 静态织入,在编译过程织入,它的织入时机可以是:compile-time(编译期)、post-compile(编译后)、load-time(JVM类加载器加载时候)
功能 基本的方法织入 可以编织字段,方法,构造函数,静态初始值设定项,最终类/方法等…
范围 只能作用于Spring容器管理的bean上 可以作用于所有领域对象上实施
性能 比AspectJ慢得多 更好的性能(编译时编织比运行时编织要快得多)
学习 易于学习和应用 比Spring AOP复杂

补充,AspectJ静态织入时机:

  • compile-time weaving:编译期织入,在编译时候就直接进行方法织入,直接编译出包含织入代码的 .class 文件
  • post-compile weaving:编译后织入,也可以称之为二进制织入,它将Advice织入于编织后现有的类文件和JAR文件
  • Load-time weaving(LTW):指的是在加载类的时候进行织入,与以前的二进制编织完全一样,不同之处在于编织被推迟到类加载器将类文件加载到JVM的过程

Spring中AOP代理选择

在前面知识,我们知道Spring AOP是使用动态代理技术实现Spring AOP中的代理选择,方法织入实现有两种方法,一种是JDK动态代理,一种是CGLIB

  • 默认情况下,Spring框架会根据被代理对象(Target Object)是否实现接口来选择JDK还是CGLIB。如果被代理对象没有实现任何接口,Spring会选择CGLIB,如果被代理对象有实现接口,Spring会选择JDK提供的动态代理。
  • ps:虽然默认情况是这样的,不过我们可以通过配置的方式来自定义选择动态代理方式

实验环境准备参考

学习了前面的理论知识之后,现在可以通过例子进行实践,实践之前,您需要如下的环境准备,实验环境参考:

  • SpringFramework版本
    • Springframework5.0.x
  • 开发环境

    • JAR管理:gradle 4.9/ Maven3.+
    • 开发IDE:IntelliJ IDEA 2018.2.5
    • JDK:jdk1.8.0_31
    • Git Server:Git fro window 2.8.3
    • Git Client:SmartGit18.1.5(可选)

      Spring AOP实现方式

      在Spring AOP中,主要提供了三种配置方式:
  • Spring1.2 基于接口的配置:Spring最早的AOP实现是基于Spring提供的AOP接口实现的,通过实现接口,进行Advice逻辑代码编写等等

  • Spring2.0+ schema-based 配置 :Spring2.0之后,提供了 schema-based 配置,也就是xml类型的配置,使用命名空间<aop>
  • Spring2.0+ @Aspect配置:Spring2.0之后,也提供了@Aspect这种方法,@Aspect是用AspectJ的jar,但是实现是Spring AOP自己实现的

    Spring AOP例子参考

    前面介绍了Spring AOP实现的三种方式,接着本文通过代码例子进行验证:
    maven配置
    1. <properties>
    2. <springframework.version>5.0.19.RELEASE</springframework.version>
    3. <aspectj.version>1.9.4</aspectj.version>
    4. </properties>
    5. <dependencies>
    6. <!-- Spring aop配置-->
    7. <dependency>
    8. <groupId>org.springframework</groupId>
    9. <artifactId>spring-aop</artifactId>
    10. <version>${springframework.version}</version>
    11. </dependency>
    12. <!-- 本文的测试类需要 ioc配置-->
    13. <dependency>
    14. <groupId>org.springframework</groupId>
    15. <artifactId>spring-context</artifactId>
    16. <version>${springframework.version}</version>
    17. </dependency>
    18. <!-- @Aspect才需要加上-->
    19. <dependency>
    20. <groupId>org.aspectj</groupId>
    21. <artifactId>aspectjweaver</artifactId>
    22. <version>${aspectj.version}</version>
    23. </dependency>
    24. </dependencies>

    Spring1.2 基于接口的配置

    基础类编写

    User.java
    1. package com.example.spring.aop.bean;
    2. public class User {
    3. private String username;
    4. private String password;
    5. public String getUsername() {
    6. return username;
    7. }
    8. public void setUsername(String username) {
    9. this.username = username;
    10. }
    11. public String getPassword() {
    12. return password;
    13. }
    14. public void setPassword(String password) {
    15. this.password = password;
    16. }
    17. @Override
    18. public String toString() {
    19. return "User{" +
    20. "username='" + username + '\'' +
    21. ", password='" + password + '\'' +
    22. '}';
    23. }
    24. }
    UserService .java:
    1. package com.example.spring.aop.service;
    2. import com.example.spring.aop.bean.User;
    3. /**
    4. *
    5. <pre>
    6. * UserService
    7. * </pre>
    8. *
    9. *
    10. <pre>
    11. * @author mazq
    12. * 修改记录
    13. * 修改后版本: 修改人: 修改日期: 2020/11/20 18:02 修改内容:
    14. * </pre>
    15. */
    16. public interface UserService {
    17. User addUser(User user);
    18. User getUser();
    19. }
    UserServiceImpl .java
    1. package com.example.spring.aop.service.impl;
    2. import com.example.spring.aop.bean.User;
    3. import com.example.spring.aop.service.UserService;
    4. import org.springframework.beans.BeanUtils;
    5. import org.springframework.stereotype.Service;
    6. /**
    7. *
    8. <pre>
    9. * UserServiceImpl
    10. * </pre>
    11. *
    12. *
    13. <pre>
    14. * @author mazq
    15. * 修改记录
    16. * 修改后版本: 修改人: 修改日期: 2020/11/20 17:57 修改内容:
    17. * </pre>
    18. */
    19. @Service
    20. public class UserServiceImpl implements UserService {
    21. private static User user = null;
    22. @Override
    23. public User addUser(User userDto) {
    24. user = new User();
    25. BeanUtils.copyProperties(userDto,user);
    26. return user;
    27. }
    28. @Override
    29. public User getUser() {
    30. return user;
    31. }
    32. }

    使用Advice接口

    LogMethodBeforeAdvice .java
    1. package com.example.spring.aop.core.advice;
    2. import org.springframework.aop.MethodBeforeAdvice;
    3. import java.lang.reflect.Method;
    4. import java.util.Arrays;
    5. /**
    6. *
    7. <pre>
    8. * LogMethodBeforeAdvice
    9. * </pre>
    10. *
    11. *
    12. <pre>
    13. * @author mazq
    14. * 修改记录
    15. * 修改后版本: 修改人: 修改日期: 2020/11/20 17:38 修改内容:
    16. * </pre>
    17. */
    18. public class LogMethodBeforeAdvice implements MethodBeforeAdvice {
    19. @Override
    20. public void before(Method method, Object[] args, Object target) throws Throwable {
    21. System.out.println(String.format("执行方法:%s,参数列表:%s", method.getName(), Arrays.toString(args) ));
    22. }
    23. }
    LogAfterReturningAdvice .java
    1. package com.example.spring.aop.core.advice;
    2. import org.springframework.aop.AfterReturningAdvice;
    3. import java.lang.reflect.Method;
    4. /**
    5. *
    6. <pre>
    7. * LogAfterReturningAdvice
    8. * </pre>
    9. *
    10. *
    11. <pre>
    12. * @author mazq
    13. * 修改记录
    14. * 修改后版本: 修改人: 修改日期: 2020/11/20 17:41 修改内容:
    15. * </pre>
    16. */
    17. public class LogAfterReturningAdvice implements AfterReturningAdvice {
    18. @Override
    19. public void afterReturning(Object returnValue, Method method, Object[] args, Object target) throws Throwable {
    20. System.out.println(String.format("方法返回:%s", returnValue ));
    21. }
    22. }
    spring_interfaces_config.xml:
    1. <?xml version="1.0" encoding="UTF-8"?>
    2. <beans xmlns="http://www.springframework.org/schema/beans"
    3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    4. xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">
    5. <!-- 具体业务实现类(target Object)-->
    6. <bean id="userServiceTarget" class="com.example.spring.aop.service.impl.UserServiceImpl"></bean>
    7. <!-- 实现MethodBeforeAdvice-->
    8. <bean id="logMethodBeforeAdvice" class="com.example.spring.aop.core.advice.LogMethodBeforeAdvice"></bean>
    9. <!-- 实现AfterReturningAdvice-->
    10. <bean id = "logAfterReturningAdvice" class="com.example.spring.aop.core.advice.LogAfterReturningAdvice"></bean>
    11. <bean id="userServiceProxy" class="org.springframework.aop.framework.ProxyFactoryBean">
    12. <!-- 配置代理接口 proxy-->
    13. <property name="proxyInterfaces">
    14. <list>
    15. <value>com.example.spring.aop.service.UserService</value>
    16. </list>
    17. </property>
    18. <!-- 配置目标对象,也就是被代理类,具体业务实现类-->
    19. <property name="target" ref="userServiceTarget"></property>
    20. <!-- 配置拦截器,可以配置advice、advisor、interceptor -->
    21. <property name="interceptorNames">
    22. <list>
    23. <value>logMethodBeforeAdvice</value>
    24. <value>logAfterReturningAdvice</value>
    25. </list>
    26. </property>
    27. </bean>
    28. </beans>
    TestApplication.java:
    1. package com.example.spring.aop;
    2. import com.example.spring.aop.bean.User;
    3. import com.example.spring.aop.service.UserService;
    4. import org.springframework.context.ApplicationContext;
    5. import org.springframework.context.support.ClassPathXmlApplicationContext;
    6. public class TestApplication {
    7. public static void testAopProxy() {
    8. ApplicationContext ioc = new ClassPathXmlApplicationContext("classpath:spring_interfaces_config.xml");
    9. UserService userService = (UserService) ioc.getBean("userServiceProxy");
    10. User userDto = new User();
    11. userDto.setUsername("tom");
    12. userDto.setPassword("11");
    13. userService.addUser(userDto);
    14. System.out.println(String.format("用户数据打印:%s",userService.getUser().toString()));
    15. }
    16. public static void main(String[] args) {
    17. testAopProxy();
    18. }
    19. }

    执行方法:addUser,参数列表:[User{username=’tom’, password=’11’}] 方法返回:User{username=’tom’, password=’11’} 执行方法:getUser,参数列表:[] 方法返回:User{username=’tom’, password=’11’} 用户数据打印:User{username=’tom’, password=’11’}

使用Advisor接口

  • NameMatchMethodPointcutAdvisor使用
    定义一个只会拦截查询方法的Advisor,修改配置:

    1. <!-- 定义一个只会拦截查询方法的Advisor -->
    2. <bean id="logOnlyObtainQueryAdvisor" class="org.springframework.aop.support.NameMatchMethodPointcutAdvisor">
    3. <!-- 定义Advice类 -->
    4. <property name="advice" ref="logMethodBeforeAdvice"></property>
    5. <!-- 只有查询方法才会被拦截 -->
    6. <property name="mappedNames" value="getUser"></property>
    7. </bean>
    8. <bean id="userServiceProxy" class="org.springframework.aop.framework.ProxyFactoryBean">
    9. <!-- 配置代理接口 proxy-->
    10. <property name="proxyInterfaces">
    11. <list>
    12. <value>com.example.spring.aop.service.UserService</value>
    13. </list>
    14. </property>
    15. <!-- 配置目标对象,也就是被代理类,具体业务实现类-->
    16. <property name="target" ref="userServiceTarget"></property>
    17. <!-- 配置拦截器,可以配置advice、advisor、interceptor -->
    18. <property name="interceptorNames">
    19. <list>
    20. <value>logOnlyObtainQueryAdvisor</value>
    21. </list>
    22. </property>
    23. </bean>

    执行方法:getUser,参数列表:[] 用户数据打印:User{username=’tom’, password=’11’}

  • RegexpMethodPointcutAdvisor使用
    前面介绍了NameMatchMethodPointcutAdvisor,不过不够通用,所以Spring aop还提供了RegexpMethodPointcutAdvisor,可以支持正则表达式

    1. <!-- 定义支持正则匹配的Advisor,只拦截查询方法-->
    2. <bean id="regexpMethodAdvisor" class="org.springframework.aop.support.RegexpMethodPointcutAdvisor">
    3. <property name="advice" ref="logMethodBeforeAdvice"></property>
    4. <property name="pattern" value="com.example.spring.aop.*.service.*.get.*"></property>
    5. </bean>
    6. <bean id="userServiceProxy" class="org.springframework.aop.framework.ProxyFactoryBean">
    7. <!-- 配置代理接口 proxy-->
    8. <property name="proxyInterfaces">
    9. <list>
    10. <value>com.example.spring.aop.service.UserService</value>
    11. </list>
    12. </property>
    13. <!-- 配置目标对象,也就是被代理类,具体业务实现类-->
    14. <property name="target" ref="userServiceTarget"></property>
    15. <!-- 配置拦截器,可以配置advice、advisor、interceptor -->
    16. <property name="interceptorNames">
    17. <list>
    18. <value>regexpMethodAdvisor</value>
    19. </list>
    20. </property>
    21. </bean>

    执行方法:getUser,参数列表:[] 用户数据打印:User{username=’tom’, password=’11’}

Interceptor接口使用

TestMethodInterceptor .java:

  1. package com.example.spring.aop.core.interceptor;
  2. import org.aopalliance.intercept.MethodInterceptor;
  3. import org.aopalliance.intercept.MethodInvocation;
  4. /**
  5. *
  6. <pre>
  7. * TestMethodInterceptor
  8. * </pre>
  9. *
  10. *
  11. <pre>
  12. * @author mazq
  13. * 修改记录
  14. * 修改后版本: 修改人: 修改日期: 2020/11/23 10:28 修改内容:
  15. * </pre>
  16. */
  17. public class TestMethodInterceptor implements MethodInterceptor {
  18. @Override
  19. public Object invoke(MethodInvocation methodInvocation) throws Throwable {
  20. System.out.println(String.format("方法调用前(before method invoke) :%s",methodInvocation));
  21. Object implObj = methodInvocation.proceed();
  22. System.out.println(String.format("方法调用后(after method invoke) :%s",implObj));
  23. return implObj;
  24. }
  25. }

修改配置文件:

  1. <!-- 定义MethodInterceptor -->
  2. <bean id="methodInterceptor" class="com.example.spring.aop.core.interceptor.TestMethodInterceptor"></bean>
  3. <bean id="userServiceProxy" class="org.springframework.aop.framework.ProxyFactoryBean">
  4. <!-- 配置代理接口 proxy-->
  5. <property name="proxyInterfaces">
  6. <list>
  7. <value>com.example.spring.aop.service.UserService</value>
  8. </list>
  9. </property>
  10. <!-- 配置目标对象,也就是被代理类,具体业务实现类-->
  11. <property name="target" ref="userServiceTarget"></property>
  12. <!-- 配置拦截器,可以配置advice、advisor、interceptor -->
  13. <property name="interceptorNames">
  14. <list>
  15. <value>logMethodBeforeAdvice</value>
  16. <value>logAfterReturningAdvice</value>
  17. <value>methodInterceptor</value>
  18. </list>
  19. </property>
  20. </bean>

挑addUser方法的日志信息:

方法调用前(before method invoke) :ReflectiveMethodInvocation: public abstract com.example.spring.aop.bean.User com.example.spring.aop.service.UserService.addUser(com.example.spring.aop.bean.User); target is of class [com.example.spring.aop.service.impl.UserServiceImpl]

方法调用后(after method invoke) :User{username=’tom’, password=’11’}

beanNameAutoProxy使用

前面介绍了ProxyFactoryBean配置对应的业务代理进行调用,不过不够灵活,所以Spring中还提供了beanNameAutoProxy,这种方式是自动匹配beanName id,不需要每个业务都配对应的proxy进行代理
新建一个新的配置文件,spring_beanNameAutoProxy_config.xml:

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <beans xmlns="http://www.springframework.org/schema/beans"
  3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4. xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">
  5. <!-- 具体业务实现类(target Object)-->
  6. <bean id="userServiceTarget" class="com.example.spring.aop.service.impl.UserServiceImpl"></bean>
  7. <!-- 实现MethodBeforeAdvice-->
  8. <bean id="logMethodBeforeAdvice" class="com.example.spring.aop.core.advice.LogMethodBeforeAdvice"></bean>
  9. <!-- 实现AfterReturningAdvice-->
  10. <bean id = "logAfterReturningAdvice" class="com.example.spring.aop.core.advice.LogAfterReturningAdvice"></bean>
  11. <!-- 定义MethodInterceptor -->
  12. <bean id="methodInterceptor" class="com.example.spring.aop.core.interceptor.TestMethodInterceptor"></bean>
  13. <!-- 定义BeanNameAutoProxyCreator -->
  14. <bean id="autoProxyCreator" class="org.springframework.aop.framework.autoproxy.BeanNameAutoProxyCreator">
  15. <!-- interceptorNames可以配置advice、advisor、interceptor-->
  16. <property name="interceptorNames">
  17. <list>
  18. <value>logMethodBeforeAdvice</value>
  19. <value>logAfterReturningAdvice</value>
  20. <value>methodInterceptor</value>
  21. </list>
  22. </property>
  23. <!-- 注意:beanNames这里是拦截对应的实现类bean id,eg:userServiceTarget-->
  24. <property name="beanNames" value="*ServiceTarget"></property>
  25. </bean>
  26. </beans>

TestApplication.java:

  1. package com.example.spring.aop;
  2. import com.example.spring.aop.bean.User;
  3. import com.example.spring.aop.service.UserService;
  4. import org.springframework.context.ApplicationContext;
  5. import org.springframework.context.support.ClassPathXmlApplicationContext;
  6. public class TestApplication {
  7. public static void testBeanNameAutoProxy() {
  8. ApplicationContext ioc = new ClassPathXmlApplicationContext("classpath:spring_beanNameAutoProxy_config.xml");
  9. UserService userService = ioc.getBean(UserService.class);
  10. User userDto = new User();
  11. userDto.setUsername("tom");
  12. userDto.setPassword("11");
  13. userService.addUser(userDto);
  14. System.out.println(String.format("用户数据打印:%s",userService.getUser().toString()));
  15. }
  16. public static void main(String[] args) {
  17. // BeanNameAutoProxyCreator
  18. testBeanNameAutoProxy();
  19. }
  20. }

Spring2.0+ @Aspect配置

@Aspect这种方式是比较常用的,pom需要加上aspectjweaver配置,spring aop引用了aspectJ的api,但是实现是spring自己进行实现拓展的

启用@AspectJ支持

注解方式,使用@EnableAspectJAutoProxy开启

  1. @Configuration
  2. @EnableAspectJAutoProxy
  3. public class AppConfig {
  4. }

xml方式,可以使用<aop:aspectj-autoproxy/>开启

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <beans xmlns="http://www.springframework.org/schema/beans"
  3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:aop="http://www.springframework.org/schema/aop"
  4. xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/aop https://www.springframework.org/schema/aop/spring-aop.xsd">
  5. <aop:aspectj-autoproxy/>
  6. </beans>

声明方面

xml方式:

  1. <bean id="myAspect" class="org.xyz.NotVeryUsefulAspect">
  2. <!-- configure properties of aspect here as normal -->
  3. </bean>

java方式,使用注解@Aspect

  1. package org.xyz;
  2. import org.aspectj.lang.annotation.Aspect;
  3. @Aspect
  4. public class NotVeryUsefulAspect {
  5. }

声明切入点

切入点(Pointcut)的类型,Spring官网给出了比较详情的介绍:
9. SpringFramework AOP 简述 - 图4
在官网的建议是声明一个通用的SystemArchitecture

  1. package com.xyz.someapp;
  2. import org.aspectj.lang.annotation.Aspect;
  3. import org.aspectj.lang.annotation.Pointcut;
  4. @Aspect
  5. public class SystemArchitecture {
  6. /**
  7. * A join point is in the web layer if the method is defined
  8. * in a type in the com.xyz.someapp.web package or any sub-package
  9. * under that.
  10. */
  11. @Pointcut("within(com.xyz.someapp.web..*)")
  12. public void inWebLayer() {}
  13. /**
  14. * A join point is in the service layer if the method is defined
  15. * in a type in the com.xyz.someapp.service package or any sub-package
  16. * under that.
  17. */
  18. @Pointcut("within(com.xyz.someapp.service..*)")
  19. public void inServiceLayer() {}
  20. /**
  21. * A join point is in the data access layer if the method is defined
  22. * in a type in the com.xyz.someapp.dao package or any sub-package
  23. * under that.
  24. */
  25. @Pointcut("within(com.xyz.someapp.dao..*)")
  26. public void inDataAccessLayer() {}
  27. /**
  28. * A business service is the execution of any method defined on a service
  29. * interface. This definition assumes that interfaces are placed in the
  30. * "service" package, and that implementation types are in sub-packages.
  31. *
  32. * If you group service interfaces by functional area (for example,
  33. * in packages com.xyz.someapp.abc.service and com.xyz.someapp.def.service) then
  34. * the pointcut expression "execution(* com.xyz.someapp..service.*.*(..))"
  35. * could be used instead.
  36. *
  37. * Alternatively, you can write the expression using the 'bean'
  38. * PCD, like so "bean(*Service)". (This assumes that you have
  39. * named your Spring service beans in a consistent fashion.)
  40. */
  41. @Pointcut("execution(* com.xyz.someapp..service.*.*(..))")
  42. public void businessService() {}
  43. /**
  44. * A data access operation is the execution of any method defined on a
  45. * dao interface. This definition assumes that interfaces are placed in the
  46. * "dao" package, and that implementation types are in sub-packages.
  47. */
  48. @Pointcut("execution(* com.xyz.someapp.dao.*.*(..))")
  49. public void dataAccessOperation() {}
  50. }

因为官网的介绍比较详细,所以本博客只挑部分比较重要的进行介绍:

  • execution
    execution:执行,这是最基本的切入点类型:
    1. // 匹配UserService里的任何方法
    2. @Pointcut("execution(* com.example.spring.aop.service.UserService.*(..))")
    3. public void regexpExecution(){}

    ps:第一个*表示匹配任何返回值,第二个*表示匹配任何方法,(..)表示匹配任何数量的方法参数

eg:execution(* *..find*(Long,..))用于匹配方法名为find…,而第一个参数是long类型的

  1. @Pointcut("within(com.example.spring.aop..*) && execution(* *..find*(Long,..))")
  2. public void regexpExecutionByMethodName(){}
  • within
    within:表示服务包中的任何连接点(仅在Spring AOP中执行方法)

    1. @Pointcut("within(com.example.spring.aop..*)")
  • this和target
    前者在Spring AOP创建基于CGLIB的代理时起作用,而后者在创建基于JDK的代理时使用

如下实例代码:

  1. public class UserServiceImpl implements UserService {
  2. //...
  3. }

对于UserService,使用target,这种情况是基于CGLIB的代理

  1. @Pointcut("target(com.example.spring.aop.service.UserService)")

对于UserService,使用this,这种情况是基于JDK的代理

  1. @Pointcut("this(com.example.spring.aop.service.impl.UserServiceImpl)")
  • args
    限制匹配点(参数是给定类型的实例)的连接点(使用Spring AOP时方法的执行)
  • _@_target
    @target不要和target混淆了,其中类的执行的对象的具有给定类型的注释

    1. @Pointcut("@target(org.springframework.stereotype.Repository)")
  • _@_args
    @args其中传递的实际参数的运行时类型具有给定类型的注释

    1. package com.example.spring.aop.annotation;
    2. import java.lang.annotation.ElementType;
    3. import java.lang.annotation.Retention;
    4. import java.lang.annotation.RetentionPolicy;
    5. import java.lang.annotation.Target;
    6. @Retention(RetentionPolicy.RUNTIME)
    7. // 作用于类
    8. @Target(ElementType.TYPE)
    9. public @interface Entity {
    10. }
    1. @Pointcut("within(com.example.spring.aop..*) && @args(com.example.spring.aop.annotation.Entity)")
    2. public void argsMethod(){}
  • _@_within
    将匹配限制为具有给定注释的类型内的连接点

    1. Pointcut("@within(org.springframework.stereotype.Repository)")

    等效于:

    1. @Pointcut("within(@org.springframework.stereotype.Repository *)")
  • _@_annotation
    这个@annotation是用于匹配注解的,比较常用,我们可以自己写个注解类:

    1. package com.example.spring.aop.annotation;
    2. import java.lang.annotation.ElementType;
    3. import java.lang.annotation.Retention;
    4. import java.lang.annotation.RetentionPolicy;
    5. import java.lang.annotation.Target;
    6. /**
    7. *
    8. <pre>
    9. * EnableLog
    10. * </pre>
    11. *
    12. *
    13. <pre>
    14. * @author mazq
    15. * 修改记录
    16. * 修改后版本: 修改人: 修改日期: 2020/11/23 18:27 修改内容:
    17. * </pre>
    18. */
    19. @Retention(RetentionPolicy.RUNTIME)
    20. // 作用于方法
    21. @Target(ElementType.METHOD)
    22. public @interface EnableLog {
    23. }

    然后,在对应方法加上@EnableLog的方法都能被拦截到:

    1. @Pointcut("within(com.example.spring.aop..*) && @annotation(com.example.spring.aop.annotation.EnableLog)")
    2. public void annotationMethod(){}
  • 组合表达式
    组合表达式可以使用&&,||和!进行组合

    1. @Pointcut("within(com.example.spring.aop..*) && execution(public String com.example.spring.aop.service.UserService.*(..))")

    声明Advice类型

    Advice类型,Spring官网也有比较详细的介绍:
    9. SpringFramework AOP 简述 - 图5
    归纳一下通知类型:

  • 前置通知(@Before):在方法执行之前,使用@Before注释声明

  • 后置通知(@AfterReturning):当匹配的方法执行正常返回时运行建议。它使用@AfterReturning注释声明
  • 异常通知(@AfterThrowing):程序抛出异常后执行,不抛异常不会调用,使用@AfterThrowing注释声明
  • 最后通知(@After):匹配的方法执行退出,如果是有try…catch,一般是在finally执行完成后,使用@After注释声明
  • 环绕通知(@Around):围绕建议在匹配的方法执行过程中“围绕”运行。它有机会在该方法执行之前和之后进行工作,并确定该方法何时,如何以及什至完全可以执行,使用@Around注释声明
    1. package com.example.spring.aop.config;
    2. import com.example.spring.aop.service.UserService;
    3. import com.example.spring.aop.service.impl.UserServiceImpl;
    4. import org.aspectj.lang.JoinPoint;
    5. import org.aspectj.lang.ProceedingJoinPoint;
    6. import org.aspectj.lang.annotation.*;
    7. import org.springframework.context.annotation.Bean;
    8. import org.springframework.context.annotation.Configuration;
    9. import org.springframework.context.annotation.EnableAspectJAutoProxy;
    10. import java.text.SimpleDateFormat;
    11. import java.util.Arrays;
    12. import java.util.Date;
    13. /**
    14. *
    15. <pre>
    16. * SpringAspectJConfiguration
    17. * </pre>
    18. *
    19. *
    20. <pre>
    21. * @author mazq
    22. * 修改记录
    23. * 修改后版本: 修改人: 修改日期: 2020/11/24 10:52 修改内容:
    24. * </pre>
    25. */
    26. @Configuration
    27. @EnableAspectJAutoProxy(proxyTargetClass = false)
    28. @Aspect
    29. public class SpringAspectJConfiguration {
    30. @Bean
    31. public UserService userService(){
    32. return new UserServiceImpl();
    33. }
    34. private ThreadLocal<SimpleDateFormat> simpleDateFormat =new ThreadLocal<SimpleDateFormat>(){
    35. @Override
    36. protected SimpleDateFormat initialValue() {
    37. //return super.initialValue();
    38. return new SimpleDateFormat("[yyyy-mm-dd hh:mm:ss:SSS]");
    39. }
    40. };
    41. //---------------------------------------------------------------------
    42. // Types of pointcut
    43. //---------------------------------------------------------------------
    44. @Pointcut("within(com.example.spring.aop..*) && execution(public String com.example.spring.aop.service.UserService.*(..))")
    45. public void regexpExecution(){}
    46. @Pointcut("within(com.example.spring.aop..*) && execution(* *..find*(Long,..))")
    47. public void regexpExecutionByMethodName(){}
    48. @Pointcut("within(com.example.spring.aop..*) && target(com.example.spring.aop.service.UserService)")
    49. public void targetInterface(){}
    50. @Pointcut("within(com.example.spring.aop..*) && @args(com.example.spring.aop.annotation.Entity)")
    51. public void argsMethod(){}
    52. @Pointcut("within(com.example.spring.aop..*) && @annotation(com.example.spring.aop.annotation.EnableLog)")
    53. public void annotationMethod(){}
    54. //---------------------------------------------------------------------
    55. // Types of advice
    56. //---------------------------------------------------------------------
    57. @Before(value = "regexpExecution()")
    58. public void beforeAdvice(JoinPoint joinPoint){
    59. Object[] args = joinPoint.getArgs();
    60. String methodName = joinPoint.getSignature().getName();
    61. System.out.println(String.format("前置通知:beforeAdvice,参数是:%s", Arrays.toString(args)));
    62. System.out.println(simpleDateFormat.get().format(new Date()) + methodName);
    63. }
    64. @AfterReturning(value = "regexpExecution()", returning = "returnVal")
    65. public void afterReturningAdvice(Object returnVal){
    66. System.out.println(String.format("后置通知:afterReturningAdvice,返回参数是:%s", returnVal));
    67. }
    68. @AfterThrowing(value = "regexpExecution()", throwing = "e")
    69. public void afterThrowingAdvice(Throwable e) {
    70. System.out.println(String.format("异常通知:afterThrowingAdvice,异常信息:%s", e));
    71. }
    72. @After(value = "regexpExecution()")
    73. public void afterAdvice() {
    74. System.out.println(String.format("最后通知:afterAdvice"));
    75. }
    76. @Around(value = "regexpExecution()")
    77. public Object aroundAdvice(ProceedingJoinPoint proceedingJoinPoint) {
    78. Object rtValue = null;
    79. try {
    80. System.out.println("aroundAdvice前置通知!");
    81. // 获取参数
    82. Object[] args = proceedingJoinPoint.getArgs();
    83. // 执行切入点方法
    84. rtValue = proceedingJoinPoint.proceed(args);
    85. System.out.println("aroundAdvice后置通知!");
    86. } catch (Throwable e) {
    87. System.out.println("aroundAdvice异常通知!");
    88. e.printStackTrace();
    89. } finally {
    90. System.out.println("aroundAdvice最后通知!");
    91. }
    92. return rtValue;
    93. }
    94. }

    aroundAdvice前置通知! 前置通知:beforeAdvice,参数是:[1] [2020-13-24 02:13:48:509]findUserNameById aroundAdvice后置通知! aroundAdvice最后通知! 最后通知:afterAdvice 后置通知:afterReturningAdvice,返回参数是:tom

例子:实现日志监控

Service加个方法:
9. SpringFramework AOP 简述 - 图6
9. SpringFramework AOP 简述 - 图7
AopConfiguration.java:

  1. package com.example.spring.aop.config;
  2. import com.example.spring.aop.core.interceptor.TestMonitoringInterceptor;
  3. import com.example.spring.aop.service.UserService;
  4. import com.example.spring.aop.service.impl.UserServiceImpl;
  5. import org.aspectj.lang.annotation.Aspect;
  6. import org.aspectj.lang.annotation.Pointcut;
  7. import org.springframework.aop.Advisor;
  8. import org.springframework.aop.aspectj.AspectJExpressionPointcut;
  9. import org.springframework.aop.support.DefaultPointcutAdvisor;
  10. import org.springframework.context.annotation.Bean;
  11. import org.springframework.context.annotation.Configuration;
  12. import org.springframework.context.annotation.EnableAspectJAutoProxy;
  13. /**
  14. *
  15. <pre>
  16. * AOP日志监控配置类
  17. * </pre>
  18. *
  19. *
  20. <pre>
  21. * @author mazq
  22. * 修改记录
  23. * 修改后版本: V1.0.0 修改人:mazq 修改日期: 2020/11/23 14:30 修改内容: 新增配置类
  24. * </pre>
  25. */
  26. @Configuration
  27. @Aspect
  28. @EnableAspectJAutoProxy
  29. public class AopLogMonitorConfiguration {
  30. @Pointcut("within(com.example.spring.aop..*) && execution(public String com.example.spring.aop.service.UserService.findUserNameById(Long, ..))")
  31. public void monitor(){ }
  32. @Bean
  33. public TestMonitoringInterceptor monitoringInterceptor() {
  34. return new TestMonitoringInterceptor(true);
  35. }
  36. @Bean
  37. public Advisor monitoringAdvisor() {
  38. AspectJExpressionPointcut pointcut = new AspectJExpressionPointcut();
  39. pointcut.setExpression("com.example.spring.aop.config.AopConfiguration.monitor()");
  40. return new DefaultPointcutAdvisor(pointcut, monitoringInterceptor());
  41. }
  42. @Bean
  43. public UserService userService(){
  44. return new UserServiceImpl();
  45. }
  46. }

TestMonitoringInterceptor.java

  1. package com.example.spring.aop.core.interceptor;
  2. import org.aopalliance.intercept.MethodInvocation;
  3. import org.apache.commons.logging.Log;
  4. import org.springframework.aop.interceptor.AbstractMonitoringInterceptor;
  5. /**
  6. *
  7. <pre>
  8. * TestMonitoringInterceptor
  9. * </pre>
  10. *
  11. *
  12. <pre>
  13. * 修改记录
  14. * 修改后版本: 修改人: 修改日期: 2020/11/23 16:39 修改内容:
  15. * </pre>
  16. */
  17. public class TestMonitoringInterceptor extends AbstractMonitoringInterceptor {
  18. public TestMonitoringInterceptor(){}
  19. public TestMonitoringInterceptor (boolean useDynamicLogger) {
  20. setUseDynamicLogger(useDynamicLogger);
  21. }
  22. @Override
  23. protected Object invokeUnderTrace(MethodInvocation methodInvocation, Log log) throws Throwable {
  24. String name = createInvocationTraceName(methodInvocation);
  25. long start = System.currentTimeMillis();
  26. try {
  27. return methodInvocation.proceed();
  28. } finally {
  29. long end = System.currentTimeMillis();
  30. long time = end - start;
  31. log.info(String.format("方法名:%s,执行时间:%s ms",name,time));
  32. if (time > 10) {
  33. log.warn(String.format("方法名:%s,执行时间超过10 ms! ",name));
  34. }
  35. }
  36. }
  37. }

pom.xml加上logback配置:

  1. <properties>
  2. <slf4j.version>1.7.25</slf4j.version>
  3. <logback.version>1.2.3</logback.version>
  4. </properties>
  5. <dependencies>
  6. <dependency>
  7. <groupId>org.slf4j</groupId>
  8. <artifactId>slf4j-api</artifactId>
  9. <version>${slf4j.version}</version>
  10. </dependency>
  11. <dependency>
  12. <groupId>ch.qos.logback</groupId>
  13. <artifactId>logback-core</artifactId>
  14. <version>${logback.version}</version>
  15. </dependency>
  16. <dependency>
  17. <groupId>ch.qos.logback</groupId>
  18. <artifactId>logback-access</artifactId>
  19. <version>${logback.version}</version>
  20. </dependency>
  21. <dependency>
  22. <groupId>ch.qos.logback</groupId>
  23. <artifactId>logback-classic</artifactId>
  24. <version>${logback.version}</version>
  25. </dependency>
  26. </dependencies>

logback.xml,copy @https://github.com/eugenp/tutorials/blob/master/spring-aop/src/main/resources/logback.xml,进行一点改写:

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <configuration>
  3. <!-- copy @https://github.com/eugenp/tutorials/blob/master/spring-aop/src/main/resources/logback.xml-->
  4. <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
  5. <encoder>
  6. <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n
  7. </pattern>
  8. </encoder>
  9. </appender>
  10. <logger name="org.springframework" level="WARN" />
  11. <logger name="org.springframework.transaction" level="WARN" />
  12. <!-- in order to debug some marshalling issues, this needs to be TRACE -->
  13. <logger name="org.springframework.web.servlet.mvc" level="WARN" />
  14. <logger name="com.example.spring.aop.core.interceptor.TestMonitoringInterceptor" level="INFO" />
  15. <logger name="org.springframework.aop.interceptor.PerformanceMonitorInterceptor" level="TRACE" />
  16. <root level="TRACE">
  17. <appender-ref ref="STDOUT" />
  18. </root>
  19. </configuration>
  1. package com.example.spring.aop;
  2. import com.example.spring.aop.bean.User;
  3. import com.example.spring.aop.config.AopConfiguration;
  4. import com.example.spring.aop.service.UserService;
  5. import org.springframework.context.ApplicationContext;
  6. import org.springframework.context.annotation.AnnotationConfigApplicationContext;
  7. public class TestApplication {
  8. public static void testLogMonitoring() {
  9. AnnotationConfigApplicationContext ioc = new AnnotationConfigApplicationContext();
  10. // 注册配置类
  11. ioc.register(AopConfiguration.class);
  12. // 启动IOC容器
  13. ioc.refresh();
  14. UserService userService = (UserService) ioc.getBean("userService");
  15. System.out.println(userService.findUserNameById(1L));
  16. }
  17. public static void main(String[] args) {
  18. // logging monitoring
  19. testLogMonitoring();
  20. }
  21. }

17:54:05.553 [main] INFO c.e.s.a.service.impl.UserServiceImpl - 方法名:com.example.spring.aop.service.UserService.findUserNameById,执行时间:2531 ms 17:54:05.559 [main] WARN c.e.s.a.service.impl.UserServiceImpl - 方法名:com.example.spring.aop.service.UserService.findUserNameById,执行时间超过10 ms!

Spring2.0+ schema-based 配置

Spring2.0之后提供了基于 <aop /> 命名空间的 XML 配置,这也就是本文介绍的schema-based 配置
SchemaBasedAspect .java:

  1. package com.example.spring.aop.aspect;
  2. import org.aspectj.lang.JoinPoint;
  3. import org.aspectj.lang.ProceedingJoinPoint;
  4. import java.text.SimpleDateFormat;
  5. import java.util.Arrays;
  6. import java.util.Date;
  7. public class SchemaBasedAspect {
  8. private ThreadLocal<SimpleDateFormat> simpleDateFormat =new ThreadLocal<SimpleDateFormat>(){
  9. @Override
  10. protected SimpleDateFormat initialValue() {
  11. //return super.initialValue();
  12. return new SimpleDateFormat("[yyyy-mm-dd hh:mm:ss:SSS]");
  13. }
  14. };
  15. public void beforeAdvice(JoinPoint joinPoint){
  16. Object[] args = joinPoint.getArgs();
  17. String methodName = joinPoint.getSignature().getName();
  18. System.out.println(String.format("前置通知:beforeAdvice,参数是:%s", Arrays.toString(args)));
  19. System.out.println(simpleDateFormat.get().format(new Date()) + methodName);
  20. }
  21. public void afterReturningAdvice(Object returnVal){
  22. System.out.println(String.format("后置通知:afterReturningAdvice,返回参数是:%s", returnVal));
  23. }
  24. public void afterThrowingAdvice(Throwable e) {
  25. System.out.println(String.format("异常通知:afterThrowingAdvice,异常信息:%s", e));
  26. }
  27. public void afterAdvice() {
  28. System.out.println(String.format("最后通知:afterAdvice"));
  29. }
  30. public Object aroundAdvice(ProceedingJoinPoint proceedingJoinPoint) {
  31. Object rtValue = null;
  32. try {
  33. System.out.println("aroundAdvice前置通知!");
  34. // 获取参数
  35. Object[] args = proceedingJoinPoint.getArgs();
  36. // 执行切入点方法
  37. rtValue = proceedingJoinPoint.proceed(args);
  38. System.out.println("aroundAdvice后置通知!");
  39. } catch (Throwable e) {
  40. System.out.println("aroundAdvice异常通知!");
  41. e.printStackTrace();
  42. } finally {
  43. System.out.println("aroundAdvice最后通知!");
  44. }
  45. return rtValue;
  46. }
  47. }

spring_schemaBased_config.xml:

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <beans xmlns="http://www.springframework.org/schema/beans"
  3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:aop="http://www.springframework.org/schema/aop"
  4. xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/aop https://www.springframework.org/schema/aop/spring-aop.xsd">
  5. <!-- 具体业务实现类(target Object)-->
  6. <bean id="userService" class="com.example.spring.aop.service.impl.UserServiceImpl"></bean>
  7. <!-- SchemaBased Aspect-->
  8. <bean id="LoggingAspect" class="com.example.spring.aop.aspect.SchemaBasedAspect"></bean>
  9. <aop:aspectj-autoproxy/>
  10. <!--开始aop的配置-->
  11. <aop:config>
  12. <aop:pointcut id="executionPointcut" expression="execution(* com.example.spring.aop.service.UserService.*(..))" />
  13. <!--配置切⾯-->
  14. <aop:aspect id="logAspect" ref="LoggingAspect">
  15. <!--配置前置通知-->
  16. <aop:before method="beforeAdvice"
  17. pointcut-ref="executionPointcut"></aop:before>
  18. <!--配置后置通知-->
  19. <aop:after-returning method="afterReturningAdvice"
  20. pointcut-ref="executionPointcut" returning="returnVal"></aop:after-returning>
  21. <!-- 配置异常通知-->
  22. <aop:after-throwing method="afterThrowingAdvice" pointcut-ref="executionPointcut" throwing="e"
  23. ></aop:after-throwing>
  24. <!-- 配置最后通知-->
  25. <aop:after method="afterAdvice" pointcut-ref="executionPointcut"></aop:after>
  26. <!-- 配置环绕通知-->
  27. <aop:around method="aroundAdvice" pointcut-ref="executionPointcut"></aop:around>
  28. </aop:aspect>
  29. </aop:config>
  30. </beans>

TestApplication.java:

  1. package com.example.spring.aop;
  2. import com.example.spring.aop.bean.User;
  3. import com.example.spring.aop.service.UserService;
  4. import org.springframework.context.ApplicationContext;
  5. import org.springframework.context.support.ClassPathXmlApplicationContext;
  6. public class TestApplication {
  7. public static void testSchemaBasedAop(){
  8. ApplicationContext ioc = new ClassPathXmlApplicationContext("classpath:spring_schemaBased_config.xml");
  9. UserService userService = (UserService) ioc.getBean("userService");
  10. User userDto = new User();
  11. userDto.setUsername("tom");
  12. userDto.setPassword("11");
  13. userService.addUser(userDto);
  14. System.out.println(String.format("用户数据打印:%s",userService.getUser().toString()));
  15. }
  16. public static void main(String[] args) {
  17. // schema Based config
  18. testSchemaBasedAop();
  19. }
  20. }

附录参考

  • 本文的代码例子可以在github找到下载链接:链接