您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 相關知識

深度解析 Java 靜態代理模式：原理、實現與應用場景

編輯：Java 相關知識

靜態代理模式定義

靜態代理是指由程式設計師創建或工具生成代理類的源碼，再編譯為 .class 檔案。代理類與目標類在編譯期就已確定關係，執行前代理類已存在。屬於結構型設計模式。

核心角色

Subject (抽象主題)：定義目標與代理的共同介面
RealSubject (真實主題)：實現具體業務邏輯
Proxy (代理類)：持有 RealSubject 引用，實現 Subject 介面，在調用目標方法前後添加增強邏輯
Client (客戶端)：通過代理類間接訪問目標對象

代碼實現範例

定義共同介面


public interface UserDao {
    void save(User user);
    User findById(Long id);
    List findAll();
}

真實主題實現


public class UserDaoImpl implements UserDao {
    private final DataSource dataSource;
    
    public UserDaoImpl(DataSource dataSource) {
        this.dataSource = dataSource;
    }
    
    @Override
    public void save(User user) {
        try (Connection conn = dataSource.getConnection();
             PreparedStatement ps = conn.prepareStatement(
                 "INSERT INTO users(name, email) VALUES(?, ?)",
                 Statement.RETURN_GENERATED_KEYS)) {
            ps.setString(1, user.getName());
            ps.setString(2, user.getEmail());
            ps.executeUpdate();
            try (ResultSet rs = ps.getGeneratedKeys()) {
                if (rs.next()) user.setId(rs.getLong(1));
            }
        } catch (SQLException e) {
            throw new RuntimeException("保存用戶失敗", e);
        }
    }
    
    @Override
    public User findById(Long id) { /* 查詢實現 */ return null; }
    @Override
    public List findAll() { /* 查詢實現 */ return Collections.emptyList(); }
}

靜態代理類：添加事務與日誌


public class UserDaoProxy implements UserDao {
    private final UserDao target; // 被代理對象
    
    public UserDaoProxy(UserDao target) {
        this.target = target;
    }
    
    @Override
    public void save(User user) {
        // 前置增強：日誌記錄
        long start = System.currentTimeMillis();
        log.info("開始保存用戶: {}", user.getName());
        
        // 事務管理（簡化示意）
        Connection conn = null;
        try {
            conn = dataSource.getConnection();
            conn.setAutoCommit(false); // 開啟事務
            
            // 委派真實對象執行核心邏輯
            target.save(user);
            
            conn.commit(); // 提交事務
            log.info("用戶保存成功，耗時: {}ms", System.currentTimeMillis() - start);
        } catch (Exception e) {
            if (conn != null) try { conn.rollback(); } catch (SQLException ignored) {}
            log.error("保存用戶失敗，事務回滾", e);
            throw new RuntimeException(e);
        } finally {
            if (conn != null) try { conn.close(); } catch (SQLException ignored) {}
        }
    }
    
    @Override
    public User findById(Long id) {
        log.debug("查詢用戶 ID: {}", id);
        return target.findById(id);
    }
    
    @Override
    public List findAll() {
        log.debug("查詢所有用戶");
        return target.findAll();
    }
}

客戶端使用


public class Client {
    public static void main(String[] args) {
        DataSource ds = new HikariDataSource(); // 連接池
        UserDao realDao = new UserDaoImpl(ds);
        UserDao proxyDao = new UserDaoProxy(realDao); // 包裝代理
        
        User user = new User("張三", "zhangsan@example.com");
        proxyDao.save(user); // 實際執行代理邏輯
        
        // 客戶端無感知真實實現，面向介面編程
    }
}

靜態代理 vs 動態代理

維度	靜態代理	動態代理 (JDK/CGLIB)
代理類生成時間	編譯期	執行期
代碼形式	手寫/工具生成 .java	字節碼動態生成
靈活性	低（每目標類需一代理類）	高（統一攔截器處理多類）
效能	最高（直接調用）	略低（反射/MethodHandle 開銷）
適用場景	固定、少量、效能敏感切面	通用、大量、框架級 AOP
調試難度	易（可直接看代碼）	難（動態字節碼）

靜態代理優勢場景

效能關鍵路徑：高頻調用、微秒級延遲要求，避免反射開銷
第三方庫不可修改：無法引入代理框架，手寫包裝器
編譯期驗證：IDE 重構、類型檢查、斷點調試全支援
簡單切面邏輯：僅需日誌、計時、參數校驗等固定增強
GraalVM 原生映像：靜態代碼友善，動態代理需額外配置

進階模式：代理鏈與組合


// 多層代理組合
UserDao dao = new UserDaoImpl(ds);
dao = new LoggingProxy(dao);      // 第1層：日誌
dao = new TransactionProxy(dao);  // 第2層：事務
dao = new CacheProxy(dao);        // 第3層：緩存
dao = new RetryProxy(dao);        // 第4層：重試

// 每層代理只關注單一職責，符合開閉原則