JSON轉Scala 3類

從 JSON 樣本建立 Scala 3 資料模型

這項工具會讀取你貼上的有效 JSON，依樣本中的欄位和值產生 Scala 3 程式碼。常見輸出是 case class：它以欄位描述一筆資料，方便在程式中建立、傳遞與存取資料。這個流程適合先把 API 回應或設定檔樣本整理成模型草稿，再由開發者對照實際資料契約調整。

JSON 的值包含字串、數字、布林值、null，以及物件和陣列。物件欄位提供名稱和值，巢狀物件呈現更深一層的資料結構；陣列則提供一組有序樣本。生成器只能依輸入中實際出現的值推斷型別，因此不同樣本內容會影響程式碼。JSON 本身沒有專用日期型別，日期格式的值仍是字串資料；若要在 Scala 程式中使用日期型別，需按專案規則自行決定。

輸出是程式碼草稿，依專案需求確認

表單可設定根型別名稱與 Scala package name，並可選擇只產生型別定義；預設型別名稱為 Root，且啟用僅型別定義。進階選項也提供列舉、日期時間、UUID、Map、相似類別合併等推斷項目。這些選項會影響程式碼呈現，使用前應確認與團隊的命名方式和資料模型習慣相符。

case class 著重描述資料，不會單憑類別宣告就替專案設定 JSON 函式庫的讀取、寫入或 API 呼叫方式。Scala 官方文件可參考 case class 的欄位與語言行為；JSON 的資料類型定義則見 RFC 8259。使用前請將生成內容放入目標 Scala 3 專案檢查並編譯。

參考依據

• IETF RFC 8259：支持 JSON 基本值、物件與陣列的結構說明；2017 年發布，於 2026-09-30 查閱。
• Scala 官方 Case Classes 文件：支持 Scala case class 作為資料欄位模型的背景說明；於 2026-09-30 查閱。

貼上樣本並檢查生成結果

1. 準備有效 JSON。若要描述多筆記錄，盡量挑選能反映欄位變化的代表樣本；輸入區也可載入內建範例，或先格式化 JSON 以方便閱讀。

2. 確認目標語言為 Scala 3，填入根型別名稱，並按專案需要設定 package name。若只需要資料型別宣告，保留「僅型別定義」選項。

3. 檢視自動產生的程式碼，逐項核對欄位名稱、巢狀結構、集合元素與型別推斷；需要時調整進階推斷選項或補充樣本。

4. 複製或下載輸出，放入專案後用該專案的 Scala 3 版本與相依套件編譯，再以實際 JSON 測試欄位映射。

例如輸入 {"name":"Lin","age":18,"active":true}，樣本提供了文字、整數樣式數字及布林值三種欄位線索。這只是依這筆資料形成的型別草稿；將它用於專案前，仍要確認欄位命名與正式規格一致。

樣本無法代表所有可能資料

單一 JSON 樣本只呈現當次輸入的值，無法說明其他記錄是否省略欄位、是否會出現 null，或陣列是否還含有不同型別的元素。特別是空陣列沒有元素可供推斷；請對照多筆代表資料或正式 schema，人工確認元素型別和欄位可空規則。

生成結果不等同完整資料契約，也不會自動提供特定 JSON 函式庫的 encoder、decoder 或 API 請求程式。欄位命名轉換、Scala 保留字、數值範圍和實際相依版本都應在目標專案中檢查；有編譯錯誤時，依專案慣例調整宣告後再用實際資料驗證。不要只因程式碼已生成，就視為模型已通過編譯或資料相容性檢查。