JSON 转实体类教程

在线 JSON 转实体类工具怎么用?把 JSON 数据自动生成 Java、C#、TS 等语言实体类,省去手写映射。

一段 JSON 和它的 Java 类

接口返回 {"id":1,"name":"Yeo","score":9.5},手写实体类要声明三个字段、六个方法。转换工具生成的结构是确定的:3 个字段对应 3 个属性(id、name、score),getter/setter 数量恒为字段数的两倍(6 个)——这个比例是验收生成代码的第一道校验,缺了就是生成器漏码。

生成代码长什么样

以 Java 为例,类型映射有章可循:整数 1 映射 long(或 Integer)、小数 9.5 映射 double、文本"Yeo"映射 String。生成的类骨架包含私有字段、无参构造、六个访问器。C# 把 getter/setter 换成属性语法(public int Id { get; set; }),TypeScript 用接口(interface Xxx { id: number; ... })——骨架不同,但字段与属性的一一对应关系不变。

三类推断不出来的字段

  • null 值字段:类型无从判断,工具默认 Object/any,需要人工改具体类型
  • 空数组 []:元素类型未知,泛型(List<Xxx>)要手写
  • 时间字符串:"2026-10-15" 只是字符串,Date 映射要加反序列化注解

常见问题

字段名是关键字怎么办?
class、new、public 等关键字做字段名会编译失败,生成器通常加 @ 或 _ 前缀转义。
下划线命名要转驼峰吗?
按团队规范选,Java 惯例驼峰、Go 惯例保留原样,工具一般提供开关。
嵌套对象怎么处理?
递归生成子类,外层字段类型引用内层类名,层次结构与 JSON 一致。

生成代码能不能用,先数方法——六对三,账对了再看类型。

去使用 JSON 转实体类工具