Formations — 1 037 leçons en français

Accueil › SQL & bases de données › Types Java et types SQL, sans mauvaise surprise

Types Java et types SQL, sans mauvaise surprise

SQL vu depuis Java et JPAavance

Le mapping entre types Java et types SQL concentre quelques pièges qui se paient cher.

SQL Java À éviter
numeric(10,2) BigDecimal double, float
timestamptz Instant, OffsetDateTime LocalDateTime, java.util.Date
date LocalDate Instant
time LocalTime —
text String —
boolean boolean (primitif si NOT NULL) Boolean nullable par défaut
uuid UUID String
jsonb String + @JdbcTypeCode(SqlTypes.JSON), ou type dédié String brut

Le piège le plus coûteux est @Enumerated :

// ✗ défaut de JPA : stocke la position (0, 1, 2…)
@Enumerated(EnumType.ORDINAL)
private Statut statut;

// ✓ stocke le nom
@Enumerated(EnumType.STRING)
@Column(length = 20)
private Statut statut;

Avec ORDINAL, insérer une valeur au milieu de l'énumération change le sens de toutes les lignes déjà en base — sans erreur, sans avertissement.

Le deuxième est BigDecimal.equals, qui compare aussi l'échelle : 10.5 n'est pas equals à 10.50. Utilisez compareTo.

Les termes à connaître

BigDecimal

Le seul type Java correct pour un montant, correspondant à numeric. double reproduit exactement les erreurs de représentation des flottants binaires.

Instant / OffsetDateTime

Les types Java correspondant à timestamptz : un instant absolu. LocalDateTime correspond à timestamp sans fuseau, LocalDate à date.

@Enumerated

EnumType.ORDINAL (défaut !) stocke la position de la valeur : insérer une valeur au milieu de l'énumération corrompt toutes les lignes existantes. Toujours EnumType.STRING.

@Column(columnDefinition)

Permet de préciser le type SQL exact quand le mapping par défaut ne convient pas — par exemple jsonb ou numeric(12,2).

setScale / RoundingMode

Un BigDecimal a une échelle : 10.5 et 10.50 sont égaux numériquement mais différents pour equals(). Fixez l'échelle avant comparaison et persistance.

Type personnalisé

@JdbcTypeCode(SqlTypes.JSON) (Hibernate 6) ou un AttributeConverter permettent de mapper jsonb, des tableaux, ou un type métier vers une colonne.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.