JSON 转 Java 工具
将嵌套 JSON 样本生成为 Java 类、列表及 Jackson 转换代码,通过序列化注解映射原始字段名。
如何生成 Java 模型
粘贴有代表性的 JSON 对象或数组,填写根类型名称后生成。使用文件选择框查看各个源码文件;复制仅复制当前文件,ZIP 下载保留全部文件。完整输出通过映射保留 JSON 原始字段名,包括语言关键字和含标点的键名。
完整输出使用 Java 8 及以上的 Jackson 2.x Databind 和注解,需在项目中添加依赖。每个 public 类须保存为所示文件名,并保留 io.quicktype 包结构。仅模型模式生成字段和访问方法,省略 Jackson 映射及转换器。
样本、可选字段与限制
同类接口存在多种返回结构时,可选择 JSON Lines,每行放一个完整 JSON 文档。部分样本缺少的字段推断为可选字段,显式 null 参与可空类型推断。空数组和始终为 null 的字段无法确定具体类型,应补充代表性样本并核对输出。
数字样式字符串、日期和 UUID 字符串仍按字符串处理。工具根据样本推断模型,不能代替完整接口约定。上限为 200,000 字符、64 层嵌套、50 个样本文档、50 个生成文件及 1,000,000 输出字符。转换在本地 Worker 中运行,可取消,超时为 10 秒。
常见问题
缺失字段和 null 一样吗?
不同。缺失字段表示该字段不一定存在,null 则是一个具体值。目标语言可能通过同一个可选或可空类型表示两者。建议提供多个样本,仅在符合实际接口时启用“所有字段可选”。
会读取远程 Schema 或上传 JSON 吗?
不会。工具仅使用输入的 JSON 样本,不读取其中的网址或远程 Schema,也不会在页面中执行生成的程序。