Лекції

Розбираємося, що таке серіалізація й десеріалізація в Kotlin/JVM: навіщо обʼєктам на кшталт List<Expense> потрібна переносима форма (рядок або байти), чому не можна вважати toString() «форматом зберігання», чим небезпечне ручне складання JSON без екранування й чому будь-яка схема збереження — це контракт даних (поля, типи, сумісність версій). Наприкінці — мініначерк структури файлу й типові помилки під час проєктування збереження.

Розглянемо «абетку» JSON: обʼєкт {...}, масив [...], примітиви та null — і зіставимо їх із Kotlin‑типами: data class, Map, List, String, Int/ Long/ Double, nullable‑типи T?. Ви навчитеся «читати JSON очима», розуміти вкладеність і заздалегідь помічати типові помилки (лапки в ключах, зайві коми, плутанина рядків і чисел, null vs "null").

Розбираємося, навіщо потрібна серіалізація в Kotlin-проєктах, як працює kotlinx.serialization (компіляторний плагін + runtime), як правильно під’єднати kotlin("plugin.serialization") і залежність для JSON-модуля, а також як застосовувати анотацію @Serializable до моделей ( Expense, AppState). Наприкінці — швидка перевірка через serializer() і розбір типових помилок.

Розберемо «чесний» ланцюжок збереження даних для консольного Kotlin‑проєкту: як серіалізувати об’єкт і список у JSON через Json.encodeToString, записати JSON‑рядок у файл ( writeText), потім прочитати його ( readText) і відновити дані через Json.decodeFromString. Окремо поговоримо про діагностику помилок (I/O vs парсинг JSON) і типові пастки на кшталт toString(), відсутнього каталогу та плутанини між {} і [].

Розбираємо налаштування kotlinx.serialization.json.Json як частину «контракту» зберігання даних: чим корисний prettyPrint для читабельності та дифів, як encodeDefaults впливає на «самодостатність» файлу, чому explicitNulls змінює зміст «поля немає» vs «поле = null», і як досягти сумісності через ignoreUnknownKeys та акуратний імпорт із isLenient. Наприкінці — практичний шаблон єдиного appJson для всього застосунку й розбір типових помилок.