JSON转Kotlin
根据 JSON 数据自动生成 Kotlin 语言的数据类(data class)代码,完美处理嵌套结构和可空性。
JSON 转 Kotlin
JSON 转 Kotlin 工具使用指南
📌 简介
JSON 转 Kotlin 工具是一款专为 Android 开发者和后端 Kotlin 开发者打造的在线代码生成神器。在现代 RESTful API 开发中,服务器返回的数据几乎都是 JSON 格式。在 Kotlin 中,我们通常使用 `data class` 来映射这些 JSON 数据。手动敲击这些字段不仅耗时,还极易拼错。本工具可以通过直接解析 JSON 字符串,一键生成带空安全(Null Safety)特性的 Kotlin 数据类代码。
📖 JSON 与 Kotlin Data Class 的映射
Kotlin 是一门强调空安全的语言。在将 JSON 转换为 Kotlin 类时,必须考虑字段是否可能为 `null`。例如,JSON 中的 `"age": 25` 映射为 `val age: Int`,但如果某些情况下 API 可能返回 `"age": null`,则必须定义为 `val age: Int?`。本工具默认开启了全部字段可空(`?`),这是最安全的做法,能极大降低 Android 应用中因 NullPointerException 导致崩溃的概率。同时,它能自动识别嵌套的 JSON 对象并生成独立的子类,处理数组时也会自动包裹为 `List
💼 常见应用场景
- Android 开发: 快速对接后端的 JSON 接口,配合 Gson 或 Moshi 使用。
- Ktor 后端: 为 Ktor 接收的请求体定义数据模型。
- 学习 Kotlin: 直观对比 Java 和 Kotlin 在数据类定义上的差异。
⚙️ 使用步骤
- 粘贴 JSON 数据到左侧输入框。
- 输入根类的名称(如 `UserResponse`)。
- 根据需要选择是否所有字段都可空。
- 右侧会实时生成代码,点击复制即可粘贴到 IDE 中。
⚠️ 注意事项
- 如果 JSON 字段名包含特殊字符或不符合 Kotlin 命名规范,生成的代码可能需要手动微调。
- 生成的代码没有包含 `@SerializedName` 注解,如果您需要使用与 JSON 不同的变量名,请手动添加。
❓ 常见问题 (FAQ)
Q: 为什么 `id` 被识别成了 `Int` 而不是 `Long`?
A: 脚本根据 JSON 中的数值大小推断。如果您的 ID 很大(超过 Int 范围),建议手动将生成的 `Int` 修改为 `Long`。