Вставьте ответ API или JSON конфигурации и получите код data class на Kotlin, повторяющий его структуру. Вложенные объекты и массивы объектов становятся отдельными классами, а целевой библиотекой можно выбрать kotlinx.serialization или Jackson.
Сделан для момента, когда вы подключаете внешний API в Android-приложении или сервисе на Ktor/Spring и хотите получить каркас модели по одному примеру ответа, а не набирать его вручную. Преобразование целиком выполняется в браузере, так что вставленный ответ внутреннего API никуда не отправляется.
Имя типа имя класса верхнего уровня (по умолчанию Root), например UserResponse.Сериализатор выберите kotlinx.serialization или Jackson — то, что уже используется в проекте.{
"orderId": "A-1024",
"paid": true,
"total": 39.9,
"coupon": null,
"items": [
{ "sku": "TSHIRT-M", "qty": 2 },
{ "sku": "CAP", "qty": 1, "gift_wrap": true }
]
}import kotlinx.serialization.Serializable
import kotlinx.serialization.SerialName
import kotlinx.serialization.json.JsonElement
@Serializable
data class Order(
val orderId: String,
val paid: Boolean,
val total: Double,
val coupon: JsonElement? = null,
val items: List<Item>
)
@Serializable
data class Item(
val sku: String,
val qty: Int,
@SerialName("gift_wrap") val giftWrap: Boolean? = null
)
Объекты внутри массива items становятся классом Item в единственном числе, а gift_wrap, который встречается только во втором элементе, становится Boolean? = null. coupon всегда равен null, так что его тип вывести нельзя, и он остаётся JsonElement? — замените его реальным типом.
@Serializable на каждом классе, @SerialName на полях, имя которых изменилось, плюс нужные импорты.@JsonProperty только на полях, имя которых изменилось.user_name или home-url становятся свойствами в camelCase (userName, homeUrl), связанными с исходным ключом через аннотацию.class или val оборачиваются в обратные кавычки; ключи, начинающиеся с цифры, получают префикс n.Int, значения больше 32 бит — Long, а любое дробное делает поле Double.? = null.typealias, например typealias Root = List<RootItem>.Вставьте ответ, скопированный из Postman или DevTools браузера, и получите классы, готовые для Call<Order> или client.get<Order>(). При ответах с десятками полей это избавляет от опечаток и неверных типов при ручном переносе.
Когда бэкенд присылает created_at, на стороне Kotlin читается createdAt, а serial name хранит исходный ключ. Сопоставление видно в каждом классе, а не зависит от глобальной стратегии именования.
Если вы переводите модели Gson или Jackson на kotlinx.serialization, сгенерируйте оба варианта из одного JSON, чтобы точно увидеть, какие аннотации меняются.
? сами.2024-01-01T00:00:00Z остаются String; переход на Instant требует собственного сериализатора.Any, поэтому значения без выводимого типа становятся там JsonElement, а с Jackson — Any.String? = null, а не просто String??kotlinx.serialization выбрасывает MissingFieldException, когда ключа нет, а у свойства нет значения по умолчанию. Добавление = null к полям, которые отсутствуют в части элементов или содержат null, позволяет ответам без этого ключа нормально декодироваться.
@SerialName?Инструмент всегда переводит в camelCase и добавляет аннотацию только при отличии имени, так что ключи, уже записанные в camelCase, выходят без аннотаций. Чтобы сохранить имена в snake_case, после генерации переименуйте свойства и уберите аннотации.
Да. У сгенерированного data class нет конструктора без аргументов, поэтому Jackson нужен зарегистрированный jackson-module-kotlin, чтобы связывать значения через параметры конструктора (Spring Boot регистрирует его автоматически, если зависимость есть).
Варианты сериализатора — kotlinx.serialization и Jackson. Для Gson возьмите вывод Jackson и замените @JsonProperty на @SerializedName; для Moshi — на @Json(name = ...). Структура классов остаётся той же.