J2EE 分層架構數據表示規範：Form Bean、VO/PO 分離與 Hibernate 實踐

核心原則：分層數據模型隔離

規範 J2EE 架構中，各層維護專屬數據模型，嚴禁跨層傳播：

為什麼必須分離？

1. 結構不對稱

• 註冊頁面：First Name / Middle Name / Last Name 三字段 → UserForm
• 用戶實體：單一 Name 值對象 + 權限集合 + 組織集合 + 貼子集合 → UserPO
• 頁面新增「昵稱」字段 → 只改 UserForm + Action 轉換邏輯，UserPO、數據庫零變動

2. 變更隔離

• 頁面流程調整 → 僅影響 Form Bean & Action
• 數據庫加索引/分表 → 僅影響 PO & DAO & 映射文件
• 業務規則變更 → 僅影響 VO & Service

3. 安全與性能

• PO 包含敏感字段 (鹽值哈希密碼、薪資、內部狀態)，絕不可序列化到前端
• PO 懶加載集合 (權限、訂單) 在無 Session 的 View 層訪問將拋出 LazyInitializationException

Hibernate 場景下的 PO/VO 合併爭議

Hibernate PO 支持脫管狀態、延遲加載、增脏檢查，理論上可作為 VO 在 Service 層流轉。但強烈建議保持邏輯分離：

• 定義 UserVO 精簡屬性 (id、name、email、status)，Service 返回 VO
• Action 中 BeanUtils.copyProperties(userPO, userVO) 或 MapStruct 自動映射
• 複雜查詢直接用 HQL/JPQL 投影構造 VO (SELECT new UserVO(u.id, u.name) FROM User u)，避免加載完整 PO

例外：極簡 CRUD 內部系統，可暫時合併，但需在架構文檔標註技術債，重構時拆分。

完整數據流轉示例

用戶註冊 (寫操作)

// 1. JSP 提交 Form
// 2. Struts 自動填充 UserForm (firstName, middleName, lastName, email, password)
// 3. Action.register()
public ActionForward register(ActionMapping mapping, ActionForm form) {
    UserForm uf = (UserForm) form;
    // 4. Form → VO 轉換 (Action 責任)
    UserVO vo = new UserVO();
    vo.setFullName(uf.getFirstName() + " " + uf.getMiddleName() + " " + uf.getLastName());
    vo.setEmail(uf.getEmail());
    vo.setRawPassword(uf.getPassword());
    
    // 5. 調用業務服務
    userService.register(vo); // Service 內部 VO → PO → DAO.save(po)
    
    // 6. 返回結果
    return mapping.findForward("success");
}

用戶查詢 (讀操作)

// 1. JSP 提交查詢 Form (fullName)
// 2. Action.query()
public ActionForward query(ActionMapping mapping, ActionForm form) {
    QueryForm qf = (QueryForm) form;
    // 3. Form → 參數對象
    Name name = new Name(qf.getFirstName(), qf.getMiddleName(), qf.getLastName());
    
    // 4. 業務查詢返回 VO (不含敏感/集合字段)
    UserVO vo = userService.findByName(name); // Service: PO → VO 投影
    
    // 5. VO → Form Bean (用於頁面回顯)
    UserForm uf = new UserForm();
    BeanUtils.copyProperties(vo, uf);
    request.setAttribute("userForm", uf);
    
    return mapping.findForward("detail");
}

避坑檢查清單

1. [ ] 所有 JSP 僅讀取 Form Bean / VO，零 PO 引用
2. [ ] Action/Controller 唯一允許持有 Form Bean、VO 引用
3. [ ] Service 方法簽名僅包含 VO、參數對象、領域模型
4. [ ] DAO 方法簽名僅包含 PO、主鍵、查詢條件對象
5. [ ] 映射轉換代碼集中在 Action (Form↔VO) 與 Service/DAO (VO↔PO)，使用 MapStruct/Dozer 自動化
6. [ ] 敏感字段 (passwordHash、salary、internalStatus) 僅存在 PO，絕不出現在 VO/Form

總結

Form Bean 面向頁面，VO 面向業務，PO 面向存儲。 三層模型各司其職，在 Action (Web→Service) 與 Service/DAO (Service↔Persistence) 邊界進行顯式轉換。這看似增加樣板代碼，實則是為系統長期可維護性、安全性、擴展性支付的必要保費。Hibernate 的強大特性不應成為打破分層邊界的借口，紀律性架構才能應對業務複雜度的指數級增長。