JSON у Kotlin
Перетворіть зразок JSON на класи даних Kotlin з анотаціями для kotlinx.serialization. Назви властивостей перетворюються на camelCase, а для інших ключів додається @SerialName; вкладені об’єкти отримують власні класи, необов’язкові поля мають значення null за замовчуванням, а значення змішаних типів стають JsonElement. Вставте відповідь API і декодуйте її за допомогою Json.decodeFromString.
Поширені запитання
Як називаються вкладені об’єкти?
Кожен вкладений об’єкт стає окремим типом Kotlin, названим за ключем, у якому він міститься, у PascalCase, наприклад address стає Address. Об’єкти в масивах отримують однину від ключа масиву, наприклад users стає User. Об’єкти з абсолютно однаковими полями спільно використовують один тип.
Коли поле є необов’язковим?
Якщо масив містить кілька об’єктів і в деяких із них немає певного ключа, це поле є необов’язковим: його тип стає nullable, а значенням за замовчуванням — null. Ключ, наявний у кожному зразку, є обов’язковим. Для одного об’єкта немає з чим порівнювати, тому всі його ключі обов’язкові.
Як обробляються значення null?
Ключ, який у деяких зразках має значення null, а в інших — певне значення, стає nullable-типом, наприклад String?. Якщо ключ завжди має значення null, інструмент не може визначити його справжній тип, тому він стає JsonElement?; вставте зразок із реальним значенням, щоб отримати точний тип.
Які числові типи використовуються?
Цілі числа стають Long, а дробові — Double. Поле, що містить числа обох типів, стає Double.
Що відбувається з ключами, які не є допустимими іменами?
Назви властивостей перетворюються на camelCase і отримують @SerialName із початковим ключем, якщо назви відрізняються. Назви, які є зарезервованими словами Kotlin, як-от object, записуються у зворотних лапках.
Чи завантажується або зберігається мій JSON?
JSON надсилається на сервер лише для генерації коду для цього запиту й не зберігається. Генератор читає лише структуру та типи значень у вашому зразку, тож перед вставленням ви можете замінити конфіденційні значення на заповнювачі того самого типу.