Лекції

Короткий і сучасний вступ до формату обміну даними JSON: що це таке і чому він став стандартом де-факто для REST API, базові структури — об’єкти { } і масиви [ ], допустимі типи (рядки "...", числа, булеві значення true/ false, null), вкладеність, порівняння з XML, відповідності JSON ↔ Java (колекції Map<K, V>, HashMap<K, V>). Розбираємо практичні приклади й типові помилки: одинарні лапки, зайві коми, undefined, числа з провідними нулями.

Jackson — де-факто стандарт роботи з JSON у Java: від простих операцій серіалізації та десеріалізації через ObjectMapper до тонкого налаштування з анотаціями @JsonProperty, @JsonIgnore, @JsonInclude, @JsonFormat. У лекції розглянемо підключення ( jackson-databind), читання та запис об’єктів і колекцій, pretty-printing, роботу з датами та типові помилки, зокрема дженеріки з TypeReference і вимоги до POJO (конструктор без параметрів, гетери/сетери).

У цій лекції розглядаємо бібліотеку Google Gson: швидкий старт із методами toJson/ fromJson, десеріалізацію колекцій через TypeToken<>, гнучку конфігурацію з GsonBuilder ( setPrettyPrinting, serializeNulls, setDateFormat). Розглянемо анотації @SerializedName, @Expose, версійність @Since/ @Until, власні адаптери через TypeAdapter і registerTypeAdapter, а потім порівняємо з Jackson і розглянемо типові помилки.

Коли структура JSON заздалегідь невідома або часто змінюється, зручніше працювати не з жорсткими Java‑класами, а з універсальними контейнерами: Map, List і деревами JSON. У лекції розглянемо, як за допомогою ObjectMapper прочитати дані у Map<String, Object> і List, як безпечно обходити дерево через JsonNode та його методи get/ path/ asText(), а також альтернативу на основі Gson з JsonElement, JsonObject, JsonArray. Завершимо практикою добування конфігурації та розглядом типових помилок.

Навіщо й як перевіряти вхідні дані у форматі JSON перед десеріалізацією: розбираємо контракт на дані через JSON Schema (ключі type, properties, required, format), валідуємо в Java бібліотекою everit-org/json-schema (завантаження схеми в Schema, виклик validate), коректно обробляємо ValidationException і формуємо зрозумілі повідомлення про помилки для користувачів та API.