Spring5参考指南:AspectJ注解

2024-02-24 17:18

本文主要是介绍Spring5参考指南:AspectJ注解,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

文章目录

    • 什么是AspectJ注解
    • 启用AOP
    • 定义Aspect
    • 定义Pointcut
    • 切入点指示符(PCD)
    • 切入点组合
    • Advice
    • 访问JoinPoint
    • Advice参数
    • Advice参数和泛型
    • Advice Ordering
    • Introductions

什么是AspectJ注解

想要在Spring中使用AOP,和通用的Spring Bean一样有两种方式,一种就是注解,一种就是XML配置,本文主要讲解如何通过注解开启Spring AOP。

@AspectJ是一种将aspects声明为用注解来注解Java类的样式。@Aspectj样式是作为Aspectj 5版本的一部分由Aspectj项目引入的。Spring使用和AspectJ相同的注解,它使用了AspectJ提供的用于切入点解析和匹配的库。但是,AOP运行时仍然是纯SpringAOP,并且不依赖于AspectJ编译器或weaver。

启用AOP

Spring中使用@Aspectj特性需要Spring的支持,一旦启用@AspectJ , Spring将会为目标Bean自动生成代理,从而来拦截方法调用,或者根据需要调用通知。

注意,如果要启用@AspectJ支持,必须在classpath包含aspectjweaver.jar。

启用@AspectJ支持很简单,只需要在@Configuration 中添加@EnableAspectJAutoProxy 即可,如下所示:

@Configuration
@EnableAspectJAutoProxy
public class AppConfig {}

定义Aspect

如果想要定义一个Aspect, 只需要在Spring Bean上面加上@Aspect注解即可,如下所示:

@Aspect
@Component
public class NotVeryUsefulAspect {
}

定义Pointcut

SpringAOP只支持方法层的切入点,也就是说你只能在方法上面定义Pointcut.

一个切入点声明有两部分:一个包含一个名称和任何参数的签名,一个能精确地确定我们感兴趣的执行方法的切入点表达式。在aop的@Aspectj注解样式中,通过常规方法定义提供切入点签名,并使用@Pointcut注解指示切入点表达式(作为切入点签名的方法必须具有void返回类型)。

下面的例子定义一个名为anyOldTransfer的切入点,该切入点与名为Transfer的任何方法的执行相匹配:

@Aspect
@Component
public class NotVeryUsefulAspect {@Pointcut("execution(* transfer(..))")// the pointcut expressionprivate void anyOldTransfer() {}// the pointcut signature}

构成@Pointcut的是一个正则的aspectj 5 pointcut表达式。更多详细信息,我们会在接下来的教程中详细说明。

切入点指示符(PCD)

上面的例子我们看到在@Pointcut注解中可以使用execution, 表示执行方法的Pointcut,其实@Pointcut注解支持很多AspectJ切入点指示符(PCD),如下所示:

  • execution:用于匹配方法执行连接点。这是使用SpringAOP时要使用的主要切入点指示符。
  • within:特定类型中的连接点。
  • this:bean引用(SpringAOP代理)是给定类型的实例。
  • target:目标对象(要代理的应用程序对象)是给定类型的实例。
  • args:参数是给定类型的实例。
  • @target:执行对象的类具有给定类型的注解。
  • @Args:传递的实际参数的运行时类型具有给定类型的注解。
  • @within:与具有给定注解的类型中的联接点匹配。
  • @Annotation:在SpringAOP中执行的方法具有给定注解的连接点。

例子

SpringAOP用户最经常使用执行切入点指示符。执行表达式的格式如下:

execution(modifiers-pattern? ret-type-pattern declaring-type-pattern?name-pattern(param-pattern)throws-pattern?)

除返回类型模式(前面代码段中的ret-type-pattern)、名称模式和参数模式之外的所有部分都是可选的。返回类型模式确定方法的返回类型,以便匹配连接点。*最常用作返回类型模式。它匹配任何返回类型。只有当方法返回给定类型时,完全限定的类型名才匹配。名称模式与方法名匹配。您可以使用*通配符作为名称模式的全部或部分。如果指定声明类型模式,请包含后缀.将其连接到名称模式组件。参数模式稍微复杂一点:()匹配不带参数的方法,而(…)匹配任何数量(零个或多个)的参数。(*)模式与采用任何类型参数的方法匹配。(*,string)匹配接受两个参数的方法。第一个可以是任何类型,而第二个必须是字符串。

以下示例显示了一些常见的切入点表达式:

  • 执行任何公共方法:
execution(public * *(..))
  • 执行任何以set开头的方法:
execution(* set*(..))
  • 执行任何定义在AccountService类的方法:
execution(* com.xyz.service.AccountService.*(..))
  • 执行任何定义在service包中的方法:
execution(* com.xyz.service.*.*(..))
  • 执行任何定义在service包或者他的一个子包中的方法:
execution(* com.xyz.service..*.*(..))
  • 任何在service包中的连接点(仅仅是Spring AOP中执行的方法)
within(com.xyz.service.*)
  • service包或其子包中的任何连接点(仅在SpringAOP中执行的方法):
within(com.xyz.service..*)
  • 任何实现了AccountService接口的代理连接点(仅在SpringAOP中执行的方法):
this(com.xyz.service.AccountService)

this通常被用在绑定form中。

  • 任何实现了AccountService接口的目标对象连接点(仅在SpringAOP中执行的方法):
target(com.xyz.service.AccountService)

target更加通常被用在绑定form中。

  • 任何接收一个运行时是Serializable类型参数的连接点(仅在SpringAOP中执行的方法):
args(java.io.Serializable)

args通常被用在绑定form中。

注意,在本例中给出的切入点与execution(* *(java.io.Serializable))不同。如果在运行时传递的参数是Serializable的,则args版本匹配;如果方法签名声明了Serializable的单个参数,则执行版本匹配。

  • 任何目标对象有@Transactional 注解的连接点(仅在SpringAOP中执行的方法):
@target(org.springframework.transaction.annotation.Transactional)

@target也可以被用在绑定form中。

  • 目标对象的声明类型具有@transactional注解的任何连接点(仅在Spring AOP中执行的方法):
@within(org.springframework.transaction.annotation.Transactional)

@within也可以被用在绑定form中。

  • 执行方法具有@transactional注解的任何连接点(仅在Spring AOP中执行方法):
@Annotation(org.springframework.transaction.annotation.Transactional)

@Annotation也可以被用在绑定form中。

  • 接受单个参数的任何连接点(仅在Spring AOP中执行方法),并且传递参数的运行时类型具有@Classified annotation:
@Args(com.xyz.security.Classified)

@Args也可以被用在绑定form中。

  • 名为tradeService的SpringBean上的任何连接点(仅在SpringAOP中执行方法):
bean(tradeService)
  • SpringBean上的任何连接点(仅在SpringAOP中执行方法),其名称与通配符表达式*Service匹配:
bean(*Service)

其他的AspectJ支持的pointcut指示符(call、get、set、preinitialization、staticinitialization、initialization、handler、adviceexecution、withincode、cflow、cflowbelow、if、@this和@withincode)在Spring中是不支持的,会引发IllegalArgumentException。

除了标准的PCD之外,Spring还有一个基于特定名字的Spring Bean或一组Spring Bean(使用通配符时)PCD:

bean(idOrNameOfBean)

其中idorNameOfBean可以是任何Spring Bean的名称,可以使用*通配符进行名称匹配。

bean PCD仅在SpringAOP中受支持,在native AspectJ中不支持。它是AspectJ定义的标准PCD的特定于Spring的扩展,因此不能用于native AspectJ中。

