JSON 转 Java

相关推荐

关于 JSON 转 Java POJO 与 Java 实体类

适用场景

• Android 开发：把后端 API 返回的 JSON 转为 Java 实体类（POJO），可选 Gson / Moshi / Fastjson / Jackson 注解直接用于反序列化
• Spring Boot 后端：把 API 接口文档中的示例 JSON 快速转为 DTO / VO / Entity 类，配合 Lombok @Data 精简代码量
• 对接第三方接口：把对方接口的响应 JSON 转为对应 Java 模型，选择对应的序列化注解（Jackson / Fastjson / Gson）无缝对接
• 微服务架构：统一 RPC 接口的请求 / 响应数据模型，多个团队共享同一份 Java 类定义
• 教学与培训：数据结构课程、Java 教学场景中把示例 JSON 转 POJO 演示面向对象建模
• API 文档编写：在 Swagger / OpenAPI / Knife4j 文档中嵌入 Java 实体类示例
• 单元测试准备：把 JSON fixture 转成 Java 类后用 Jackson 反序列化做测试数据驱动
• 数据迁移脚本：把 JSON 配置文件转为 Java 类后用于业务逻辑强类型访问
• 前端 Mock 对接：后端先把 JSON 模型转 Java，前端同时拿到对应的 TypeScript interface / Java POJO
• 代码评审：把 API 返回 JSON 直接转成可读的 POJO，便于 Code Review 时讨论字段命名
• 老项目重构：把基于 JSONObject 动态访问的代码重构为基于 POJO 的强类型访问
• Entity / DTO 多角色建模：同一份 JSON 生成 UserEntity（DB 层）+ UserDTO（API 层）+ UserVO（视图层），可分别选择不同注解
• snake_case 后端 API 接入：后端 API 返回 snake_case 字段，前端 Java 系统启用「转 camelCase」+ Gson/Jackson 注解无缝接入
• 需要持久化的 DTO：勾选「实现 Serializable」直接可用于 Redis 缓存或分布式 Session 存储

使用方法

1. 在左侧编辑器粘贴 JSON 对象（推荐）或数组，或点击「Sample」加载中文示例（含嵌套 address / company / tags）
2. 点击工具栏「Settings」按钮（或带类名的按钮），在弹窗中选择：① 设置根类名（如 User）和包名（如 com.example.entity）；② 选择序列化注解库（Gson / Jackson / Fastjson / Lombok / 无）；③ 选择代码风格（toString / equals / hashCode / 构造器 / Serializable）；④ 选择字段命名策略（保持原样 / camelCase / 全小写 / UPPER_SNAKE）
3. 工具会在 400ms 内自动转换，右侧显示所有生成的 Java 类（每个类一个独立卡片，标题栏实时显示当前注解库和 Lombok 徽章）；如 JSON 格式错误会显示「修复 JSON」按钮
4. 检查生成的类名、字段名和注解是否符合预期；如需调整可修改源 JSON 的 key 名或重新打开 Settings 修改选项
5. 满意后可点击单个类的「复制」按钮粘贴到 IDE，或点击工具栏「Download ZIP」一键下载所有类（按包路径组织目录结构）

功能特点

• 4 种序列化注解库：Gson (@SerializedName) / Jackson (@JsonProperty + @JsonFormat 日期) / Fastjson (@JSONField) / Lombok (@Data)，开关切换即可
• Lombok @Data 模式：自动生成 @Data + @Builder + @NoArgsConstructor + @AllArgsConstructor 组合，Java 类从 ~50 行精简到 ~5 行
• 4 种字段命名策略：保持原样 / snake_case 转 camelCase（user_name → userName）/ 全小写 / UPPER_SNAKE 常量风格
• 代码风格自由组合：可选生成 toString / equals / hashCode / 无参构造器 / 全参构造器 / 实现 Serializable 接口
• 智能类型推断：自动识别 String / Integer / Double / Boolean / List<Object> / 嵌套对象类型，无需手动指定字段类型
• 嵌套类自动生成：嵌套对象自动转换为独立 Java 类（按首字母大写命名），数组中对象自动按「移除复数 s」规则命名类
• 数组泛型自动展开：JSON 数组自动转换为 Java List<T> 泛型，元素类型按首项自动推断
• 完整 POJO 模板：生成包含 package 声明 + 文件头注释（Copyright + 自动生成时间戳）+ import + 私有字段 + getter/setter 的完整 .java 文件
• ZIP 多文件下载：所有生成的类按包路径组织（如 com/example/entity/User.java），一键打包为 ZIP 下载，含目录结构
• 自定义包名 + 类名：可自由设置 package（如 com.example.entity）和根类名（如 User），所有类名同步基于根类名生成
• 缩进控制：右侧支持 2 / 4 空格缩进切换，匹配团队代码规范
• 复制单个类：每个生成的 Java 类有独立「复制」按钮，方便单独粘贴到 IDE 中
• 自动转换 + 错误修复：输入 400ms 防抖自动转换，JSON 错误时弹「修复 JSON」按钮，可自动修复常见格式错误（多余逗号、单引号等）
• 示例数据 + 文件上传：内置中文示例数据（含嵌套 address / company / tags / scores），支持拖拽或点击上传 .json / .txt 文件
• 本地历史记录：基于 localStorage 持久保存最近 200 条输入，刷新或误关页面后可快速恢复
• 本地浏览器运行：所有 JSON 解析、Java 生成、ZIP 打包都在你的浏览器内通过 JavaScript 完成，数据不上传任何服务器

