課程

精要且現代的 JSON 資料交換格式導論：它是什麼、為何成為事實上的 REST API 標準；基本結構—物件 { } 與陣列 [ ]；允許的型別（字串 "..."、數字、布林值 true/ false、 null）、巢狀、與 XML 的比較、JSON ↔ Java 的對應（集合 Map<K, V>、 HashMap<K, V>）。解析實用範例與常見錯誤：單引號、多餘逗號、 undefined、具有前導零的數字。

Jackson — 是在 Java 中處理 JSON 的事實上標準：從透過 ObjectMapper 進行簡單的序列化與反序列化，到使用註解 @JsonProperty、 @JsonIgnore、 @JsonInclude、 @JsonFormat 做細緻設定。這堂課將說明如何引入（ jackson-databind）、讀寫物件與集合、pretty-printing、處理日期，以及常見錯誤，包括搭配 TypeReference 的泛型與對 POJO 的要求（無參數建構子、getter/setter）。

在本講次中我們將講解 Google 的 Gson 函式庫：從 toJson/ fromJson 的快速上手、透過 TypeToken<> 反序列化集合、以及使用 GsonBuilder 進行彈性設定（ setPrettyPrinting、 serializeNulls、 setDateFormat）。我們會說明 @SerializedName、 @Expose 註解，版本控制的 @Since/ @Until，自訂配接器 TypeAdapter 與 registerTypeAdapter，最後與 Jackson 做比較並梳理常見錯誤。

當 JSON 的結構事先未知或經常變動時，與其使用嚴格的 Java 類別，不如使用通用的容器： Map、 List 與 JSON 樹。這堂課說明如何用 ObjectMapper 將資料讀入 Map<String, Object> 與 List，如何透過 JsonNode 及其方法 get/ path/ asText() 安全地遍歷樹；也會介紹以 Gson 為替代方案，使用 JsonElement、 JsonObject、 JsonArray。最後以抽取組態的實作收尾，並解析常見錯誤。

為何以及如何在反序列化前檢查以 JSON 格式傳入的資料：透過 JSON Schema 制定資料契約（鍵 type、 properties、 required、 format），在 Java 中使用 everit-org/json-schema 進行驗證（將架構載入為 Schema，呼叫 validate），妥善處理 ValidationException，並為使用者與 API 產生清楚易懂的錯誤訊息。