JSON轉Java實體類

從 JSON 樣本建立 Java 類別

這項工具會讀取你貼上的 JSON，依其中看得到的欄位和值推斷 Java 型別，並輸出類別程式碼。物件通常對應類別與欄位，巢狀物件可形成額外類別，陣列則依樣本元素推斷元素型別。例如，訂單物件含有商品物件陣列時，輸出可呈現訂單與商品之間的資料結構。這是由範例推導程式骨架，並非完整 API 契約或 JSON Schema 驗證。
JSON 規格允許字串、數字、布林值、null、物件和陣列；欄位型別則是產生器根據有限樣本做出的選擇。整數、小數、日期樣式字串、UUID 樣式字串、空值與混合元素陣列，都可能影響推斷結果。數字在 JSON 中沒有指定 Java 的 int、long、double 或 BigDecimal；金額與大整數須依系統需求檢查精度及範圍。

輸出會受到哪些選項影響

根類別名稱可自行設定，Java 專屬選項包含 package、僅產生型別定義，以及 Lombok。一般推斷選項可辨識列舉、日期時間與 UUID 樣式，也可調整字串型數字或布林值的處理、Map 推斷及相似類別合併。預設根名稱是 Root；Java package 初始值為 io.quicktype；僅產生型別定義預設開啟，Lombok 預設關閉。選項不同，輸出內容也會改變。

例如輸入 {"orderId": 1001, "paid": true, "items": [{"sku": "A-1", "quantity": 2}]}，產生結果會依範例建立根類別、欄位及商品相關型別。實際型別名稱和欄位命名仍應以結果為準，不宜把單筆樣本推定成所有資料都遵循的規則。

JSON 合法不代表類別完整

JSON 可以是單一數字、字串或 null，不一定含有可轉成欄位的物件；空陣列也沒有元素可供推斷。陣列允許不同型別混合，若樣本中只有一種值，產生結果未必能涵蓋實際資料中的其他型態。根陣列、缺少欄位的物件和 null 值也應分別檢查。工具用途是協助起草模型，完整性仍須對照介面規格與多筆代表性回應。

產生程式碼的操作流程

1. 準備具代表性的 JSON

   先使用格式正確的物件或物件陣列。若同一欄位可能缺漏、為 null 或出現不同值，盡量納入多筆樣本資料，避免只從單一狀態推斷型別。請先移除正式環境的憑證、Token 和個人資料。

2. 輸入並檢查格式

   貼上 JSON 後，若解析失敗，可使用格式化功能整理縮排並定位語法問題；載入範例可先查看輸入形式。清空則會移除目前輸入。

3. 設定類別和輸出方式

   將預設的 Root 改為符合專案命名方式的類別名稱，並視專案調整 package。只需類別與型別定義時，保留「僅產生型別」；專案已安裝 Lombok 且需要其註解時，再開啟相應選項。進階推斷選項可調整日期、列舉、UUID、字串型數值等判斷。

4. 核對後複製或下載

   閱讀結果，檢查巢狀型別、欄位名稱、可空欄位和數字精度，再複製程式碼或下載 Java 檔。把生成內容放進專案後，依實際 JDK、依賴和序列化方式編譯與測試。

常見輸入與輸出疑問

納入程式碼前的人工檢查

生成結果只反映你提供的樣本，不等於 API 規格、JSON Schema 或完整驗證規則。

• JSON 數字不會自行指定 Java 數值型別；金額、精確小數及大整數請依業務精度與範圍重新選型。
• null、欄位缺少、空陣列及混合型別陣列可能導致推斷不完整；用多種實際樣本測試。
• Java 關鍵字不能直接作為識別字。特殊欄位名稱經轉換後，請確認結果仍能對應原始 JSON 欄位。
• 開啟 Lombok 會讓輸出依賴專案端的 Lombok 設定；若沒有相關依賴，請關閉該選項或先補齊專案設定。
• 不要將存取 Token、密碼、個資或未脫敏的正式資料貼入工具。生成碼應先在本機專案編譯並用實際資料驗證，再納入正式程式碼。