JSON 转 Kotlin 生成器

JSON 输入

正在加载编辑器…

生成的 Kotlin

Configuration

输入 JSON 数据以生成 Kotlin 数据类

支持数据类、kotlinx.serialization 与空安全

如何将 JSON 转换为 Kotlin – 分步指南

使用此 JSON 转 Kotlin 生成器,可从 JSON 示例生成 Kotlin data class,适用于 Android 与 JVM 后端项目。

  1. 步骤 1 – 粘贴 JSON 示例

    • 将具有代表性的 JSON 对象或数组粘贴到左侧编辑器中。
    • 尽量包含嵌套对象、数组和可为 null 的字段,方便正确推断类型。
    • 使用 导入 从文件、URL 或示例数据加载 JSON。
  2. 步骤 2 – 选择 Kotlin data class 选项

    • 为生成的 data class 设置根 类名
    • 决定可空字段如何表示(String?Double? 等)。
    • 如使用序列化库,请与技术栈保持一致(Moshi/Kotlinx/Jackson)。
  3. 步骤 3 – 检查生成的代码

    • 确认字段命名、类型推断,以及数组/对象的映射方式是否符合预期。
    • 根据需要调整 根类型名称、空值处理策略以及可选的框架选项。
    • 如果某些字段推断不准确,优化示例 JSON 后重新生成。
  4. 步骤 4 – 在 Kotlin 中使用 data class

    • 将 data class 放入项目包路径中。
    • 使用所选库将 JSON 反序列化为根类型实例。
    • 当 API 频繁变化时,建议对模型进行版本管理。
  5. 步骤 5 – 复制或下载

    • 将输出复制到项目中,或下载为文件。
    • 运行格式化/代码检查工具,让代码风格与项目保持一致。
    • 若目标语言需要序列化/解析库,请在项目中添加相应依赖。

快速提示

  • 优先使用不可变 val 属性,使模型更安全。
  • 字段名不一致时,使用 @Json/@SerialName 等注解显式映射。
  • 需要跨团队共享契约时,建议生成 JSON Schema。
示例输出(简化)
// JSON 输入
{
  "id": 123,
  "name": "Maeve Winters",
  "email": "[email protected]",
  "active": true,
  "roles": ["admin", "editor"],
  "metadata": { "plan": "pro" },
  "createdAt": "2024-03-01T10:15:00Z",
  "score": 99.5,
  "notes": null
}

// 生成的 Kotlin data class(简化)
data class Metadata(
  val plan: String
)

data class Root(
  val id: Int,
  val name: String,
  val email: String?,
  val active: Boolean,
  val roles: List<String>,
  val metadata: Metadata,
  val createdAt: String,
  val score: Double,
  val notes: Any?
)

相关 JSON 与 Kotlin 工具

探索更多可与本 JSON 转 Kotlin 生成器配合使用的 JSON 与 Schema 工具。

常见问题

支持哪些 Kotlin 特性?

生成器创建支持 kotlinx.serialization、Gson 和 Jackson 注解进行 JSON 序列化的 Kotlin 数据类,以及现代 Kotlin 语言特性如空值安全和数据类。

可以生成与 kotlinx.serialization 兼容的类吗?

可以!选择 'kotlinx' 作为框架可以生成带有 @Serializable 和 @SerialName 注解的类,以支持类型安全的 JSON 序列化。

Gson 和 Jackson 集成如何工作?

当选择 Gson 或 Jackson 框架时,生成器会向字段添加适当的注解(@SerializedName 或 @JsonProperty)以进行正确的 JSON 序列化/反序列化。

包结构如何处理?

您可以在选项中指定自定义包名。生成器将在生成的 Kotlin 文件顶部添加适当的包声明。

JSON 转 Kotlin 生成器 | JSONSwiss