Lecciones

Introducción breve y moderna al formato de intercambio de datos JSON: qué es y por qué se ha convertido en el estándar de facto para REST API; estructuras básicas — objetos { } y arrays [ ]; tipos permitidos (cadenas "...", números, valores booleanos true/ false, null); anidamiento; comparación con XML; correspondencias JSON ↔ Java (colecciones Map<K, V>, HashMap<K, V>). Analizamos ejemplos prácticos y errores típicos: comillas simples, comas sobrantes, undefined, números con ceros a la izquierda.

Jackson es el estándar de facto para trabajar con JSON en Java: desde operaciones simples de serialización y deserialización mediante ObjectMapper hasta un ajuste fino con las anotaciones @JsonProperty, @JsonIgnore, @JsonInclude, @JsonFormat. En la lección veremos cómo añadir la dependencia ( jackson-databind), la lectura y escritura de objetos y colecciones, el pretty printing, el trabajo con fechas y los errores típicos, incluidos los genéricos con TypeReference y los requisitos para los POJO (constructor sin parámetros, getters/setters).

En esta lección analizamos la biblioteca Google Gson: inicio rápido con los métodos toJson/ fromJson, deserialización de colecciones mediante TypeToken<>, configuración flexible con GsonBuilder ( setPrettyPrinting, serializeNulls, setDateFormat). Veremos las anotaciones @SerializedName, @Expose, el versionado con @Since/ @Until, adaptadores propios mediante TypeAdapter y registerTypeAdapter, y luego compararemos con Jackson y revisaremos errores típicos.

Cuando la estructura de un JSON es desconocida de antemano o cambia con frecuencia, es más cómodo trabajar no con clases de Java rígidas, sino con contenedores universales: Map, List y árboles JSON. En la lección vemos cómo, con ObjectMapper, leer los datos en Map<String, Object> y List; cómo recorrer el árbol de forma segura mediante JsonNode y sus métodos get/ path/ asText(); y también la alternativa con Gson usando JsonElement, JsonObject, JsonArray. Cerramos con práctica de extracción de configuración y un repaso de errores típicos.

Para qué y cómo comprobar los datos de entrada en formato JSON antes de deserializar: analizamos el contrato de datos con JSON Schema (claves type, properties, required, format), validamos en Java con la biblioteca everit-org/json-schema (carga de esquema en Schema, llamada a validate), gestionamos correctamente ValidationException y formamos mensajes de error claros para usuarios y API.