JSON Swiss 標誌

JSON Swiss

Scala → JSON Schema 產生器

Scala 程式碼 輸入

正在載入編輯器…

JSON Schema（輸出） 輸出

設定

選擇產生 Schema 時的 root case class。

解析完全在瀏覽器內完成，你的程式碼不會離開此頁面。

貼上 Scala types，立即產生 JSON Schema。

支援 case classes、Option、集合與巢狀引用。

如何將 Scala case class 轉為 JSON Schema（步驟指南）

這個線上轉換器（Scala case class → JSON Schema）可從真實模型（DTO、struct、class）產生 JSON Schema，方便驗證 payload、分享契約，並生成 mock JSON。

  1. 步驟 1：貼上 Scala 程式碼

    • 將要文件化的模型貼到左側編輯器。
    • 把被引用的型別也放在同一段程式碼中，便於產生 definitions。
    • 點擊 範例 載入範例，了解預期輸入格式。

  2. 步驟 2：選擇 根類型（如需要）

    • 若偵測到多個 definitions，選擇與你的 API payload 相符的 root 型別。
    • 輸出 Schema 會以選中的 root 為中心，並包含引用型別的額外 definitions。

  3. 步驟 3：檢視 JSON Schema 輸出

    • 重點檢查型別、必填/可選欄位，以及巢狀物件/陣列結構。
    • 當模型引用其他模型時，注意 definitions 以及 $ref 是否正確。
    • 複製或下載 Schema，用於驗證、文件或 schema-first 開發。

  4. 步驟 4：驗證或產生 mock JSON

    • 點擊 產生 Mock 資料 即可開啟已預載 Schema 的 Mock 產生器。
    • 用真實 payload 驗證 Schema，及早發現破壞性變更。
    • 若你依賴更進階的 schema 組合（例如 anyOf/oneOf/allOf），建議用 Ajv 等完整 validator 再驗證一次。

Schema keywords 支援說明

產生的 Schema 可能包含 $ref ，也可依需求補上 anyOf, oneOf, 或 allOf。當 Schema 更複雜時，建議使用完整的 JSON Schema validator；若要產生 mock，必要時可先 dereference 再生成。

相關工具

搭配這些工具一起使用：驗證 Schema、產生 mock payload、格式化 JSON 範例，並保持程式碼與契約一致。

JSON Schema Mock 產生器

由 Schema 產生範例 JSON，用於測試、fixtures 與文件。

JSON Schema 驗證器

使用常見 Schema keywords 驗證 JSON，快速定位不匹配。

JSON 轉 Scala case class

由 JSON 範例產生 Scala 型別與模型。

JSON → JSON Schema 產生器

由代表性的 JSON 範例產生 Schema，補齊 model-first 的情境。

JSON Schema 資料庫

瀏覽物件、陣列、enum 與 constraints 的 Schema 範例與模式。

JSON 格式化

在驗證 Schema 或分享文件前，先清理並規範化 JSON 範例。

常見問題

支援哪些 Scala 程式碼？

支援 case classes、Option、常見集合與巢狀引用。可貼上多個相關 types 以產生 definitions。

Option 與集合如何處理？

Option[T] 會視為 optional；List/Seq/Array 會映射為 array/items。enums 與 sealed traits 會依資訊量做合理 fallback。

可以選擇 root type 嗎？

可以。若偵測到多個 definitions，請在設定中選擇 root case class。

如何產生 mock 資料？

產生 Schema 後，點擊「產生 Mock 資料」即可開啟已預載 Schema 的 Mock 產生器。

Scala → JSON Schema 產生器 | JSONSwiss