Hibernate update 與 saveOrUpdate 深度解析：跨 Session 狀態管理的核心差異

Hibernate 最核心概念是持久化物件 (PO) 的狀態管理。理解 update() 與 saveOrUpdate() 的差異，關鍵在於掌握 PO 的三種狀態與跨 Session 情境。

PO 三種狀態

Hibernate 強大之處： 脫管態物件可進入新 Session 繼續狀態管理 (JDO 1.x 做不到)，這需要 update() 或 saveOrUpdate() 協助 — Reference 稱為「requires a slightly different programming model」。

何時需要顯式呼叫 update/saveOrUpdate？

只有「跨 Session」且「在 Session 外修改了屬性」時才需要。

同一 Session 內修改：自動髒檢測，無需顯式呼叫

Foo foo = sess.load(Foo.class, id);
foo.setXXX(xxx);
sess.flush();  // Hibernate 自動偵測變更發送 UPDATE SQL
sess.commit();

加上 sess.update(foo) 雖不報錯但多餘。

跨 Session 修改：必須顯式通知 Hibernate

// Session 1
Cat cat = (Cat) firstSession.load(Cat.class, catId);
Cat potentialMate = new Cat();
firstSession.save(potentialMate);

// 應用層 (Session 外)
cat.setMate(potentialMate);  // 修改關聯

// Session 2
secondSession.update(cat);   // 必須顯式 update
secondSession.update(mate);

cat、mate 在 Session 1 關閉後變為脫管態。Session 2 不知道 cat.setMate() 這個 Session 外修改，**必須呼叫 update() 明確告知「這個物件變了，請發送 UPDATE SQL」**。

saveOrUpdate()：解決 DAO 介面的狀態未知難題

問題場景

DAO 封裝持久化邏輯，業務層調用 addMate(Cat cat, Mate mate)。業務層不知道傳入的 cat 是：

• 新 new 的瞬時態物件 (需 save())
• 查詢出來的脫管態物件 (需 update())

若 DAO 寫死 session.update(cat)，傳入新物件會拋異常；寫死 save()，傳入脫管物件會重複插入。

saveOrUpdate() 智慧判斷

public void addMate(Cat cat, Mate mate) {
    Session session = ...;
    Transaction tx = ...;
    session.saveOrUpdate(cat);  // 自動判斷：瞬時態→save，脫管態→update
    cat.addMate(mate);
    tx.commit();
    session.close();
}

判斷依據： unsaved-value 設定 (通常是 id 屬性為 null/0 視為瞬時態)。

業務層呼叫變得極簡單

// 業務層完全不用關心 cat 狀態
dao.addMate(cat, mate);

核心差異總結

最佳實踐建議

1. 同一 Session 內修改： 完全依賴自動髒檢測，**不要**呼叫 update/saveOrUpdate
2. DAO 公開介面： 優先使用 saveOrUpdate()，封裝狀態判斷邏輯，讓上層無感知
3. 明確知曉狀態的內部代碼： 可用 update() 語義更清晰
4. 正確配置 unsaved-value： 通常 `` (數值型) 或 `"null"` (物件型)，確保判斷準確
5. 避免手動管理狀態： 讓 Hibernate 透過 Session 管理持久化生命週期，業務代碼聚焦領域邏輯

掌握跨 Session 狀態管理，是從「會用 Hibernate」進階到「善用 Hibernate」的關鍵分水嶺。