如何在 Java 中利用 Proxy.newProxyInstance() 配合 InvocationHandler 实现动态日志切面

小辰小哥_9093

小辰小哥_9093

2026-05-05

834人浏览

原创

Java动态代理通过Proxy.newProxyInstance()和InvocationHandler实现接口方法的日志切面,支持方法调用前后耗时统计、异常捕获与返回值处理,但仅限接口代理,不支持类代理。

如何在 java 中利用 proxy.newproxyinstance() 配合 invocationhandler 实现动态日志切面

在 Java 中,用 Proxy.newProxyInstance() 配合 InvocationHandler 实现动态日志切面,核心是拦截目标接口方法调用,在前后插入日志逻辑,无需修改业务代码,也不依赖 Spring AOP。

前提:只能代理接口,不能代理类

Java 原生动态代理仅支持对接口生成代理对象。若目标类没有实现接口,需改写为面向接口编程,或改用 CGLIB(但那是另一套机制)。

例如定义一个服务接口:

public interface UserService {
    String getName(int id);
    void updateName(int id, String name);
}

编写自定义 InvocationHandler 添加日志逻辑

实现 InvocationHandler,在 invoke() 中统一处理方法进入、执行、返回/异常等时机的日志输出:

  • 用 method.getName() 和 args 记录入参
  • 用 System.nanoTime() 或 Instant.now() 计算耗时
  • 捕获异常并记录堆栈,再重新抛出保持原有行为
  • 对返回值做简单格式化(如字符串截断、null 处理),避免日志刷屏
public class LoggingInvocationHandler implements InvocationHandler {
    private final Object target;
<pre class="brush:php;toolbar:false;">public LoggingInvocationHandler(Object target) {
    this.target = target;
}

@Override
public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
    String methodName = method.getName();
    System.out.println("[LOG] → " + methodName + "(" + Arrays.toString(args) + ")");

    long start = System.nanoTime();
    try {
        Object result = method.invoke(target, args);
        long cost = TimeUnit.NANOSECONDS.toMillis(System.nanoTime() - start);
        System.out.println("[LOG] ← " + methodName + " = " + result + " (cost: " + cost + "ms)");
        return result;
    } catch (InvocationTargetException e) {
        long cost = TimeUnit.NANOSECONDS.toMillis(System.nanoTime() - start);
        System.err.println("[LOG] ✗ " + methodName + " threw " + e.getTargetException().getClass().getSimpleName()
                + " (cost: " + cost + "ms)");
        throw e.getTargetException();
    }
}

}

Bailian Usage Proxy
Bailian Usage Proxy

阿里百炼大模型平台多人共享账号用量统计代理服务。解决公司共用账号时无法区分个人用量的问题。适用场景:1)部署用量统计代理;2)统计多人Token用量和调用次数;3)管理大模型API调用配额。

下载

创建代理实例并使用

调用 Proxy.newProxyInstance() 时需传入三要素:

  • ClassLoader:一般用目标对象的类加载器,如 target.getClass().getClassLoader()
  • Class[] interfaces:目标对象实现的所有接口,如 new Class[]{UserService.class}
  • InvocationHandler:上面写的日志处理器实例
UserService realService = new UserServiceImpl();
UserService proxy = (UserService) Proxy.newProxyInstance(
        realService.getClass().getClassLoader(),
        realService.getClass().getInterfaces(),
        new LoggingInvocationHandler(realService)
);
<p>// 后续所有调用都走代理,自动打印日志
proxy.getName(123);
proxy.updateName(123, "Alice");</p>

进阶建议:提升实用性

生产中可进一步优化:

  • 用 SLF4J 替代 System.out,支持日志级别、异步、结构化输出
  • 加白名单/黑名单控制哪些方法需要日志(如跳过 toString()、hashCode())
  • 提取公共日志模板,支持配置开关、采样率(如只记录耗时 >100ms 的调用)
  • 结合 MDC 在日志中透传 traceId,便于链路追踪

不复杂但容易忽略:确保 InvocationHandler 中抛出的异常类型与原方法声明一致,否则编译可能通过但运行时报 UndeclaredThrowableException。实际开发中建议统一包装或声明 throws Throwable 并由上层处理。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java proxy

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

11597

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

8722

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

7492

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1224

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

988

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1476

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3049

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20311

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1335

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习