Перейти до вмісту

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 надсилається на сервер лише для генерації коду для цього запиту й не зберігається. Генератор читає лише структуру та типи значень у вашому зразку, тож перед вставленням ви можете замінити конфіденційні значення на заповнювачі того самого типу.

Про OneClick Pro

OneClick Pro — це безкоштовна колекція з понад 150 вебінструментів для повсякденної роботи: конвертації зображень і одиниць, форматування та перевірки коду, перевірки доменів і SEO, а також роботи з текстом, датами й числами. Кожен інструмент працює без реєстрації чи передплати, а введені вами дані використовуються лише для обчислення результату й ніколи не зберігаються. Використовуйте цю добірку як швидкий набір інструментів для разових завдань або додайте в закладки інструменти, якими користуєтеся щодня.