java动态代理怎么写

是关于Java动态代理的详细实现指南：

核心原理与组件

Java动态代理基于JDK内置的java.lang.reflect.Proxy类和InvocationHandler接口实现，其本质是在运行时动态生成一个代理类的字节码，该类会实现目标对象的接口，并将所有方法调用转发给指定的调用处理器（即InvocationHandler），这种机制允许开发者在不修改原始类的情况下，为对象添加额外的行为逻辑（如日志记录、性能监控等）。

实现步骤详解

定义业务接口

首先需要有一个或多个被代理的目标接口,我们创建一个用户服务的接口：

public interface UserService {
    void addUser(String name);
    void deleteUser(int id);
}

注意：JDK动态代理要求目标必须是接口类型，不能直接代理具体类（若需代理类，则应使用CGLIB）。

实现InvocationHandler

编写自定义的调用处理器，在其中编码增强逻辑,以下示例展示了如何添加日志功能：

import java.lang.reflect.Method;
import java.util.Arrays;
public class LoggingHandler implements InvocationHandler {
    private final Object target; // 被代理的真实对象
    public LoggingHandler(Object target) {
        this.target = target;
    }
    @Override
    public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
        // 前置通知：打印方法名和参数
        System.out.println("[LOG] Calling method: " + method.getName() + " with args: " + Arrays.toString(args));
        // 执行原始方法
        Object result = method.invoke(target, args);
        // 后置通知：打印返回结果
        System.out.println("[LOG] Method returned: " + result);
        return result;
    }
}

此处的method.invoke(target, args)会真正调用目标对象的方法,而上下两部分则是插入的公共逻辑。

创建代理对象

通过Proxy.newProxyInstance()工厂方法生成代理实例：

// 假设已有一个实现了UserService的具体类 RealUserService
UserService realImpl = new RealUserService();
// 包装成InvocationHandler
LoggingHandler handler = new LoggingHandler(realImpl);
// 获取代理对象（强制转换为对应接口类型）
UserService proxyInstance = (UserService) Proxy.newProxyInstance(
    realImpl.getClass().getClassLoader(),          // 使用与目标相同的类加载器
    new Class[]{UserService.class},                 // 要代理的接口列表
    handler                                       // 自定义的调用处理器
);

此时proxyInstance就是一个完全功能的代理对象，它可以像普通对象一样调用方法,但内部会自动触发日志记录。

验证效果

测试代码如下：

public class Main {
    public static void main(String[] args) {
        UserService userService = (UserService) Proxy.newProxyInstance(...); // 同上一步
        userService.addUser("Alice");              // 输出日志并执行添加操作
        userService.deleteUser(1001);              // 输出日志并执行删除操作
    }
}

运行后控制台将显示类似以下内容：

[LOG] Calling method: addUser with args: [Alice]
[LOG] Method returned: null
[LOG] Calling method: deleteUser with args: [1001]
[LOG] Method returned: null

典型应用场景

• AOP面向切面编程：统一处理事务提交回滚、权限校验等跨模块需求；
• 性能监控：统计各个接口的响应时间；
• 缓存机制：对高频查询的结果进行临时存储；
• 远程过程调用（RPC）：作为服务端存根自动打包传输协议。

优缺点分析

FAQs

Q1: 如果目标类没有实现任何接口，还能用JDK动态代理吗？
A: 不能，JDK动态代理要求目标必须实现至少一个接口，如果需要代理普通类，应改用CGLIB库（基于字节码增强技术），它可以直接代理非接口类，例如使用Enhancer类配合MethodInterceptor实现类似功能。

Q2: 为什么有时会出现“java.lang.IllegalArgumentException: No such method definition”错误？
A: 此异常通常由两个原因导致：①传递给Proxy.newProxyInstance()的接口列表与目标对象实际实现的接口不一致；②调用的方法不存在于声明的接口中，解决方案是仔细检查接口定义和方法签名是否匹配，若接口声明了void save();但实现类写成了int save()，就会因返回