    @Pointcut("bean(serviceA)")private void beanServiceA() {}

切入点组合

切入点表达式可以通过&&、|| 和!组合在一起,并可以按名称来引用,下面是例子:

@Pointcut("execution(public * *(..))")
private void anyPublicOperation() {} @Pointcut("within(com.flydean.service.*)")
private void inTrading() {}@Pointcut("anyPublicOperation() && inTrading()")
private void tradingOperation() {}

按名称应用Pointcut时,支持正常的java可见性规则。(可以在同一类型中看到私有切入点、在层次结构中看到protected切入点、在任何地方看到公共切入点等)。

注意,可见性并不影响Pointcut匹配。

Advice

Advice是与切入点相关连的,Advice是在切入点匹配的方法上面执行before, after, 或 around Advice。

切入点表达式有两种表现方式:1. 可以是对命名切入点的简单引用,2. 可以就地声明切入点表达式。

下面是Before Advice的例子

    @Before("com.flydean.aspect.SystemArchitecture.businessService()")public void doAccessCheck() {// ...}@Before("execution(* com.flydean.service.*.*(..))")public void doServiceCheck() {// ...}

After Returning Advice

    @AfterReturning("com.flydean.aspect.SystemArchitecture.businessService()")public void doBusinessCheck() {// ...}

有时,您需要访问通知主体中返回的实际值。您可以使用@AfterReturn的形式绑定返回值以获得该访问,如下示例所示:

    @AfterReturning(pointcut="com.flydean.aspect.SystemArchitecture.businessService()",returning="retVal")public void doAccessCheck(Object retVal) {// ...}

returning属性中使用的名称必须与advice方法中参数的名称相对应。当方法执行返回时,返回值作为相应的参数值传递给通知方法。返回子句还限制只匹配那些返回指定类型值的方法执行(在本例中是Object,它匹配任何返回值)。

After Throwing Advice

当匹配的方法抛出异常退出时,After throwing advice执行,你可以使用@AfterThrowing来声明它:

    @AfterThrowing("com.flydean.aspect.SystemArchitecture.businessService()")public void doRecoveryActions() {// ...}

如果你希望只有在抛出给定类型的异常时才运行通知,并且通常还需要访问通知正文中抛出的异常。可以使用throwing属性来限制匹配(如果需要-使用throwable作为异常类型),并将引发的异常绑定到advice参数。以下示例显示了如何执行此操作:

    @AfterThrowing(pointcut="com.flydean.aspect.SystemArchitecture.businessService()",throwing="ex")public void doRecoveryActions(Exception ex) {// ...}

throwing属性中使用的名称必须与advice方法中参数的名称相对应。当通过引发异常退出方法执行时,异常作为相应的参数值传递给通知方法。

After (Finally) Advice

After (Finally) Advice当匹配的方法执行退出时执行,通过@After注解来定义。After advice 必须能够处理正常返回和异常返回的情况。它通常用于释放资源和类似用途。下面的示例演示如何在finally advice之后使用:

    @After("com.flydean.aspect.SystemArchitecture.businessService()")public void doReleaseLock() {// ...}

Around Advice

around advice运行“around”匹配方法的执行。它有机会在方法执行之前和之后都进行工作,并确定何时、如何以及即使该方法真正开始执行。

使用@Around注解声明around通知。advice方法的第一个参数必须是ProceedingJoinPoint类型。在通知正文中,对ProceedingJoinPoint调用proceed()会导致执行基础方法。proceed方法也可以传入Object[]。数组中的值在方法执行过程中用作参数。

    @Around("com.flydean.aspect.SystemArchitecture.businessService()")public Object doBasicProfiling(ProceedingJoinPoint pjp) throws Throwable {// start stopwatchObject retVal = pjp.proceed();// stop stopwatchreturn retVal;}

访问JoinPoint

任何advice方法都可以将org.aspectj.lang.joinpoint类型的参数声明为其第一个参数(请注意,需要使用around advice从而声明ProceedingJoinPoint类型作为第一个参数,该参数是JoinPoint的子类)。JoinPoint接口提供了许多有用的方法:

  • getArgs(): 返回方法参数
  • getThis(): 返回代理对象
  • getTarget(): 返回目标对象
  • getSignature(): 返回被advice的方法描述
  • toString():打印被advice方法的有用描述

Advice参数

前面的例子我们看到了如何绑定返回值或异常值。如果想在通知主题中使用参数,可以使用参数绑定的形式。

在args表达式中使用参数名代替类型名,则在调用通知时,相应参数的值将作为参数值传递。

    @Before("com.flydean.aspect.SystemArchitecture.businessService() && args(account,..)")public void validateAccount(Account account) {// ...}

pointcut中的args(account,…)部分有两个主要目的:首先,它将匹配限制为只执行那些方法,其中该方法至少接受一个参数,并且传递给该参数的参数是帐户的实例。其次,它通过account参数使实际的account对象可用于advice。

另一种编写方法是声明一个切入点,该切入点在与连接点匹配时“提供”account对象值,然后从通知中引用命名的切入点。如下所示:

    @Pointcut("com.flydean.aspect.SystemArchitecture.businessService() && args(account,..)")private void accountDataAccessOperation(Account account) {}@Before("accountDataAccessOperation(account)")public void validateAccountA(Account account) {// ...}

Advice参数和泛型

SpringAOP可以处理类声明和方法参数中使用的泛型。假设您有一个如下的泛型类型:

public interface Sample<T> {void sampleGenericMethod(T param);void sampleGenericCollectionMethod(Collection<T> param);
}

通过将advice参数键入要拦截方法的参数类型,可以将方法类型的拦截限制为某些参数类型:

    @Before("execution(* * ..Sample+.sampleGenericMethod(*)) && args(param)")public void beforeSampleMethod(MyType param) {// Advice implementation}

这种方法不适用于泛型集合.

Advice Ordering

当在不同aspects定义的两条advice都需要在同一连接点上运行时,除非您另有指定,否则执行顺序是未定义的。您可以通过指定优先级来控制执行顺序。这可以通过在Aspect类中实现org.springframework.core.Ordered接口或使用order注解来以正常的Spring方式完成。给定两个aspects,从ordered.getValue()返回较低值(或注解值)的方面具有较高的优先级。

给定两个before advice,最高优先级的advice首先运行。

给定两条after advice,最高优先级的通知将在第二运行。

Introductions

Introductions能够为建议的对象提供指定的接口实现。

可以使用@DeclareParents注解来声明要实现的接口和默认的实现对象。

例如,给定一个名为UsageTracked的接口和一个名为DefaultUsageTracked的接口的实现,下面的方面声明com.flydean.service的所有方法也实现UsageTracked了接口:

@Aspect
@Component
public class UsageTracking {@DeclareParents(value="com.flydean.service.*+", defaultImpl= DefaultUsageTracked.class)public static UsageTracked mixin;@Before("com.flydean.aspect.SystemArchitecture.businessService() && this(usageTracked)")public void recordUsage(UsageTracked usageTracked) {usageTracked.incrementUseCount();}
}

下面是调用的例子:

        ServiceA serviceA=(ServiceA)classPathXmlApplicationContext.getBean("serviceA");UsageTracked usageTracked=(UsageTracked)serviceA;usageTracked.incrementUseCount();

其中serviceA是com.flydean.service包里面的方法。我们通过Introductions为其添加了一个incrementUseCount的方法。

本节的例子可以参考aop1

更多教程请参考 flydean的博客

这篇关于Spring5参考指南:AspectJ注解的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/742784

相关文章

Java五子棋之坐标校正

上篇针对了Java项目中的解构思维,在这篇内容中我们不妨从整体项目中拆解拿出一个非常重要的五子棋逻辑实现:坐标校正,我们如何使漫无目的鼠标点击变得有序化和可控化呢? 目录 一、从鼠标监听到获取坐标 1.MouseListener和MouseAdapter 2.mousePressed方法 二、坐标校正的具体实现方法 1.关于fillOval方法 2.坐标获取 3.坐标转换 4.坐

Spring Cloud:构建分布式系统的利器

引言 在当今的云计算和微服务架构时代,构建高效、可靠的分布式系统成为软件开发的重要任务。Spring Cloud 提供了一套完整的解决方案,帮助开发者快速构建分布式系统中的一些常见模式(例如配置管理、服务发现、断路器等)。本文将探讨 Spring Cloud 的定义、核心组件、应用场景以及未来的发展趋势。 什么是 Spring Cloud Spring Cloud 是一个基于 Spring

Javascript高级程序设计(第四版)--学习记录之变量、内存

原始值与引用值 原始值:简单的数据即基础数据类型,按值访问。 引用值:由多个值构成的对象即复杂数据类型,按引用访问。 动态属性 对于引用值而言,可以随时添加、修改和删除其属性和方法。 let person = new Object();person.name = 'Jason';person.age = 42;console.log(person.name,person.age);//'J

java8的新特性之一(Java Lambda表达式)

1:Java8的新特性 Lambda 表达式: 允许以更简洁的方式表示匿名函数(或称为闭包)。可以将Lambda表达式作为参数传递给方法或赋值给函数式接口类型的变量。 Stream API: 提供了一种处理集合数据的流式处理方式,支持函数式编程风格。 允许以声明性方式处理数据集合(如List、Set等)。提供了一系列操作,如map、filter、reduce等,以支持复杂的查询和转

Java面试八股之怎么通过Java程序判断JVM是32位还是64位

怎么通过Java程序判断JVM是32位还是64位 可以通过Java程序内部检查系统属性来判断当前运行的JVM是32位还是64位。以下是一个简单的方法: public class JvmBitCheck {public static void main(String[] args) {String arch = System.getProperty("os.arch");String dataM

详细分析Springmvc中的@ModelAttribute基本知识(附Demo)

目录 前言1. 注解用法1.1 方法参数1.2 方法1.3 类 2. 注解场景2.1 表单参数2.2 AJAX请求2.3 文件上传 3. 实战4. 总结 前言 将请求参数绑定到模型对象上,或者在请求处理之前添加模型属性 可以在方法参数、方法或者类上使用 一般适用这几种场景: 表单处理:通过 @ModelAttribute 将表单数据绑定到模型对象上预处理逻辑:在请求处理之前

eclipse运行springboot项目,找不到主类

解决办法尝试了很多种,下载sts压缩包行不通。最后解决办法如图: help--->Eclipse Marketplace--->Popular--->找到Spring Tools 3---->Installed。

JAVA读取MongoDB中的二进制图片并显示在页面上

1:Jsp页面: <td><img src="${ctx}/mongoImg/show"></td> 2:xml配置: <?xml version="1.0" encoding="UTF-8"?><beans xmlns="http://www.springframework.org/schema/beans"xmlns:xsi="http://www.w3.org/2001

Java面试题:通过实例说明内连接、左外连接和右外连接的区别

在 SQL 中,连接(JOIN)用于在多个表之间组合行。最常用的连接类型是内连接(INNER JOIN)、左外连接(LEFT OUTER JOIN)和右外连接(RIGHT OUTER JOIN)。它们的主要区别在于它们如何处理表之间的匹配和不匹配行。下面是每种连接的详细说明和示例。 表示例 假设有两个表:Customers 和 Orders。 Customers CustomerIDCus

22.手绘Spring DI运行时序图

1.依赖注入发生的时间 当Spring loC容器完成了 Bean定义资源的定位、载入和解析注册以后,loC容器中已经管理类Bean 定义的相关数据,但是此时loC容器还没有对所管理的Bean进行依赖注入,依赖注入在以下两种情况 发生: 、用户第一次调用getBean()方法时,loC容器触发依赖注入。 、当用户在配置文件中将<bean>元素配置了 lazy-init二false属性,即让