讲师中心 微信公众号
AI工具推荐 视频效率加速

Java动态代理与接口代理的基本语法

胖磊小哥_5063

胖磊小哥_5063

发布时间:2026-01-07 14:12:08

|

318人浏览过

|

来源于php中文网

原创

JDK动态代理只能代理接口,不能代理类,因生成的代理类需继承Proxy且Java不支持多重继承;代理对象仅实现指定接口,类型检查须用接口而非实现类。

java动态代理与接口代理的基本语法

Java动态代理必须基于接口,不能代理类

Java标准库的 java.lang.reflect.Proxy 只支持对接口的代理,这是硬性限制。如果你尝试用它去代理一个普通类(比如 ArrayList),会直接抛出 IllegalArgumentException: com.sun.proxy.$Proxy0 is not an interface 这类错误——不是配置问题,是设计如此。

原因在于:JDK动态代理在运行时生成的代理类(如 $Proxy0)必须继承 Proxy 类,而 Java 不允许多重继承,所以只能实现接口,不能扩展具体类。

  • 要代理类,请改用 CGLIB 或 Javassist
  • 若目标对象实现了多个接口,Proxy.newProxyInstance() 生成的代理对象会同时实现全部接口
  • 即使只打算调用其中某一个接口的方法,也必须把所有接口都传给 newProxyInstance() 的第二个参数(Class>[])

InvocationHandler 是核心回调,不是装饰器

InvocationHandler 的 invoke() 方法不是“包装原有逻辑”,而是完全接管调用过程。你必须显式决定是否、何时、如何调用原对象的方法(即通过 method.invoke(target, args))。

常见误写是漏掉这一步,导致方法调用静默失效:

立即学习“Java免费学习笔记(深入)”;

public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
    System.out.println("before");
    // ❌ 忘了调用 target.method(...),方法不会执行
    System.out.println("after");
    return null;
}

正确写法需保留原始调用链:

SSL Certificate Checker
SSL Certificate Checker

SSL/TLS 证书到期检查器和域名健康监控。检查证书到期、颁发者信息、SAN 条目及证书链有效性,适用于单个或多个域名。

下载
public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
    System.out.println("before " + method.getName());
    Object result = method.invoke(target, args); // ✅ 显式触发
    System.out.println("after " + method.getName());
    return result;
}
  • proxy 参数是生成的代理对象,一般不用
  • target 是你传入的被代理实例,需在 InvocationHandler 构造时保存
  • 若方法返回基本类型(如 int),invoke() 返回的是其包装类(Integer),注意空指针风险

newProxyInstance 的三个参数缺一不可

Proxy.newProxyInstance(ClassLoader, Class>[], InvocationHandler) 三个参数都有明确语义,任意一个填错都会失败:

  • 第一个参数 ClassLoader:必须能加载目标接口,通常用 target.getClass().getClassLoader() 或 interface.getClass().getClassLoader()
  • 第二个参数 Class>[]:必须是接口数组,不能为 null,也不能包含类(Class 对象的 isInterface() 必须为 true)
  • 第三个参数 InvocationHandler:不能为空,否则抛 NullPointerException

典型错误示例:

// ❌ 错误:传入了 ArrayList.class,它是 class,不是 interface
Proxy.newProxyInstance(..., new Class[]{ArrayList.class}, handler);

// ✅ 正确:传入 List.class(接口)
Proxy.newProxyInstance(..., new Class[]{List.class}, handler);

代理对象类型检查要用接口,不能用 instanceof 具体实现类

生成的代理对象是 com.sun.proxy.$ProxyN 类型,它只实现你指定的接口,不继承任何业务类。因此:

  • proxy instanceof SomeInterface → true
  • proxy instanceof SomeImplClass → false,永远为假
  • proxy.getClass().getInterfaces() 可查到你传入的所有接口

这意味着:依赖具体实现类做类型判断的旧代码,在接入动态代理后会失效,必须改为面向接口判断。

另外,代理对象无法通过反射获取私有字段或调用 private 方法——它只暴露接口声明的公有方法。

热门AI工具

更多
音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

相关专题

更多
c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

549

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1698

2024.03.01

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

7219

2023.08.02

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3445

2024.08.29

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

4508

2025.08.29

C++中int的含义
C++中int的含义

本专题整合了C++中int相关内容,阅读专题下面的文章了解更多详细内容。

3045

2025.08.29

C++ 智能指针与现代内存管理
C++ 智能指针与现代内存管理

深入讲解 C++ 现代内存管理的核心工具——智能指针,涵盖 unique_ptr 独占所有权语义、shared_ptr 引用计数机制与循环引用问题、weak_ptr 弱引用的应用场景、make_unique/make_shared 工厂函数的性能优势、自定义删除器的编写、RAII 资源管理思想的实践,以及从裸指针迁移到智能指针的重构策略,帮助开发者编写安全无泄漏的现代 C++ 代码。

379

2026.04.23

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

3228

2023.10.19

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

0

2026.11.06

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn