Cole uma resposta de API ou um JSON de configuração e receba código Kotlin com data class que espelha a estrutura dele. Objetos aninhados e arrays de objetos viram cada um a sua própria classe, e você pode gerar para kotlinx.serialization ou para Jackson.
Foi feito para o momento em que você integra uma API externa num app Android ou num serviço Ktor/Spring e quer o esqueleto do model a partir de uma única resposta de exemplo, em vez de digitar tudo. A conversão roda inteira no navegador, então colar uma resposta de API interna não a envia para lugar nenhum.
Nome do tipo o nome da classe de nível mais alto (padrão Root), por exemplo UserResponse.Serializador, de acordo com o que o seu projeto já usa.{
"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
)
Os objetos dentro do array items viram uma classe Item no singular, e gift_wrap, que só aparece no segundo item, vira Boolean? = null. coupon só aparece como null, então o tipo não pode ser inferido e fica como JsonElement? para você trocar pelo tipo real.
@Serializable em todas as classes, @SerialName nos campos cujo nome mudou, mais os imports necessários.@JsonProperty só nos campos cujo nome mudou.user_name ou home-url viram propriedades em camelCase (userName, homeUrl) mapeadas de volta para a chave original por anotação.class ou val são envolvidas em backticks; chaves que começam com dígito ganham o prefixo n.Int, valores acima de 32 bits viram Long, e qualquer decimal transforma o campo em Double.? = null.typealias, por exemplo typealias Root = List<RootItem>.Cole uma resposta copiada do Postman ou do DevTools do navegador e você recebe classes prontas para Call<Order> ou client.get<Order>(). Com respostas de dezenas de campos, isso evita erros de digitação e tipos errados de quem copia à mão.
Quando o backend manda created_at, o lado Kotlin lê createdAt enquanto o serial name guarda a chave original. O mapeamento fica visível em cada classe, em vez de depender de uma naming strategy global.
Se você está passando models do Gson ou do Jackson para kotlinx.serialization, gere as duas saídas a partir do mesmo JSON para ver exatamente quais anotações mudam.
? você mesmo nos campos que a documentação da API diz que podem ser omitidos.2024-01-01T00:00:00Z continuam String; trocar para Instant exige um serializer próprio.Any, então valores sem tipo inferível viram JsonElement nele e Any com Jackson.String? = null e não só String??O kotlinx.serialization lança MissingFieldException quando uma chave falta e a propriedade não tem default. Adicionar = null aos campos que faltam em alguns itens ou contêm null faz respostas sem essa chave serem decodificadas sem erro.
@SerialName?A ferramenta sempre converte para camelCase e só adiciona anotação quando o nome muda, então chaves que já estão em camelCase saem sem anotação. Para manter nomes snake_case, renomeie as propriedades e tire as anotações depois de gerar.
Sim. A data class gerada não tem construtor sem argumentos, então o Jackson precisa do jackson-module-kotlin registrado para fazer bind dos valores pelos parâmetros do construtor (o Spring Boot registra automaticamente quando a dependência está presente).
As opções de serializador são kotlinx.serialization e Jackson. Para Gson, pegue a saída do Jackson e troque @JsonProperty por @SerializedName; para Moshi, use @Json(name = ...). A estrutura das classes continua a mesma.