Java如何为ActionInterface所有实现类的execute方法添加调用日志监听

这套方案完全匹配需求的核心要求：后续新增任何ActionInterface实现类，不需要修改实现代码、不需要额外配置，就能自动被监听覆盖，是长期维护成本最低的选择。

方案核心逻辑 #

直接以ActionInterface接口本身作为拦截规则，不绑定单个具体实现类：

• 所有满足“实现了ActionInterface接口”的类，其execute方法执行时，都会被自动拦截
• 拦截后直接从目标对象实例上读取property值，执行debug日志打印，完全不改动原有实现类的业务逻辑

不同场景下的落地代码 #

1. Spring生态项目 #

直接写切面类即可，框架会自动给所有接口实现类生成代理对象，不需要手动写代理逻辑：

@Aspect
@Component
public class ActionExecuteLogAspect {
  private static final Logger log = LoggerFactory.getLogger(ActionExecuteLogAspect.class);

  // 切点匹配所有ActionInterface实现类的execute方法，不管后续新增多少实现类都会自动生效
  @Pointcut("execution(* 你的项目包名.ActionInterface+.execute(..))")
  public void matchAllActionExecute() {}

  @Around("matchAllActionExecute()")
  public Object triggerLogBeforeExecute(ProceedingJoinPoint joinPoint) throws Throwable {
    Object targetInstance = joinPoint.getTarget();
    // 读取实例上的property字段打日志
    Field propertyField = targetInstance.getClass().getDeclaredField("property");
    propertyField.setAccessible(true);
    log.debug("Action实例执行触发，携带属性值: {}", propertyField.get(targetInstance));
    // 走完原有execute的业务逻辑
    return joinPoint.proceed();
  }
}

注意：如果部分实现类没有property字段，反射读取时要加try-catch兜底，不要因为日志逻辑的异常打断原业务流程
小优化：如果所有实现类的property字段命名规则统一，也可以在ActionInterface里加一个默认的getProperty()方法作为约定，后续打日志时不用反复反射取字段，代码更简洁。

2. 非Spring的普通Java SE项目 #

自己写个简单的动态代理工厂，所有ActionInterface实例从工厂获取代理对象即可：

public class ActionProxyFactory {
  @SuppressWarnings("unchecked")
  public static <T> ActionInterface<T> wrapWithLog(ActionInterface<T> rawInstance) {
    return (ActionInterface<T>) Proxy.newProxyInstance(
      ActionProxyFactory.class.getClassLoader(),
      new Class[]{ActionInterface.class},
      (proxy, method, methodArgs) -> {
        // 匹配execute方法时触发日志逻辑
        if ("execute".equals(method.getName())) {
          Field propertyField = rawInstance.getClass().getDeclaredField("property");
          propertyField.setAccessible(true);
          System.getLogger(rawInstance.getClass().getName())
            .log(Level.DEBUG, "Action实例执行触发，携带属性值: " + propertyField.get(rawInstance));
        }
        // 正常执行原方法
        return method.invoke(rawInstance, methodArgs);
      }
    );
  }
}

后续代码里所有创建ActionInterface实例的地方，过一遍这个工厂方法包一层就行，新增实现类完全不用改代理逻辑。

为什么不选其他替代方案 #

• 模板方法模式：需要把所有实现类改成继承公共抽象类，一旦实现类已经有其他继承关系就没法改，而且后续新增实现类如果忘了继承抽象类，就会漏监听，不符合“自动覆盖所有实现类”的要求
• 每个实现类手动加日志：重复代码多，后续新增实现类非常容易漏加日志，维护成本极高
• 字节码增强类方案：比如直接用ASM修改class文件字节码实现监听，调试难度高、排查问题成本大，属于杀鸡用牛刀

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