JPA / Hibernate — Mapping avancé (@Enumerated, @Transient, @Lob)

public enum OrderStatus { PENDING, CONFIRMED, SHIPPED, DELIVERED, CANCELLED }

@Entity
class Order {
    // ✓ STRING — stocke le nom de l'enum
    @Enumerated(EnumType.STRING)
    @Column(length = 50)
    OrderStatus status;   // stocke "PENDING", "CONFIRMED", etc.

    // ❌ ORDINAL — stocke la position (0, 1, 2...)
    @Enumerated(EnumType.ORDINAL)
    OrderStatus status;
}

// État initial en DB : status=3 → DELIVERED
enum OrderStatus { PENDING, CONFIRMED, SHIPPED, DELIVERED, CANCELLED }
//                     0        1         2         3         4

// Un développeur ajoute PROCESSING au milieu
enum OrderStatus { PENDING, CONFIRMED, PROCESSING, SHIPPED, DELIVERED, CANCELLED }
//                     0        1          2           3         4         5

-- Après la modification :
-- status=3 qui était DELIVERED → devient SHIPPED (position 3)
-- status=4 qui était CANCELLED → devient DELIVERED (position 4)
-- Aucune erreur SQL, aucune exception, données corrompues

// ✓ Renommer un enum avec STRING — trivial
// SHIPPED → IN_TRANSIT
UPDATE orders SET status = 'IN_TRANSIT' WHERE status = 'SHIPPED';

// ❌ Renommer avec ORDINAL — impossible sans corruption
// La position est gravée, le nom n'a aucune importance

@Entity
class Order {
    @Id Long id;

    @Column(precision = 10, scale = 2)
    BigDecimal amountHT;

    @Column(precision = 5, scale = 2)
    BigDecimal taxRate;

    // ✓ Calculé à la volée — pas de colonne amount_ttc en DB
    @Transient
    private BigDecimal amountTTC;

    public BigDecimal getAmountTTC() {
        if (amountTTC == null) {
            amountTTC = amountHT.multiply(BigDecimal.ONE.add(taxRate));
        }
        return amountTTC;
    }
}

// @PostLoad pour remplir un champ @Transient après chargement depuis la DB
@PostLoad
void computeFullName() {
    this.fullName = firstName + " " + lastName;
}

@Entity
class Article {
    @Id Long id;
    String title;

    @Lob
    @Column(columnDefinition = "TEXT")
    String content;     // texte long — peut stocker plusieurs Mo
}

@Entity
class Document {
    @Id UUID id;
    String filename;

    @Lob
    @Column(columnDefinition = "BYTEA")   // PostgreSQL
    byte[] data;        // fichier PDF, image...
}

@Entity
class Document {
    @Id Long id;
    String title;

    @OneToOne(mappedBy = "document", fetch = FetchType.LAZY)
    DocumentContent content;   // ✓ non chargé par défaut
}

@Entity
class DocumentContent {
    @Id Long id;

    @OneToOne @MapsId
    Document document;

    @Lob
    byte[] data;
}

// Listing léger — pas de chargement du contenu
List<Document> docs = documentRepository.findAll();

// Chargement du contenu uniquement quand nécessaire
byte[] data = doc.getContent().getData();

@Entity
class Document {
    @Id UUID id;
    String title;

    @Column(length = 500)
    String s3Key;   // ✓ DB légère, données dans S3/GCS/Azure Blob
}