JSON转Java实体类

JSON 样本会怎样变成 Java 类型

把一段接口响应样本转换后，JSON 对象会成为根类，成员名会成为字段，嵌套对象会得到独立的 Java 类，数组则根据样本元素推断组件类型。

默认 Java 输出包含什么

初始类型名称为 Root，初始包名为 io.quicktype。“仅类型定义”默认开启，通常生成私有字段及 getter、setter；关闭后会增加 JSON 转换辅助代码、Jackson 注解和依赖提示。开启“使用 Lombok”后，类上会出现 @lombok.Data，显式 getter、setter 会被省略。结果可复制，也可按当前类型名称下载 .java 文件。

例如输入订单对象，其中 items 是商品对象数组，默认结果会形成 Order 与 Item 两个 public 类，字段类型为 Item[]。结果区用 // Order.java、// Item.java 一类注释分隔文件内容。

不同样本结构会怎样输出

• 空数组：[] 没有元素可供判断，通常生成 Object[]。
• 可选字段：根数组中的某个对象缺少字段时，boolean、long 等基本类型可能变成 Boolean、Long。
• 混合数组：RFC 8259 允许数组包含不同类型；Java 数组需要明确组件类型，混合值可能生成额外的联合包装类。
• 名称冲突：带连字符的键、缩写以及 class 之类的保留名称会被改写，生成后要核对字段名与序列化名称。
• 纯标量根值：只输入 42、true 或单个字符串不能形成有字段的实体类，结果可能为空。

规范与依赖资料

从粘贴样本到整理代码

1. 准备有代表性的 JSON

   保留正常值、null、空数组、可选字段和至少两个数组元素。样本越接近真实响应，类型推断越有参考价值；先移除令牌、手机号等不应外泄的数据。

2. 填写 JSON 输入

   粘贴完整对象或对象数组。若出现语法错误，先用“格式化”定位缺少引号、逗号或括号的问题，也可以载入页面示例观察可接受结构。

3. 设置类型名称与包名

   把 Root 改为业务含义明确的 PascalCase 名称，例如 OrderResponse；再把默认包名换成项目实际包路径，例如 com.example.api.dto。

4. 决定输出范围

   只想得到字段和访问方法时保留“仅类型定义”。项目已经配置 Lombok 时可开启“使用 Lombok”；需要生成 Jackson 转换辅助代码时再关闭“仅类型定义”。

5. 复制、拆分并编译

   复制结果或下载文件，按 // Xxx.java 注释把多个 public 类分别保存，再补充项目需要的校验注解、文档、构造方式和序列化配置。最后用项目实际 JDK 与依赖执行编译和反序列化测试。

嵌套订单样本的可复现结果

把根类型改成 Order，输入 {"id":1001,"paid":true,"total":19.95,"items":[{"sku":"A-1","quantity":2}]}。默认“仅类型定义”模式会把 id 推断为 long、paid 推断为 boolean、total 推断为 double，并生成 Item[] items 及独立的 Item 类；其中 quantity 同样是 long。

再把第二个数组元素改成 {"sku":"B-2","quantity":1,"note":null}，结果会加入 note，但 null 样本只能推断成 Object。如果业务契约规定它是可空文本，应手工改成 String，并用包含真实字符串的样本重新测试。

转换结果常见疑问

合入项目之前必须复核

生成代码只反映所粘贴的样本，不能证明接口的完整字段集合、必填规则、数值范围、日期格式或向后兼容性。生产项目应以 OpenAPI、JSON Schema、接口文档和实际测试为准。

• JSON 数字没有 Java 的 long、double 或 BigDecimal 语义；订单金额、计量值和超大整数必须按业务精度重选类型。
• 日期时间与 UUID 都是字符串形态的推断结果。若上游格式不稳定，专用类型可能导致反序列化失败，应加入异常样本测试。
• 关闭“仅类型定义”得到的完整转换代码含 Jackson 相关导入和依赖提示；版本及依赖管理应与现有工程保持一致，不要机械照搬示例版本。
• 转换过程不需要把 JSON 内容交给外部数据源，但页面仍可能存在常规访问统计。不要粘贴生产密钥、访问令牌、身份证件或未经脱敏的用户数据。
• 复制后至少完成一次编译、一次代表性反序列化和一次边界样本测试，再把生成类纳入业务代码。