Aulas

Introdução breve e moderna ao formato de troca de dados JSON: o que é e por que se tornou o padrão de fato para REST API; estruturas básicas — objetos { } e arrays [ ]; tipos permitidos (strings "...", números, valores booleanos true/ false, null), aninhamento, comparação com XML, correspondências JSON ↔ Java (coleções Map<K, V>, HashMap<K, V>). Analisamos exemplos práticos e erros típicos: aspas simples, vírgulas sobrando, undefined, números com zeros à esquerda.

Jackson — o padrão de fato para trabalhar com JSON em Java: desde operações simples de serialização e desserialização via ObjectMapper até ajustes finos com as anotações @JsonProperty, @JsonIgnore, @JsonInclude, @JsonFormat. Na aula veremos como adicionar ( jackson-databind), ler e escrever objetos e coleções, pretty printing, trabalhar com datas e erros típicos, incluindo generics com TypeReference e requisitos para POJOs (construtor sem parâmetros, getters/setters).

Nesta aula, analisamos a biblioteca Google Gson: início rápido com os métodos toJson/ fromJson, desserialização de coleções via TypeToken<>, configuração flexível com GsonBuilder ( setPrettyPrinting, serializeNulls, setDateFormat). Vamos ver as anotações @SerializedName, @Expose, versionamento @Since/ @Until, adaptadores próprios com TypeAdapter e registerTypeAdapter, e depois comparar com o Jackson e revisar erros típicos.

Quando a estrutura do JSON é desconhecida de antemão ou muda com frequência, é mais conveniente trabalhar não com classes Java rígidas, mas com contêineres universais: Map, List e árvores JSON. Na aula, analisamos como usar ObjectMapper para ler dados em Map<String, Object> e List, como percorrer a árvore com segurança por meio de JsonNode e seus métodos get/ path/ asText(), e também uma alternativa com Gson usando JsonElement, JsonObject, JsonArray. Encerramos com prática de extração de configuração e análise de erros típicos.

Por que e como verificar dados de entrada em formato JSON antes da desserialização: analisamos o contrato de dados via JSON Schema (chaves type, properties, required, format), validamos em Java com a biblioteca everit-org/json-schema (carregar o esquema em Schema, chamar validate), tratamos corretamente ValidationException e criamos mensagens de erro claras para usuários e APIs.