J2EE 分層架構數據表示規範：Form Bean、VO/PO、DTO 邊界劃分與轉換策略

分層架構中數據表示物件的邊界劃分直接決定系統耦合度與可維護性。本文針對 Struts + Hibernate 體系，深度剖析 Form Bean、Value Object (VO)、Persistent Object (PO)、Data Transfer Object (DTO) 的職責邊界、轉換責任歸屬、常見反模式與現代演進方案。

核心概念定義

嚴格分層邊界鐵律

┌─────────────────────────────────────────────────────────────┐
│  Web Layer (JSP/Controller)                                 │
│  Form Bean  ←→  Controller  ←→  Service Interface           │
│         ↑                  ↑                                │
│    轉換責任            調用邊界                              │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│  Service Layer (Business Logic)                             │
│  VO/Domain Object  ←→  Service Impl  ←→  DAO/Repository     │
│         ↑                  ↑                                │
│    領域邏輯            轉換責任                              │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│  Persistence Layer (DAO/ORM)                                │
│  PO/Entity  ←→  Hibernate Session / JPA EntityManager       │
└─────────────────────────────────────────────────────────────┘

關鍵違規場景與後果

轉換責任歸屬與實現策略

Controller/Action 層：Form Bean ↔ VO/DTO

@PostMapping("/register")
public String register(@Valid UserForm form, BindingResult errors) {
    if (errors.hasErrors()) return "register";
    
    // 手工映射 (簡單場景)
    UserVO vo = new UserVO();
    vo.setUsername(form.getUsername());
    vo.setEmail(form.getEmail());
    vo.setPassword(form.getPassword()); // 明文傳給 Service 加密
    
    // 或使用映射框架 (複雜場景)
    // UserVO vo = mapper.map(form, UserVO.class);
    
    userService.register(vo);
    return "redirect:success";
}

Service 層：VO ↔ PO (Hibernate 自動管理)

@Transactional
public void register(UserVO vo) {
    // 領域邏輯
    UserPO po = new UserPO();
    po.setUsername(vo.getUsername());
    po.setEmail(vo.getEmail());
    po.setPasswordHash(passwordEncoder.encode(vo.getPassword()));
    po.setCreatedAt(LocalDateTime.now());
    
    // 關聯處理
    RolePO defaultRole = roleRepository.findByCode("USER");
    po.getRoles().add(defaultRole);
    
    userRepository.save(po); // Hibernate 持久化
    
    // 返回 VO (不暴露 PO)
    return toVO(po);
}

映射框架選型

Hibernate 特殊性：PO 可否當 VO？

短期/簡單項目：可接受。Hibernate Entity 脫離 Session 後變為脫管狀態，實質上等同 VO。

風險：

• 懶加載陷阱：視圖層觸發關聯訪問拋出 `LazyInitializationException`
• 雙向關聯循環引用：JSON 序列化無限遞歸
• 持久化註解污染領域模型：`@Entity`、`@Table`、`@Column` 洩露資料庫結構
• 安全性：`@Transient` 未標記的敏感字段 (密碼哈希、鹽值) 可能序列化輸出

建議：項目啟動即建立明確 PO/VO 分離，使用 MapStruct 映射，長期收益遠超初期投入。

現代架構演進：DTO 驅動 API 設計

// Controller 接收 DTO (API 契約)
@PostMapping("/api/users")
public ResponseEntity create(@RequestBody @Valid CreateUserDTO req) {
    UserVO vo = userService.create(req); // Service 返回 VO
    return ResponseEntity.ok(mapper.toDTO(vo)); // 輸出 DTO
}

// 內部 Service 使用 VO (豐富領域模型)
public UserVO create(CreateUserDTO req) {
    User user = User.register(req.getUsername(), req.getEmail(), req.getPassword());
    userRepository.save(user);
    return toVO(user);
}

// 區別：
// CreateUserDTO: 輸入驗證、文檔化、版本化、不含 ID/創建時間
// UserVO: 領域行為、業務規則、狀態機
// UserDTO: 輸出格式、扁平化、隱藏敏感字段、Hypermedia 鏈接

總結

1. Form Bean 止於 Controller，不進 Service
2. PO 止於 Repository，不出持久層 (Hibernate 管理 Session 內)
3. VO 活躍於 Service 層，承載領域邏輯
4. DTO 服務於邊界傳輸 (Controller 輸入輸出、微服務通訊)
5. 轉換發生在邊界，責任歸屬清晰，工具輔助 (MapStruct 首選)
6. 拒絕單一對象貫穿全層，短期便利長期技術債務

嚴守數據表示邊界，是分層架構低耦合、高內聚、可測試、可演進的基石。