課程

對 XML 的簡短而實用的導論：基礎結構（元素、屬性、文字節點、註解、 CDATA）、prolog 的組成；更重要的是——為什麼需要命名空間以及如何透過屬性 xmlns 與 xmlns:prefix 來宣告與套用它們。將說明前綴、預設命名空間（ xmlns= "URI"）、在同一文件中混用不同「詞彙」以及常見的解析錯誤。

本講次將說明兩種經典的 XML 解析方式：樹狀的 DOM 與事件導向的 SAX。你將學會透過樹結構（ Document、 Element、 NodeList）讀取與修改文件，並以事件處理器（ SAXParser、 DefaultHandler、 startElement/ characters/ endElement）串流處理大型檔案。我們會展示各種方法的優缺點、實作範例，並拆解常見錯誤（記憶體、在 characters 中的文字分割、在 SAX 中嘗試修改 XML）。

用 StAX 拆解 XML 的流式解析：pull 模型與 SAX 的 push 方式有何不同，如何透過 XMLInputFactory 建立解析器，並以迴圈呼叫 reader. next() 從 XMLStreamReader 讀取事件；有哪些事件型別（ START_ELEMENT、 CHARACTERS、 END_ELEMENT、 END_DOCUMENT），以及何時 StAX 比 DOM/ SAX 更合適。另外包含：各方法比較表、Mermaid 圖表，以及常見錯誤解析（資源/串流洩漏、元素巢狀、 XMLStreamException、 IOException 等）。

如何使用 JAXB（Jakarta XML Binding）在 Java 物件與 XML 之間互相轉換：關鍵註解 @XmlRootElement、 @XmlElement、 @XmlAttribute、 @XmlType、 @XmlTransient；基礎類別 JAXBContext、 Marshaller、 Unmarshaller；透過屬性 Marshaller.JAXB_FORMATTED_OUTPUT 設定格式化輸出。涵蓋 Java 11+ 的 Maven 相依（ jakarta.xml.bind-api、 jaxb-runtime）、處理集合與巢狀物件、控制元素順序（ propOrder）、排除欄位與常見錯誤。

如何讓 JAXB 序列化「非標準」型別並以所需格式呈現資料：使用註解 @XmlJavaTypeAdapter，並基於 XmlAdapter<ValueType, BoundType> 撰寫自訂配接器。會講解日期格式化（ LocalDate → "dd.MM.yyyy"）、數字（ BigDecimal）、處理集合，透過 @XmlAttribute 將值放入屬性、透過 @XmlElement 輸出為元素，以及用 @XmlTransient 排除欄位。還會練習透過 Marshaller/ Unmarshaller 進行序列化/反序列化，並解析常見錯誤。