代码示例

import com.fasterxml.jackson.databind.ObjectMapper;
import com.geekformat.pojo.User;
import com.geekformat.pojo.Address;

public class ApiClient {
    private final ObjectMapper objectMapper = new ObjectMapper();

    public User getUser(int userId) throws Exception {
        // 1) 调用 API 获取 JSON 字符串
        String json = httpClient.get("https://api.example.com/users/" + userId);

        // 2) 直接反序列化为本工具生成的 POJO
        User user = objectMapper.readValue(json, User.class);

        // 3) 强类型访问字段（编译期类型检查）
        System.out.println("User: " + user.getName());
        if (user.getAddress() != null) {
            System.out.println("City: " + user.getAddress().getCity());
        }
        return user;
    }

    public static void main(String[] args) throws Exception {
        ApiClient client = new ApiClient();
        User user = client.getUser(123);
        System.out.println(user.getName());
    }
}

import com.geekformat.pojo.User;

public class UserService {

    public User createUser() {
        // Lombok @Builder 模式：链式调用，比传统 setter 更直观
        User user = User.builder()
            .id(1)
            .userName("Alice")
            .email("alice@example.com")
            .isActive(true)
            .createdAt("2026-07-08T10:00:00.000Z")
            .build();

        System.out.println(user);
        // Lombok @Data 自动生成 toString()：
        // User(id=1, userName=Alice, email=alice@example.com, ...)

        return user;
    }

    public boolean isValid(User user) {
        // Lombok @Data 自动生成 equals() 和 hashCode()
        return user != null && user.getId() != null;
    }
}

/*
 * 对应 pom.xml 依赖：
 * <dependency>
 *     <groupId>org.projectlombok</groupId>
 *     <artifactId>lombok</artifactId>
 *     <version>1.18.30</version>
 *     <scope>provided</scope>
 * </dependency>
 */

# 1) 下载 ZIP 后（文件名形如 User.zip）
unzip User.zip -d src/main/java/

# 2) 检查目录结构
tree src/main/java/
# src/main/java/
# └── com/
#     └── example/
#         └── entity/
#             ├── User.java
#             ├── Address.java
#             └── Company.java

# 3) 在 IntelliJ IDEA 中：右键 com 目录 → "Mark Directory as" → "Sources Root"
#    或在 Eclipse 中：File → Import → Existing Projects into Workspace

# 4) 在 Spring Boot 项目中直接使用
#    UserController.java
#    @PostMapping("/users")
#    public ResponseEntity<User> createUser(@RequestBody User user) {
#        userService.save(user);
#        return ResponseEntity.ok(user);
#    }

# 5) 编译验证
mvn compile
# [INFO] BUILD SUCCESS

# 6) （可选）使用 Lombok 时记得在 pom.xml 加 lombok 依赖
#    <dependency>
#        <groupId>org.projectlombok</groupId>
#        <artifactId>lombok</artifactId>
#    </dependency>

常见问题

故障排查

术语表

POJO

Plain Old Java Object，普通 Java 对象。约束为：私有字段 + 公共 getter/setter + 不依赖框架。本工具生成的即是标准 POJO。

JavaBean

Java 社区早期对 POJO 的另一种称呼，要求有公共无参构造器 + 私有字段 + 公共 getter/setter。本工具生成的类符合 JavaBean 规范。

DTO (Data Transfer Object)

