Java 動態代理機制深度解析：從 InvocationHandler 到 Spring AOP 核心原理

動態代理兩大核心角色

核心 API 詳細說明

InvocationHandler.invoke 三個參數

Object invoke(Object proxy, Method method, Object[] args)

• proxy：代理物件本身（非真實物件）
• method：被呼叫的真實方法對應的 Method 物件
• args：呼叫方法傳入的引數陣列

Proxy.newProxyInstance 三個參數

Object newProxyInstance(ClassLoader loader, Class[] interfaces, InvocationHandler h)

• loader：載入代理類別的類別載入器
• interfaces：代理類別實作的介面陣列（決定代理可被轉型為哪些型別）
• h：關聯的 InvocationHandler 實例

完整實戰範例：房屋出租代理

1. 定義業務介面

public interface Subject {
    void rent();
    void hello(String str);
}

2. 真實主體實作

public class RealSubject implements Subject {
    public void rent() { System.out.println("I want to rent my house"); }
    public void hello(String str) { System.out.println("hello: " + str); }
}

3. 動態代理類別

public class DynamicProxy implements InvocationHandler {
    private Object subject;  // 真實物件

    public DynamicProxy(Object subject) { this.subject = subject; }

    @Override
    public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
        System.out.println("before rent house");      // 前置增強
        System.out.println("Method: " + method);
        method.invoke(subject, args);                 // 委派真實物件執行
        System.out.println("after rent house");       // 後置增強
        return null;
    }
}

4. 客戶端使用

public class Client {
    public static void main(String[] args) {
        Subject realSubject = new RealSubject();
        InvocationHandler handler = new DynamicProxy(realSubject);

        Subject subject = (Subject) Proxy.newProxyInstance(
            handler.getClass().getClassLoader(),
            realSubject.getClass().getInterfaces(),
            handler
        );

        System.out.println(subject.getClass().getName()); // 輸出：$Proxy0
        subject.rent();
        subject.hello("world");
    }
}

執行結果與關鍵解析

$Proxy0
before rent house
Method: public abstract void com.xiaoluo.dynamicproxy.Subject.rent()
I want to rent my house
after rent house
before rent house
Method: public abstract void com.xiaoluo.dynamicproxy.Subject.hello(java.lang.String)
hello: world
after rent house

為什麼代理類別名稱是 $Proxy0？

JVM 運行時動態生成的類別，命名規則：$Proxy + 數字編號。它不是 InvocationHandler 也不是業務介面，但實作了指定介面，故可轉型為 Subject。