Spring AOP 应用

Spring AOP 应用

1. 介绍

AOP：面向切面编程，对面向对象编程的一种补充。

AOP可以将一些公用的代码，自然的嵌入到指定方法的指定位置。

比如：

如上图，我们现在有四个方法，我们想在每个方法执行一开始，输出一个日志信息。但是这样做很麻烦，如果有100个、1000个方法，工作量会很大，而且难以维护。这时候就可以通过AOP进行解决。

---

2. 案例实战

2.1 需求分析及环境搭建

环境：SpringBoot + SpringBoot Web + SpringBoot AOP。

<dependency>     <groupId>org.springframework.boot</groupId>     <artifactId>spring-boot-starter</artifactId> </dependency> <dependency>     <groupId>org.springframework.boot</groupId>     <artifactId>spring-boot-starter-test</artifactId>     <scope>test</scope> </dependency> <dependency>     <groupId>org.springframework.boot</groupId>     <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency>     <groupId>org.springframework.boot</groupId>     <artifactId>spring-boot-starter-aop</artifactId> </dependency> <dependency>     <groupId>org.projectlombok</groupId>     <artifactId>lombok</artifactId> </dependency> 

目标：控制器业务方法，统一进行日志输出。

新建User类，包含id和name属性。

新建UserController

@RestController @RequestMapping("/user") public class UserController {     @GetMapping("/list")     public List<User> list(){         return Arrays.asList(                 new User(1,"张三"),                 new User(2,"李四"),                 new User(3,"王五")         );     }     @GetMapping("/getById/{id}")     public User getById(@PathVariable("id") Integer id){         return new User(id,"张三");     }     @GetMapping("/deleteById/{id}")     public boolean deleteById(@PathVariable("id") Integer id){         return true;     } } 

此时，我们的目标就是使用AOP的方式，给这个list、deleteById和getById方法加上日志。

日志要包括调用方法的名称、返回值以及参数列表。

2.3 AOP实现

1. 首先我们要让AOP知道哪些方法需要被AOP处理 -> 通过注解方式进行处理

// 定义一个注解，来标记需要添加日志的方法 @Target(ElementType.METHOD) @Retention(RetentionPolicy.RUNTIME) @Documented public @interface LogAnnotation {     String value() default ""; } 

定义好注解后，给需要使用日志的方法添加注解，如：

@LogAnnotation("查询用户")   // 标记目标方法 @GetMapping("/getById/{id}") public User getById(@PathVariable("id") Integer id){     return new User(id,"张三"); } 

2. 实现切面任务

新建LogAspect类，这就是生成切面对象的类。我们需要用@Component注解进行标注，交给IOC容器进行管理。此外，我们要用@Aspect注解标注其为一个切面。

然后，我们要将这个切面与我们刚刚标注的@LogAnnotation注解建立联系，让切面知道从哪个位置进行切入。实现的方法为，新建一个方法，然后给这个方法添加@Pointcut("@annotation(自定义注解的全类名)")。这样就成功建立的联系。

确定切入点后，我们就可以写切面的实际任务了。新建一个方法around。此时，我们要将确定切点的方法与切面实际处理任务的方法进行关联。实现的方法为，给实际处理任务的方法添加@Around("标记切点的方法名()")注解。

此时，我们只有一个around方法，要用这一个方法对list、getById、deleteById三个方法进行处理。那么around方法如何分辨这三个不同的方法呢？这时就需要用到一个连接点对象ProceedingJoinPoint。around的返回值为object类型，其要返回所切入方法的返回值。

然后，就可以实现日志输出功能了。

@Aspect @Component @Slf4j public class LogAspect {     @Pointcut("@annotation(cn.codewei.aopstudy.annotation.LogAnnotation)")     public void logPointCut() {     }     @Around("logPointCut()")     public Object around(ProceedingJoinPoint point) throws Throwable {         // 方法名称         String name = point.getSignature().getName();         // 通过反射 获取注解中的内容         MethodSignature signature = (MethodSignature) point.getSignature();         Method method = signature.getMethod();         LogAnnotation annotation = method.getAnnotation(LogAnnotation.class);         String value = annotation.value();         // 输出日志         log.info("方法名称：{}, 方法描述: {}, 返回值: {}, 参数列表: {}", name, value, point.proceed(), point.getArgs());         // 返回切入方法的返回值         return point.proceed();     } } 

@Around、@Before、@After区别

• @Before前置通知，是在所拦截方法执行之前执行一段逻辑，返回值类型为void。
• @After 后置通知，是在所拦截方法执行之后执行一段逻辑，返回值类型为void。
• @Around 环绕通知，是可以同时在所拦截方法的前后执行一段逻辑，用这个注解的方法入参传的是ProceedingJoinPoint，返回结果类型为Object，返回结果为ProceedingJoinPoint对象的.proceed();

3. @Pointcut

• 使用within表达式匹配

​ 匹配com.leo.controller包下所有的类的方法

@Pointcut("within(com.leo.controller..*)") public void pointcutWithin(){ } 

• this匹配目标指定的方法，此处就是HelloController的方法

@Pointcut("this(com.leo.controller.HelloController)") public void pointcutThis(){ } 

• target匹配实现UserInfoService接口的目标对象

@Pointcut("target(com.leo.service.UserInfoService)") public void pointcutTarge(){ } 

• bean匹配所有以Service结尾的bean里面的方法

  注意：使用自动注入的时候默认实现类首字母小写为bean的id

@Pointcut("bean(*ServiceImpl)") public void pointcutBean(){ } 

• args匹配第一个入参是String类型的方法

@Pointcut("args(String, ..)") public void pointcutArgs(){ } 

• @annotation匹配是@Controller类型的方法

@Pointcut("@annotation(org.springframework.stereotype.Controller)") public void pointcutAnnocation(){ } 

• @within匹配@Controller注解下的方法，要求注解的@Controller级别为@Retention(RetentionPolicy.CLASS)

@Pointcut("@within(org.springframework.stereotype.Controller)") public void pointcutWithinAnno(){ } 

• @target匹配的是@Controller的类下面的方法，要求注解的@Controller级别为@Retention(RetentionPolicy.RUNTIME)

@Pointcut("@target(org.springframework.stereotype.Controller)") public void pointcutTargetAnno(){ } 

• @args匹配参数中标注为@Sevice的注解的方法

@Pointcut("@args(org.springframework.stereotype.Service)") public void pointcutArgsAnno(){ } 

• 使用excution表达式

@Pointcut(value = "execution(public * com.leo.controller.HelloController.hello*(..))") public void pointCut() { }