JPA Enum 型別處理完整指南：映射策略與最佳實踐

Thu, 05 Jan 2023 23:18:48 +0800

概述

在企業級應用程式開發中，Enum（列舉）是表示有限狀態集合的理想選擇，如訂單狀態、使用者角色、審核狀態等。本文深入探討如何在 JPA/Hibernate 中有效處理 Enum 型別，包含各種映射策略、效能考量和實際應用場景。

基本 Enum 映射

1. @Enumerated 註解

JPA 提供 @Enumerated 註解來處理 Enum 映射，支援兩種策略：

EnumType.ORDINAL（數字映射）

// 定義狀態列舉
public enum OrderStatus {
    PENDING,    // 0
    CONFIRMED,  // 1
    SHIPPED,    // 2
    DELIVERED,  // 3
    CANCELLED   // 4
}

// 實體類使用
@Entity
@Table(name = "orders")
public class Order {
    
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    @Enumerated(EnumType.ORDINAL)
    @Column(name = "status", nullable = false)
    private OrderStatus status = OrderStatus.PENDING;
    
    // 其他屬性...
}

資料庫儲存：

ORM on Bill.Lin's Notes

JPA Enum 型別處理完整指南：映射策略與最佳實踐

概述

基本 Enum 映射

1. @Enumerated 註解

EnumType.ORDINAL（數字映射）