Ajax 時代的 Java 序列化策略：XML、JSON、模板引擎與 JDOM/JAXB/Betwixt 深度對比

在 Ajax 架構下，伺服器端視圖層從「生成完整 HTML」轉型為「輸出結構化資料」，Java 物件序列化策略的選擇直接決定前後端協作效率、頻寬成本與客戶端處理複雜度。本文系統對比五大序列化技術路線：手工 XML、XML 綁定框架（代碼生成/映射）、模板引擎、純文本、JSON，提供適用場景決策矩陣與實戰代碼範例。

一、領域模型：線上商店訂單系統

資料模型：Customer → Orders → Items

• Customer：username、realName、orders 集合
• Order：id、date、cost、items 集合
• Item：id、name、description、price

二、五大序列化策略深度剖析

策略 1：手工 XML 序列化 — 完全控制、零依賴

// Order.java
public Element toXML() {
    Element elOrder = new Element("order");
    elOrder.setAttribute("id", id);
    elOrder.setAttribute("cost", getFormattedCost());
    elOrder.addContent(new Element("date").setText(date));
    
    Element elItems = new Element("items");
    for (Item item : items) {
        elItems.addContent(item.toXML());  // 遞迴委派
    }
    elOrder.addContent(elItems);
    return elOrder;
}

// Servlet 輸出
Document doc = new Document(customer.toXML());
res.setContentType("application/xml");
new XMLOutputter(Format.getPrettyFormat()).output(doc, res.getWriter());

優點： 簡單直接、無額外依賴、任意物件圖幾行代碼搞定

致命缺陷： 模型與視圖強耦合 — 每類別只能有一種 XML 表現，導致：

• 訂單歷史不需 Item description，但序列化仍輸出 → 頻寬浪費、客戶端解析慢
• 商品搜尋需庫存資訊，但 Order 視圖無此欄位 → 無法複用
• XML 結構變更波及多個 Java 類，重構成本高

策略 2：XML 綁定框架 — 自動化映射，分代碼生成與映射兩派

2.1 代碼生成派：JAXB、XMLBeans、Zeus

• 流程： XSD Schema → 產生 Java 類 → 應用程式使用產生的類
• 優點： 大型 Schema 類型安全、IDE 智能提示、序列化/反序列化高效
• 缺點： 類結構綁死 Schema、無法加入業務行為、Schema 變更需重新產生並修改應用代碼、啟動慢
• 適用： 固定契約的系統整合、SOAP Web Services、大型標準化資料交換

2.2 映射派：Castor、Apache Commons Betwixt

• 流程： 寫 POJO → 運行時內省 → 可選映射檔覆蓋預設行為
• 優點： POJO 設計自由、映射檔簡單、彈性較好
• 缺點： 映射規則有限、物件結構與 XML 表現仍有殘留耦合、需妥協
• 適用： 中型專案、需一定彈性但不想手寫序列化代碼

策略 3：模板引擎 — 視圖與模型徹底分離

<!-- order-history.jsp --%>
<?xml version="1.0"?><%@ page contentType="application/xml" %>
<%@ taglib prefix="c" uri="https://java.sun.com/jsp/jstl/core" %>
<orderHistory username="${customer.username}">
    <c:forEach var="order" items="${customer.orders}">
        <order id="${order.id}" cost="${order.formattedCost}">
            <date>${order.date}</date>
            <items>
                <c:forEach var="item" items="${order.items}">
                    <item id="${item.id}">
                        <name><c:out value="${item.name}" escapeXml="true"/></name>
                        <price>${item.formattedPrice}</price>
                    </item>
                </c:forEach>
            </items>
        </order>
    </c:forEach>
</orderHistory>

優點： 視圖完全可定製，同一模型可生成訂單歷史/商品搜尋/行動版等多種 XML，邏輯在模板而非 Java 代碼

挑戰： 開發者需自行確保 XML 結構正確（標籤配對、實體轉義），無 Schema 驗證保護（開發期可補強）

策略 4：純文本 — 極簡場景的極致效率

• 適用： 簡單布林值、單一數值、逗號分隔列表
• 範例： true、42、item1,item2,item3
• 技巧： 正則表達式從 XML 回應提取單一值（responseText.match(/<date>(.*?)<\/date>/)）
• 警示： 同一應用混用 XML/文本會增加客戶端處理複雜度，建議統一格式

策略 5：JSON — JavaScript 原生資料格式，Ajax 黃金搭檔

// Order.java 使用 org.json
public JSONObject toJSONObject() {
    JSONObject json = new JSONObject();
    json.put("id", id);
    json.put("cost", getFormattedCost());
    json.put("date", date);
    
    JSONArray jsonItems = new JSONArray();
    for (Item item : items) {
        jsonItems.put(item.toJSONObject());
    }
    json.put("items", jsonItems);
    return json;
}

// Servlet 輸出
res.setContentType("application/json");
res.getWriter().print(customer.toJSONObject().toString());

客戶端處理 — 輕鬆愉快：

var customer = eval("(" + req.responseText + ")");  // 或 JSON.parse()
var firstItemName = customer.orders[customer.orders.length-1].items[0].name;

優勢對比：

三、綜合評分與選型決策矩陣

六大維度評分表（1-5 分）

四、現代最佳實踐建議

1. 新專案首選：Jackson/Gson 自動 JSON 序列化

// 僅需在 POJO 加上註解，零樣板碼
@JsonInclude(JsonInclude.Include.NON_NULL)
@JsonPropertyOrder({"id", "name", "price", "description"})
public class Item {
    private String id;
    private String name;
    private String description;
    private BigDecimal price;
    // Getter/Setter 或 public 欄位
}

// Spring MVC 自動處理
@GetMapping(value = "/api/items", produces = MediaType.APPLICATION_JSON_VALUE)
public List getItems() { return itemService.findAll(); }

• 支援視圖定製：@JsonView、@JsonIgnore、ObjectMapper.writerWithView()
• 支援多態序列化：@JsonTypeInfo
• 效能極佳、社群最活躍、Spring Boot 整合零配置

2. 需多視圖/複雜 XML 契約：模板引擎 (Thymeleaf/FreeMarker/JSP)

• 同一模型生成訂單歷史 XML、商品搜尋 XML、行動版精簡 XML
• 前端團隊可獨立維護模板，後端只準備資料
• Thymeleaf 支援原型預覽、自然模板，開發體驗最佳

3. 系統整合/外部契約固定：JAXB (代碼生成)

• 對方提供 XSD，我方生成類，類型安全、IDE 支援完整
• 內部領域模型與整合模型分離，透過 Mapper/Converter 轉換

4. 避免手工 XML/JSON 序列化方法

維護成本高、易出錯、視圖靈活性差。僅在極簡原型驗證或受限環境（無法引入第三方庫）考慮。

五、總結：序列化策略選型決策樹

1. 資料極簡（布林/單值/列表） → 純文本
2. Ajax/Web API，追求前端處理效率、頻寬優化 → JSON (Jackson/Gson)
3. 需同一模型多種視圖、前後端分離開發、XML 契約 → 模板引擎
4. 大型固定 Schema 系統整合、SOAP、類型安全優先 → JAXB 代碼生成
5. 中型專案、需一定彈性、不想手寫序列化 → 映射綁定

核心原則：視圖屬於視圖，模型屬於模型. 選擇能讓兩者獨立演進的序列化策略，才是架構師的智慧。在 Ajax 時代，JSON + 現代序列化庫已成為 90% 場景的最優解；剩餘 10% 複雜視圖定製場景，交給模板引擎專業解決。