如何动态修改 Spring Aop 切面信息？让自动日志输出框架更好用

作者：老马啸西风 2023-09-04 08:36:19开发 架构 对于 Spring 项目，何动好用默认实现了基于 Aop 切面的态修日志输出。发现一个问题，切面如果切面定义为全切范围过大，信息于是让自 v0.2 版本就是基于注解 @AutoLog 实现的。

业务背景

很久以前开源了一款 auto-log[1] 自动日志打印框架。动日

其中对于 spring 项目，志输默认实现了基于 aop 切面的出框日志输出。

但是架更发现一个问题，如果切面定义为全切范围过大，何动好用于是态修 v0.2 版本就是基于注解 @AutoLog 实现的。

只有指定注解的切面类或者方法才会生效，但是信息这样使用起来很不方便。

如何才能动态指定 pointcut，让自让用户使用时可以自定义切面范围呢？

自定义注解切面原理

常规 aop 方式

@Aspect@Component@EnableAspectJAutoProxy@Deprecatedpublic class AutoLogAop {     @Pointcut("@within(com.github.houbb.auto.log.annotation.AutoLog)" +            "|| @annotation(com.github.houbb.auto.log.annotation.AutoLog)")    public void autoLogPointcut() {     }    /**     * 执行核心方法     *     * 相当于 MethodInterceptor     *     * @param point 切点     * @return 结果     * @throws Throwable 异常信息     * @since 0.0.3     */    @Around("autoLogPointcut()")    public Object around(ProceedingJoinPoint point) throws Throwable {         // 日志增强逻辑    }}

发现这里的动日 @Pointcut 注解属性是一个常量，无法方便地动态修改。

于是去查资料，找到了另一种更加灵活的方式。

可以指定 pointcut 的方式

我们通过 @Value 获取属性配置的切面值，给定默认值。这样用户就可以很方便的自定义。

/** * 动态配置的切面 * 自动日志输出 aop * @author binbin.hou * @since 0.3.0 */@Configuration@Aspect//@EnableAspectJAutoProxypublic class AutoLogDynamicPointcut {     /**     * 切面设置，直接和 spring 的配置对应 ${ }，可以从 properties 或者配置中心读取。更加灵活     */    @Value("${ auto.log.pointcut:@within(com.github.houbb.auto.log.annotation.AutoLog)||@annotation(com.github.houbb.auto.log.annotation.AutoLog)}")    private String pointcut;    @Bean("autoLogPointcutAdvisor")    public AspectJExpressionPointcutAdvisor autoLogPointcutAdvisor() {         AspectJExpressionPointcutAdvisor advisor = new AspectJExpressionPointcutAdvisor();        advisor.setExpression(pointcut);        advisor.setAdvice(new AutoLogAdvice());        return advisor;    }}

当然，这里的 Advice 和以前的 aop 不同，需要重新进行实现。

AutoLogAdvice

只需要实现 MethodInterceptor 接口即可。

/** * 切面拦截器 * * @author binbin.hou * @since 0.3.0 */public class AutoLogAdvice implements MethodInterceptor {     @Override    public Object invoke(MethodInvocation methodInvocation) throws Throwable {         // 增强逻辑    }}

介绍完了原理，我们一起来看下改进后的日志打印组件的效果。

spring 整合使用

完整示例参考 SpringServiceTest[2]。

maven 引入

<dependency>    <groupId>com.github.houbb</groupId>    <artifactId>auto-log-spring</artifactId>    <version>0.3.0</version></dependency>

注解声明

使用 @EnableAutoLog 启用自动日志输出。

@Configurable@ComponentScan(basePackages = "com.github.houbb.auto.log.test.service")@EnableAutoLogpublic class SpringConfig { }

测试代码

@ContextConfiguration(classes = SpringConfig.class)@RunWith(SpringJUnit4ClassRunner.class)public class SpringServiceTest {     @Autowired    private UserService userService;    @Test    public void queryLogTest() {         userService.queryLog("1");    }}

输出结果

信息: public java.lang.String com.github.houbb.auto.log.test.service.impl.UserServiceImpl.queryLog(java.lang.String) param is [1]五月 30, 2020 12:17:51 下午 com.github.houbb.auto.log.core.support.interceptor.AutoLogMethodInterceptor info信息: public java.lang.String com.github.houbb.auto.log.test.service.impl.UserServiceImpl.queryLog(java.lang.String) result is result-1五月 30, 2020 12:17:51 下午 org.springframework.context.support.GenericApplicationContext doClose

切面自定义

原理解释

spring aop 的切面读取自 @Value("${ auto.log.pointcut}")，默认为值 @within(com.github.houbb.auto.log.annotation.AutoLog)||@annotation(com.github.houbb.auto.log.annotation.AutoLog)。

也就是默认是读取被 @AutoLog 指定的方法或者类。

当然，这并不够方便，我们希望可以想平时写 aop 注解一样，指定 spring aop 的扫描范围，直接在 spring 中指定一下 auto.log.pointcut 的属性值即可。

测试例子

完整测试代码[3]

我们在配置文件 autoLogConfig.properties 中自定义下包扫描的范围：

auto.log.pointcut=execution(* com.github.houbb.auto.log.test.dynamic.service.MyAddressService.*(..))

自定义测试 service。

package com.github.houbb.auto.log.test.dynamic.service;import org.springframework.stereotype.Service;@Servicepublic class MyAddressService {     public String queryAddress(String id) {         return "address-" + id;    }}

自定义 spring 配置，指定我们定义的配置文件。springboot 啥的，可以直接放在 application.properties 中指定，此处仅作为演示。

@Configurable@ComponentScan(basePackages = "com.github.houbb.auto.log.test.dynamic.service")@EnableAutoLog@PropertySource("classpath:autoLogConfig.properties")public class SpringDynamicConfig { }

测试

@ContextConfiguration(classes = SpringDynamicConfig.class)@RunWith(SpringJUnit4ClassRunner.class)public class SpringDynamicServiceTest {     @Autowired    private MyAddressService myAddressService;    @Autowired    private MyUserService myUserService;    @Test    public void queryUserTest() {         // 不会被日志拦截        myUserService.queryUser("1");    }    @Test    public void queryAddressTest() {         // 会被日志拦截        myAddressService.queryAddress("1");    }}

开源地址

为了便于大家学习，项目已开源。

Github: https://github.com/houbb/auto-log

Gitee: https://gitee.com/houbinbin/auto-log

小结

这个项目很长一段时间拘泥于注解的方式，我个人用起来也不是很方便。

最近才想到了改进的方法，人还是要不断学习进步。

关于日志最近还学到了 aspect 的编译时增强，和基于 agent 的运行时增强，这 2 种方式都很有趣，有机会会做学习记录。

References

[1] auto-log: https://github.com/houbb/auto-log。

[2] SpringServiceTest: https://github.com/houbb/auto-log/tree/master/auto-log-test/src/test/java/com/github/houbb/auto/log/spring/SpringServiceTest.java。

[3] 完整测试代码: https://github.com/houbb/auto-log/blob/master/auto-log-test/src/test/java/com/github/houbb/auto/log/dynamic/SpringDynamicServiceTest.java。

责任编辑：姜华 来源： 今日头条 SpringAop日志输出

(责任编辑：热点)