数据传输对象，常用于跨进程（API / RPC）的数据载体。本工具生成的 POJO 即可作为 DTO 使用。

VO (Value Object)

值对象，通常用于视图层（Controller 返回前端的数据）。本工具生成的 POJO 同样适用。

Entity

实体对象，对应数据库表的一行记录。本工具生成的 POJO 可作为 JPA / Hibernate 的 @Entity 基类（手动添加注解后）。

@SerializedName

Gson 库的字段映射注解。本工具 Gson 模式下会为每个字段自动添加 @SerializedName("原始 key")，保证反序列化时按原 JSON 字段名映射。

@JsonProperty

Jackson 库的字段映射注解。本工具 Jackson 模式下会为每个字段自动添加 @JsonProperty("原始 key")；日期字段额外加 @JsonFormat 定义序列化格式。

@JSONField

阿里巴巴 Fastjson 库的字段映射注解。本工具 Fastjson 模式下会为每个字段自动添加 @JSONField(name = "原始 key")。

Lombok @Data

Lombok 库的复合注解，等价于 @Getter + @Setter + @ToString + @EqualsAndHashCode + @RequiredArgsConstructor。本工具 Lombok 模式会在类上一键添加该注解。

Lombok @Builder

Lombok 的建造者模式注解。本工具勾选后会自动添加，生成可链式调用的 builder() 方法。

Serializable

Java 标记接口，实现后对象可被序列化（如写入文件 / 网络传输 / Redis 缓存）。本工具勾选「实现 Serializable」后会自动添加 implements Serializable 并 import java.io.Serializable。

嵌套类 (Nested Class)

工具对嵌套 JSON 对象自动生成的独立 Java 类。命名规则：嵌套对象 key 首字母大写（如 address → Address）。

List 泛型

Java 集合框架的接口，工具自动把 JSON 数组转为 List<T>，T 按数组首项自动推断（如 ["a"] → List<String>）。

getter / setter

Java Bean 的标准访问器方法。getter 命名 getXxx() 返回字段，setter 命名 setXxx(value) 设置字段。Lombok 模式下由 @Data 自动生成，传统模式下工具显式生成。

package 声明

Java 文件的第一行非注释代码，用于声明类所属的命名空间。本工具根据用户设置的包名自动生成，并在 ZIP 中按 com/xxx/yy 目录组织。

snake_case → camelCase

字段命名策略转换。本工具支持自动把 user_name → userName、is_active → isActive、created_at → createdAt，符合 Java 命名规范。

JSZip

浏览器端的 JavaScript ZIP 打包库，本工具用它在浏览器内直接生成 ZIP 文件，无需服务器端处理。

localStorage 历史

浏览器本地键值存储（容量约 5-10MB）。本工具用 localStorage 持久保存最近 200 条输入。

防抖 (Debounce)

前端性能优化技巧：把高频事件合并为最后一次执行。本工具设置 400ms 防抖，避免大文件解析卡顿。

tryFixJSON

本工具内置的 JSON 修复函数：自动修复末尾多余逗号、单引号替换为双引号、缺失引号的 key 补全、注释移除等常见错误。

JSON 类型到 Java 类型映射速查表

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

4 种序列化注解库对比表

工具支持的 4 种主流 Java JSON 序列化注解库，根据项目使用的框架选择：

4 种字段命名策略对比表

工具支持的 4 种字段命名转换策略，针对不同 JSON 来源优化：

Lombok @Data 模式 vs 传统 POJO 模式对比

对比两种代码风格的行数、可读性、依赖：

Privacy & Security

本 JSON 转 Java 工具所有 JSON 解析、Java 类生成、ZIP 打包操作完全在你的浏览器本地通过 JavaScript（JSZip）完成，输入的 JSON 数据和生成的 Java 代码都不会被上传到任何服务器，也不会被记录、缓存或存储到云端。包含内部接口字段、未上线业务结构、未公开 API 响应的敏感 JSON 都可以放心使用，关闭页面即清除全部数据。

Authoritative References

• MDNMDN - JSON.parse / JSON.stringify
• OracleOracle Java 教程 - 类与对象
• OracleOracle Java 教程 - 封装性
• LombokLombok 官方文档 - @Data
• LombokLombok 官方文档 - @Builder
• JacksonJackson 官方文档 - ObjectMapper
• GoogleGson 用户指南
• AlibabaFastjson GitHub
• SpringSpring Boot 官方 - @RequestBody