JSON 转 Kotlin
将 JSON 示例转换为使用 kotlinx.serialization 注解的 Kotlin data class。属性名会转换为 camelCase;键名不同时会添加 @SerialName。嵌套对象会生成自己的类,可选字段默认值为 null,混合类型的值会变为 JsonElement。粘贴 API 响应,即可使用 Json.decodeFromString 解码。
常见问题
嵌套对象如何命名?
每个嵌套对象都会成为独立的 Kotlin 类型,并以包含它的键名转换为 PascalCase 后命名,例如 address 会变为 Address。数组中的对象会使用数组键名的单数形式,例如 users 会变为 User。字段完全相同的对象会共用同一个类型。
字段在什么情况下会是可选的?
当数组中包含多个对象,且某个键在部分对象中缺失时,该字段就是可选的:其类型会变为可空类型,默认值为 null。每个示例中都存在的键为必填项。单个对象没有可供比较的对象,因此其中所有键都是必填项。
如何处理 null 值?
如果某个键在部分示例中为 null,在其他示例中有值,它会变为可空类型,例如 String?。如果某个键始终为 null,工具就无法得知它的实际类型,因此会将其变为 JsonElement?;粘贴包含实际值的示例即可生成精确类型。
会使用哪些数字类型?
整数会变为 Long,带小数的数字会变为 Double。同时包含两者的字段会变为 Double。
如何处理无效名称的键?
属性名会转换为 camelCase;与原始键名不同时,会添加 @SerialName。如果名称是 Kotlin 关键字,例如 object,则会用反引号括起来。
我的 JSON 会被上传或存储吗?
JSON 仅会发送到服务器以便为此次请求生成代码,不会被存储。生成器只会读取示例的结构和值类型,因此你可以在粘贴前将敏感值替换为类型相同的占位值。