构建AspectJ类库：无依赖实现方法运行时参数日志记录

我们有一个采用Maven构建的Java项目，使用父POM+多子POM的结构。目前正在开发一个子POM项目，用于定义可在其他子项目中复用的切面（Aspect），已经通过AspectJ Maven插件的官方示例实现了基础功能。

如何在这个AspectJ类库中记录方法执行时的运行时参数值，且不依赖任何其他子POM项目？

项目结构示例：父项目下包含Child-1、Child-2、AspectJ-Library三个子项目。

Child-1中的代码：

package org.example;

class Item {
  // 字段、getter、setter方法
}

package org.example;

class Business {
  public void logic(Item b) {
   // 业务逻辑
  }
}

AspectJ-Library中的代码：

package org.example;

import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Before;

@Aspect
public class LoggingAspect {
    @Before("execution(* org.example.Business.logic(..))") // 后续将改为基于注解的切点
    public void logBeforeAllMethods(JoinPoint joinPoint)
    {
        // 如何记录Item对象的各字段值？
    }
}

需要实现：在上述logBeforeAllMethods方法中，记录Item对象的所有字段值。

由于不能依赖其他子项目，无法直接引用Item类，只能通过Java反射或通用工具类来读取对象字段值，以下是两种可行方案：

方案1：纯反射实现 #

直接通过Java反射API遍历对象字段（包括私有字段），读取字段值：

package org.example;

import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Before;
import java.lang.reflect.Field;

@Aspect
public class LoggingAspect {
    @Before("execution(* org.example.Business.logic(..))")
    public void logBeforeAllMethods(JoinPoint joinPoint)
    {
        // 获取方法入参
        Object[] args = joinPoint.getArgs();
        for (Object arg : args) {
            if (arg != null) {
                logObjectFields(arg);
            }
        }
    }

    private void logObjectFields(Object obj) {
        Class<?> clazz = obj.getClass();
        // 获取当前类的所有字段（含私有）
        Field[] fields = clazz.getDeclaredFields();
        for (Field field : fields) {
            try {
                // 开启私有字段访问权限
                field.setAccessible(true);
                Object value = field.get(obj);
                System.out.printf("字段[%s]：值[%s]%n", field.getName(), value);
                // 如需打印嵌套对象字段，可在此添加递归逻辑
            } catch (IllegalAccessException e) {
                System.err.printf("读取字段[%s]失败：%s%n", field.getName(), e.getMessage());
            }
        }
        // 如需处理父类字段，可在此递归遍历 clazz.getSuperclass() 的字段
    }
}

方案2：使用Apache Commons Lang工具类 #

可以在AspectJ-Library中单独引入Apache Commons Lang依赖（仅依赖第三方类库，不依赖项目内的子POM），用ToStringBuilder简化字段打印：

首先在AspectJ-Library的POM中添加依赖：

<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-lang3</artifactId>
    <version>3.14.0</version>
</dependency>

然后修改切面代码：

package org.example;

import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Before;
import org.apache.commons.lang3.builder.ToStringBuilder;
import org.apache.commons.lang3.builder.ToStringStyle;

@Aspect
public class LoggingAspect {
    @Before("execution(* org.example.Business.logic(..))")
    public void logBeforeAllMethods(JoinPoint joinPoint)
    {
        Object[] args = joinPoint.getArgs();
        for (Object arg : args) {
            if (arg != null) {
                // 用多行格式打印所有字段信息
                String objFieldInfo = ToStringBuilder.reflectionToString(arg, ToStringStyle.MULTI_LINE_STYLE);
                System.out.println("对象字段详情：\n" + objFieldInfo);
            }
        }
    }
}

注意事项 #

• 反射方式需处理IllegalAccessException，私有字段必须调用field.setAccessible(true)才能读取。
• 若需打印父类继承的字段，需在反射逻辑中递归遍历父类的字段列表。
• 使用第三方工具类时，需确保AspectJ-Library的POM依赖配置正确，版本稳定。

内容的提问来源于stack exchange，提问作者user762421