JSON 轉 Java

相關推薦

關於 JSON 轉 Java POJO 與 Java 實體類別

適用場景

• Android 開發：把後端 API 回傳的 JSON 轉為 Java 實體類別（POJO），可選 Gson / Moshi / Fastjson / Jackson 註解直接用於反序列化
• Spring Boot 後端：把 API 介面文件中的範例 JSON 快速轉為 DTO / VO / Entity 類別，配合 Lombok @Data 精簡程式碼量
• 對接第三方 API：把對方 API 的回應 JSON 轉為對應 Java 模型，選擇對應的序列化註解（Jackson / Fastjson / Gson）無縫對接
• 微服務架構：統一 RPC API 的請求 / 回應資料模型，多個團隊共享同一份 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 欄位、未上線業務結構、未公開 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