Apache Cayenne 入門實戰：從環境搭建、建模到 CRUD 完整演示

Eclipse 刷新項目，即見 com.example.cayenne 包下實體類，Derby 數據庫文件生成於項目目錄。

五、核心 API 速覽

六、完整 Demo：初始化 → 查詢 → 下單

1. 清空並裝載基礎數據

// 刪除客戶與商品，級聯刪除訂單
context.deleteObject(client);
context.deleteObject(commodity);
context.commitChanges();

// 讀取 loadData.sql 腳本批量執行
QueryChain chain = new QueryChain();
BufferedReader in = new BufferedReader(new InputStreamReader(
    getClass().getResourceAsStream("/loadData.sql")));
String line;
while ((line = in.readLine()) != null) {
    if (line.endsWith(";")) line = line.substring(0, line.length()-1);
    chain.addQuery(new SQLTemplate(domain.getMap("cayenne-storeMap"), line));
}
context.performNonSelectingQuery(chain);

2. 查詢客戶及其訂單

List clients = context.performQuery("allClients");
for (ClientTB c : clients) {
    System.out.println(c.getClientName() + " " + c.getClientMail());
    for (OrderTB o : c.getOrdersOwned()) {
        StringBuilder sb = new StringBuilder();
        for (OrderCommodityTB oc : o.getCommoditiesContained()) {
            sb.append(oc.getCommoditiesBought().getComName()).append(", ");
        }
        System.out.println("  Order: " + sb + " on " + o.getOrderDate());
    }
}

3. 模擬下單流程

ClientTB buyer = context.performQuery(new SelectQuery(ClientTB.class, 
    Expression.fromString("clientName = 'YingChu'"))).get(0);

CommodityTB phone = ... get "Nokia Phone n95";
CommodityTB laptop = ... get "ThinkPad T61p";

OrderTB order = context.newObject(OrderTB.class);
order.setOrderDate(new Date());
order.setClientBelonged(buyer);  // 關聯買家

OrderCommodityTB item1 = context.newObject(OrderCommodityTB.class);
item1.setComNumber(1);
item1.setBelongedToOrders(order);
item1.setCommoditiesBought(phone);

OrderCommodityTB item2 = context.newObject(OrderCommodityTB.class);
item2.setComNumber(1);
item2.setBelongedToOrders(order);
item2.setCommoditiesBought(laptop);

// 庫存扣減
phone.setCommodityNumber(phone.getCommodityNumber() - 1);
laptop.setCommodityNumber(laptop.getCommodityNumber() - 1);

context.commitChanges();  // 一次性提交事務

七、DAO 封裝建議

項目結構建議：

dao/
├── ClientDao.java
├── CommodityDao.java
├── OrderDao.java
└── CayenneStoreDao.java  // 持有 DataContext、commitChanges() 等通用邏輯

所有 DAO 實現注入 CayenneStoreDao 獲取 DataContext，業務層調用 DAO，解耦持久化細節。

八、常見坑與避坑指南

1. cayenne.xml 必須在 Classpath 根目錄：src/ 或 resources/，否則 DataContext.createDataContext() 拋 NullPointerException
2. Delete Rule 設置：CASCADE 刪除父級聯刪子，NULLIFY 置空 FK，DENY 禁止刪除，NO_ACTION 交由數據庫約束
3. DataContext 線程不安全：每請求/每線程一個實例，勿作為單例字段
4. 預讀關係名稱：addPrefetch("orders") 參數必須與 ObjEntity Relationship 名稱完全一致，區分大小寫

九、結語與進階預告

通過本文，你已掌握 Cayenne 的環境搭建、可視化建模、代碼生成、核心 API 及完整業務流程。下一步可深入學習：

• ROP 遠程持久化：跨 JVM/跨機器共享 ORM 能力
• 性能優化：連接池調優、五級緩存策略、分頁與預讀組合
• 遷移與版本控制：映射文件演進、數據庫遷移腳本管理

CayenneModeler + 零 XML 配置 + 豐富企業級特性，讓 ORM 回歸「領域建模」本質。開始你的 Cayenne 之旅吧！