Lezioni

Introduzione breve e moderna al formato di scambio dati JSON: cos’è e perché è diventato lo standard de facto per le REST API, strutture di base — oggetti { } e array [ ], tipi consentiti (stringhe "...", numeri, valori booleani true/ false, null), annidamento, confronto con XML, corrispondenze JSON ↔ Java (collezioni Map<K, V>, HashMap<K, V>). Analizziamo esempi pratici ed errori tipici: apici singoli, virgole in eccesso, undefined, numeri con zeri iniziali.

Jackson — lo standard de facto per lavorare con JSON in Java: dalle semplici operazioni di serializzazione e deserializzazione tramite ObjectMapper alla configurazione fine con le annotazioni @JsonProperty, @JsonIgnore, @JsonInclude, @JsonFormat. In questa lezione vedremo come aggiungerlo ( jackson-databind), leggere e scrivere oggetti e collezioni, fare pretty printing, gestire le date e gli errori tipici, inclusi i generics con TypeReference e i requisiti dei POJO (costruttore senza argomenti, getter/setter).

In questa lezione analizziamo la libreria Google Gson: guida rapida con i metodi toJson/ fromJson, deserializzazione di collezioni tramite TypeToken<>, configurazione flessibile con GsonBuilder ( setPrettyPrinting, serializeNulls, setDateFormat). Vedremo le annotazioni @SerializedName, @Expose, il versioning con @Since/ @Until, adapter personalizzati tramite TypeAdapter e registerTypeAdapter, e poi un confronto con Jackson e gli errori tipici.

Quando la struttura JSON non è nota in anticipo o cambia spesso, è più comodo lavorare non con classi Java rigide, ma con contenitori universali: Map, List e alberi JSON. Nella lezione vediamo come, con ObjectMapper, leggere i dati in Map<String, Object> e List, come attraversare in modo sicuro l’albero tramite JsonNode e i suoi metodi get/ path/ asText(), nonché l’alternativa con Gson con JsonElement, JsonObject, JsonArray. Concludiamo con la pratica di estrazione della configurazione e l’analisi degli errori tipici.

Perché e come verificare i dati in ingresso nel formato JSON prima della deserializzazione: analizziamo il contratto sui dati tramite JSON Schema (chiavi type, properties, required, format), convalidiamo in Java con la libreria everit-org/json-schema (caricamento dello schema in Schema, chiamata a validate), gestiamo correttamente ValidationException e generiamo messaggi di errore chiari per utenti e API.