Formations — 1 037 leçons en français

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 pour java.time quand les horodatages numériques sont désactivés, et celui que new 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.time sont écrites en nombre (secondes ou millisecondes depuis l'epoch) ou en texte ISO 8601. Spring Boot la positionne à false par 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 un number flottant : les calculs d'argent dans le navigateur sont donc à éviter, ou à cantonner à l'affichage.

null vs undefined

En JavaScript, null est une valeur présente qui vaut « rien » ; undefined signale une propriété absente. Un JSON ne contient jamais undefined : un champ absent du JSON donne undefined en JavaScript, un champ null donne null. La distinction est centrale pour les mises à jour partielles.

@JsonInclude(NON_NULL)

Annotation Jackson qui omet du JSON les champs valant null au 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

Instant est un point précis sur la ligne du temps (toujours en UTC, sérialisé avec un Z). LocalDateTime est une date et une heure sans fuseau : 2026-11-06T14:30 ne désigne pas le même moment à Paris et à Tokyo. Pour un horodatage d'événement, Instant est le bon choix.

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.