Pega la respuesta de una API o un JSON de configuración y obtén código Kotlin data class que refleja su estructura. Los objetos anidados y los arrays de objetos se convierten cada uno en su propia clase, y puedes elegir como destino kotlinx.serialization o Jackson.
Está pensado para el momento en que conectas una API externa en una app Android o en un servicio Ktor/Spring y quieres el esqueleto del modelo a partir de una respuesta de ejemplo en lugar de teclearlo. La conversión se ejecuta por completo en tu navegador, así que pegar la respuesta de una API interna no la envía a ningún sitio.
Nombre del tipo el nombre de la clase de nivel superior (por defecto Root), por ejemplo UserResponse.Serializador, según lo que ya use tu proyecto.{
"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
)
Los objetos dentro del array items se convierten en una clase Item en singular, y gift_wrap, que solo aparece en el segundo elemento, pasa a Boolean? = null. coupon siempre vale null, así que su tipo no se puede inferir y se deja como JsonElement? para que lo sustituyas por el tipo real.
@Serializable en cada clase, @SerialName en los campos cuyo nombre cambió, más los imports necesarios.@JsonProperty solo en los campos cuyo nombre cambió.user_name o home-url pasan a propiedades camelCase (userName, homeUrl) mapeadas a la clave original mediante una anotación.class o val se envuelven entre backticks; las claves que empiezan por un dígito reciben el prefijo n.Int, los valores de más de 32 bits a Long, y cualquier decimal convierte el campo en Double.? = null.typealias, p. ej. typealias Root = List<RootItem>.Pega una respuesta copiada de Postman o de las DevTools del navegador y obtienes clases listas para Call<Order> o client.get<Order>(). Con respuestas de decenas de campos, evitas erratas y tipos equivocados al copiar a mano.
Cuando el backend envía created_at, el lado Kotlin lee createdAt mientras el serial name conserva la clave original. El mapeo queda visible en cada clase en lugar de depender de una estrategia de nombres global.
Si estás pasando modelos de Gson o Jackson a kotlinx.serialization, genera ambas salidas a partir del mismo JSON para ver exactamente qué anotaciones cambian.
? a los campos que la documentación de la API dice que pueden omitirse.2024-01-01T00:00:00Z se quedan como String; pasar a Instant requiere tu propio serializer.Any, así que los valores sin tipo inferible pasan a JsonElement allí y a Any con Jackson.String? = null y no solo String??kotlinx.serialization lanza MissingFieldException cuando falta una clave y la propiedad no tiene valor por defecto. Añadir = null a los campos que faltan en algunos elementos o contienen null permite decodificar sin problemas las respuestas que no traen esa clave.
@SerialName?La herramienta siempre convierte a camelCase y añade una anotación solo cuando el nombre difiere, así que las claves que ya están en camelCase salen sin anotaciones. Para mantener nombres snake_case, renombra las propiedades y quita las anotaciones después de generar.
Sí. La data class generada no tiene constructor sin argumentos, así que Jackson necesita tener registrado jackson-module-kotlin para vincular los valores a través de los parámetros del constructor (Spring Boot lo registra automáticamente cuando la dependencia está presente).
Las opciones de serializador son kotlinx.serialization y Jackson. Para Gson, toma la salida de Jackson y sustituye @JsonProperty por @SerializedName; para Moshi, usa @Json(name = ...). La estructura de clases es la misma.