Accueil › Fullstack Angular + Spring Boot › Le JSON échangé : dates, nombres, null et undefined
Le JSON échangé : dates, nombres, null et undefined
Le contrat d'APIdebutant
Entre un type Java et un type TypeScript, il y a du JSON — et le JSON ne connaît que six choses : objets, tableaux, chaînes, nombres, booléens et null. Tout le reste est une convention.
Les correspondances à connaître :
| Java | JSON produit | Type TypeScript |
|---|---|---|
String |
"Clavier" |
string |
int, long |
42 |
number |
long très grand (> 2^53) |
9007199254740993 |
risque de perte de précision |
BigDecimal |
19.90 |
number |
boolean |
true |
boolean |
LocalDate |
"2026-11-06" |
string |
LocalDateTime |
"2026-11-06T14:30:00" |
string |
Instant |
"2026-11-06T13:30:00Z" |
string |
enum |
"VALIDEE" |
union de littéraux |
Optional<T> vide |
null |
T | null |
La règle la plus importante : une date arrive toujours en chaîne. Angular ne convertit rien.
export interface Commande {
id: number;
creeLe: string; // ✅ ISO 8601, pas Date
total: number;
statut: 'EN_ATTENTE' | 'VALIDEE' | 'EXPEDIEE' | 'ANNULEE';
commentaire: string | null; // le back peut renvoyer null
}
<!-- le pipe date accepte une chaîne ISO 8601 -->
<td>{{ commande.creeLe | date: 'dd/MM/yyyy HH:mm' }}</td>
<td>{{ commande.total | currency: 'EUR' }}</td>
Les termes à connaître
- ISO 8601
Format normalisé de représentation des dates et heures en texte (
2026-11-06,2026-11-06T14:30:00,2026-11-06T14:30:00Z). C'est le format produit par Jackson pourjava.timequand les horodatages numériques sont désactivés, et celui quenew Date(...)sait lire en JavaScript.- jackson-datatype-jsr310
Module Jackson qui sait sérialiser les types
java.time(LocalDate,LocalDateTime,Instant…). Il est inclus et enregistré automatiquement par Spring Boot : aucune configuration n'est nécessaire dans un projet Boot standard.- spring.jackson.serialization.write-dates-as-timestamps
Propriété qui décide si les dates
java.timesont écrites en nombre (secondes ou millisecondes depuis l'epoch) ou en texte ISO 8601. Spring Boot la positionne àfalsepar défaut : vous obtenez donc de l'ISO 8601 sans rien faire.- BigDecimal
Type Java à précision décimale exacte, obligatoire pour un montant. Jackson le sérialise en nombre JSON (
19.90). Côté JavaScript, ce nombre devient unnumberflottant : les calculs d'argent dans le navigateur sont donc à éviter, ou à cantonner à l'affichage.- null vs undefined
En JavaScript,
nullest une valeur présente qui vaut « rien » ;undefinedsignale une propriété absente. Un JSON ne contient jamaisundefined: un champ absent du JSON donneundefineden JavaScript, un champnulldonnenull. La distinction est centrale pour les mises à jour partielles.- @JsonInclude(NON_NULL)
Annotation Jackson qui omet du JSON les champs valant
nullau lieu de les écrire. Allège la réponse, mais rend indistinguables « champ absent » et « champ à null » : à n'utiliser qu'en sortie, jamais pour un contrat de mise à jour partielle.- Instant vs LocalDateTime
Instantest un point précis sur la ligne du temps (toujours en UTC, sérialisé avec unZ).LocalDateTimeest une date et une heure sans fuseau :2026-11-06T14:30ne désigne pas le même moment à Paris et à Tokyo. Pour un horodatage d'événement,Instantest le bon choix.
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.