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.doublereproduit exactement les erreurs de représentation des flottants binaires.- Instant / OffsetDateTime
Les types Java correspondant à
timestamptz: un instant absolu.LocalDateTimecorrespond àtimestampsans 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. ToujoursEnumType.STRING.- @Column(columnDefinition)
Permet de préciser le type SQL exact quand le mapping par défaut ne convient pas — par exemple
jsonbounumeric(12,2).- setScale / RoundingMode
Un
BigDecimala une échelle :10.5et10.50sont égaux numériquement mais différents pourequals(). Fixez l'échelle avant comparaison et persistance.- Type personnalisé
@JdbcTypeCode(SqlTypes.JSON)(Hibernate 6) ou unAttributeConverterpermettent de mapperjsonb, des tableaux, ou un type métier vers une colonne.
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.