知识中心

JSON 转 Java 实体类工具使用教程

ToolYou 2026年8月8日 5 阅读
JSON转JavaJava实体类Lombok代码生成POJOBeanAPI开发

什么是 JSON 转 Java 实体类？

JSON 转 Java 实体类是将 JSON 数据结构自动转换为 Java 类定义的过程。在开发 RESTful API 应用时，通常需要将 API 返回的 JSON 数据映射为 Java 对象（POJO/Bean），以便进行数据序列化和反序列化。手动编写这些类非常耗时且容易出错，特别是对于复杂的嵌套 JSON 结构。本工具可以自动分析 JSON 结构，生成包含正确数据类型、getter/setter 方法和嵌套类的完整 Java 代码，大幅提升开发效率。

ToolYou 提供的 JSON 转 Java 工具支持自定义类名和包名、Lombok @Data 注解、自动识别嵌套对象和数组类型，生成的代码可直接用于 Spring Boot、MyBatis 等主流 Java 项目。

JSON 到 Java 类型映射规则

📌 基本类型映射

工具根据 JSON 值的类型自动推断对应的 Java 数据类型：

  • "string" → String

  • 123 → Integer 或 Double（根据是否有小数点）

  • true/false → Boolean

  • null → Object

📌 复合类型映射

对于数组和对象等复合类型，工具会自动生成对应的 Java 集合或嵌套类：

  • [] → List<T>（泛型列表）

  • {} → 嵌套内部类（自动生成新的 Java 类）

  • "2024-01-01" → Date（匹配 yyyy-MM-dd 格式）

📌 字段命名规则

工具会自动处理 JSON 字段名，将非字母数字字符（如连字符、空格）替换为下划线，确保生成的 Java 字段名符合命名规范。例如，user-name 会转换为 userName（驼峰命名）。

ToolYou JSON 转 Java 工具核心功能

⚡ 一键自动生成 Java 代码

在左侧输入 JSON 数据，工具会自动分析结构并在右侧实时生成对应的 Java 实体类代码。支持一键复制和下载为 .java 文件，方便直接集成到项目中。

📝 自定义类名和包名

支持自定义生成的 Java 类名（默认 RootObject）和包名（默认 cn.toolyou.pojo），便于代码组织和模块化管理，使生成的代码更符合项目规范。

🎯 Lombok @Data 注解支持

勾选「使用 Lombok」选项后，工具会自动添加 @Data 注解，自动生成 getter、setter、toString、equals 和 hashCode 方法。使用 Lombok 后，代码更加简洁，只需声明字段即可，但需要在项目中添加 Lombok 依赖并在 IDE 中安装 Lombok 插件。

🔗 嵌套对象自动解析

对于包含嵌套对象的 JSON 数据，工具会自动生成多个 Java 类，每个内部类对应一个嵌套对象。生成的代码保持正确的类层次结构，可直接使用。

📋 内置示例数据

工具提供内置示例数据，点击「示例」按钮即可加载预设的 JSON 数据，快速体验完整的转换流程，了解工具的输出效果。

🌙 深色 / 浅色主题适配

工具支持深色和浅色两种视觉主题，用户可根据当前系统设置或个人偏好自由切换，减轻长时间使用时的视觉疲劳。

如何使用 JSON 转 Java 工具？

场景一：基本 JSON 转 Java 类

  1. 访问页面：打开 /json2java 工具页面

  2. 输入 JSON：在左侧编辑区输入或粘贴 JSON 数据

  3. 配置参数：设置类名（如 User）和包名（如 com.example.pojo）

  4. 勾选 Lombok：如需使用 Lombok 注解，勾选「使用 Lombok」选项

  5. 查看结果：右侧自动生成对应的 Java 实体类代码

场景二：嵌套对象转换

  1. 输入嵌套 JSON：粘贴包含嵌套对象的 JSON 数据

  2. 自动生成：工具自动识别嵌套结构，生成多个 Java 类

  3. 检查代码：确认嵌套类的引用关系是否正确

场景三：使用内置示例

  1. 点击示例：点击工具栏的「示例」按钮加载预设数据

  2. 查看转换：观察 JSON 数据自动转换为 Java 代码的过程

  3. 学习用法：通过示例了解工具支持的各类场景

JSON 转 Java 常见应用场景

  • RESTful API 开发：将 API 响应 JSON 快速转换为 Java 实体类

  • 数据模型设计：根据 JSON 数据结构定义 Java Bean，用于数据持久化

  • 接口对接：第三方 API 返回 JSON 数据时，快速生成对应的 Java 处理类

  • 配置文件解析：将 JSON 配置文件映射为 Java 对象，便于程序读取

  • 代码生成：在自动化构建流程中，从 API 文档自动生成 Java 代码

常见问题

Q: 如何自定义生成的 Java 类名和包名？

A: 在配置区域可以输入自定义的类名（默认 RootObject）和包名（默认 cn.toolyou.pojo），工具会根据配置生成对应的 Java 代码。

Q: Lombok @Data 注解有什么用？

A: Lombok 是一个 Java 代码生成工具，@Data 注解会自动为类生成 getter、setter、toString、equals 和 hashCode 方法。启用 Lombok 后，生成的 Java 类代码更加简洁，只需声明字段即可。但需要在项目中添加 Lombok 依赖（org.projectlombok:lombok），并在 IDE 中安装 Lombok 插件。

Q: 支持的 Java 数据类型有哪些？

A: 工具自动识别以下类型：String（字符串）、Integer（整数）、Double（浮点数）、Boolean（布尔值）、Date（日期字符串，匹配 yyyy-MM-dd 格式）、List<T>（数组）、Object（null 值）、以及嵌套类（JSON 对象）。嵌套对象会自动生成对应的 Java 类文件。

Q: 为什么我的 JSON 数据转换后字段名有下划线？

A: 工具会自动将 JSON 字段名中的非字母数字字符（如连字符、空格等）替换为下划线，以确保生成的 Java 字段名符合命名规范。例如，"user-name" 会变成 "user_name"。这是为了保证生成的代码可以正常编译运行。如需更精确的字段映射，可以手动修改生成的代码。

💡 提示：ToolYou 还提供 JSON 格式化、JSONPath 查询等相关工具，欢迎访问！

返回知识中心