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

JDK动态代理只能代理接口，不能代理类，因生成的代理类需继承Proxy且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)）。

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

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

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

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[]{Ar
rayList.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 方法——它只暴露接口声明的公有方法。