Apache Cayenne 進階特性深度解析：ROP 遠程持久化、連接池、緩存、分頁與預讀

Apache Cayenne 作為成熟的開源 ORM 框架（NHL.com 日均 500 萬訪問量驗證），除基礎 ORM 外，還提供 ROP (Remote Object Persistence) 遠程持久化、多層次連接池、靈活緩存策略、分頁查詢、關係預讀等高階性能優化特性。本文深度解析這些企業級功能的原理、配置與代碼實戰。

一、ROP 遠程對象持久化：輕量級分布式 ORM

架構原理

客戶端                                    服務端
┌─────────────────┐         HTTP/Hessian         ┌─────────────────┐
│ ClientContext   │ ◄─────────────────────────► │ CayenneService  │
│ (ClientChannel) │     序列化 ObjectGraph       │ (HessianServlet)│
└────────┬────────┘                              └────────┬────────┘
         │                                                │
         ▼                                                ▼
┌─────────────────┐                              ┌─────────────────┐
│ Client Persistent│                              │ Server DataMap  │
│ Objects (client)│                              │ DataContext     │
└─────────────────┘                              └────────┬────────┘
                                                          │
                                                          ▼
                                                 ┌─────────────────┐
                                                 │ Database        │
                                                 └─────────────────┘

• 客戶端使用 cayenne-client-nodeps.jar + hessian.jar + commons-*
• 服務端部署 Cayenne Web Service (CWS)：標準 Web App，web.xml 配置 HessianServlet
• 共享映射文件 cayenne.xml、DataMap.map.xml、DataNode.driver.xml

服務端關鍵配置：生成 Client 實體類

1. CayenneModeler → DataMap → ObjEntity → Allow Client Entities ✓
2. Tools → Generate Classes → 類型選 Client Persistent Objects
3. 生成至 com.cn.ibm.client 包，部署至 CWS WEB-INF/classes

客戶端代碼

ClientConnection conn = new HessianConnection("https://host:8090/CayenneCWS/cayenne");
DataChannel channel = new ClientChannel(conn);
ObjectContext context = new CayenneContext(channel);

SelectQuery query = new SelectQuery(com.cn.ibm.client.PersistentObject.class);
List list = context.performQuery(query);
System.out.println(list.get(0));
context.commitChanges();

二、數據庫連接池：內置 vs DBCP

內置連接池（零依賴）

CayenneModeler → DataNode → JDBC Configuration → Min Connections / Max Connections

持久化至 DataNode.driver.xml：

<driver class="org.apache.derby.jdbc.EmbeddedDriver">
    <url value="jdbc:derby:DBContainer"/>
    <connectionPool min="5" max="10" />
</driver>

啟動日誌確認：

INFO: Created connection pool: jdbc:derby:DBContainer
Min. connections in the pool: 5
Max. connections in the pool: 10

SelectQuery q = new SelectQuery(PersistentObject.class);
q.setName("MyQueryForCache");           // 緩存鍵
q.setCachePolicy(QueryMetadata.LOCAL_CACHE);

List r1 = context.performQuery(q);      // 查庫，入緩存
List r2 = context.performQuery(q);      // 命中緩存，不查庫

q.setCachePolicy(QueryMetadata.LOCAL_CACHE_REFRESH);
List r3 = context.performQuery(q);      // 強制刷新

SelectQuery q = new SelectQuery(ClientTB.class);
q.addPrefetch("orders");  // ClientTB.orders 是 to-many 關係
List clients = context.performQuery(q);
for (ClientTB c : clients) {
    System.out.println(c.getOrders().size()); // 內存直接訪問，無額外 SQL
}

SelectQuery q = new SelectQuery(ClientTB.class);
q.setPageSize(50);  // 每頁 50 條
List rows = context.performQuery(q);  // 實際獲取第 1-50 條 + 其餘主鍵

ClientTB c1 = (ClientTB) rows.get(3);    // 內存命中
ClientTB c2 = (ClientTB) rows.get(153);  // 觸發第 4 頁加載 (151-200)