XML 在 B/S 架構開發中的應用：Servlet+XSLT 管道架構替代 JSP 的優勢實踐

傳統 JSP 開發模式存在代碼與標記混雜、邏輯分散、調試困難、前後端強耦合等痛點。本文提出基於「統一 Servlet 控制器 + 業務 Bean 產出 XML + XSLT 轉換輸出」的管道架構，利用 JDK 1.4+ 內建 XML/XSLT API 與 IE6+ 客戶端原生支援，實現真正的「數據與表現分離」、多端適配、高度復用與標準化開發。

JSP 開發模式四大痛點

1. 代碼嵌入標記：Java 邏輯與 HTML 標籤交織，頁面臃腫、可讀性差、IDE 支援弱。
2. 接口定義模糊：前後端交互依賴隱性約定，複雜巢狀數據需構造專用顯示類，溝通成本高。
3. 調試週期長：修改 JSP 需等待容器重新編譯、熱部署，微小調整耗時數十秒。
4. 復用機制原始：``、`Taglib` 復用粒度粗、參數傳遞繁瑣、缺乏結構化組合能力。

XML + XSLT 管道架構設計

核心流程

HTTP Request
    ↓
統一 Servlet (Front Controller)
    ├── URL 映射 → 業務 Bean (Action/Command 模式)
    ├── 業務 Bean 執行邏輯，**純粹產出 XML 數據** (DOM/SAX/序列化)
    ├── Servlet 根據請求參數/用戶代理 選擇 XSLT 樣式表
    ├── XSLT 處理器 轉換 XML → HTML / WML / SVG / PDF (XSL-FO) / JSON...
    └── HTTP Response (Content-Type 對應輸出格式)

關鍵組件

• 業務 Bean 契約：輸出符合預定 Schema 的 XML 文檔，無任何表現邏輯。
• XSLT 樣式表庫：按功能模組組織，支援 ``/`` 模組化復用。
• Servlet 映射器：`RequestURI → Bean + XSLT` 映射表（可外部化配置）。
• 緩存策略：編譯後的 Templates 對象緩存、XSLT 編譯緩存、輸出片段緩存。

架構優勢深度解析

實戰代碼骨架

1. 統一 Servlet (Front Controller)

public class PipelineServlet extends HttpServlet {
    private Map mappings; // URI → {beanClass, xsltPath}
    private TransformerFactory tFactory = TransformerFactory.newInstance();
    private Map xsltCache = new ConcurrentHashMap<>();

    protected void doGet(HttpServletRequest req, HttpServletResponse resp) {
        process(req, resp);
    }
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) {
        process(req, resp);
    }

    private void process(HttpServletRequest req, HttpServletResponse resp) {
        String uri = req.getRequestURI();
        PipelineMapping mapping = mappings.get(uri);
        if (mapping == null) { resp.sendError(404); return; }

        try {
            // 1. 實例化/獲取 Bean (可整合 Spring/容器)
            BusinessBean bean = (BusinessBean) Class.forName(mapping.beanClass).newInstance();
            // 2. 執行業務邏輯，產出 XML (DOM Document)
            Document xmlDoc = bean.execute(req); // 返回 org.w3c.dom.Document
            // 3. 選擇 XSLT (可根據 User-Agent 動態選擇)
            String xsltPath = selectXSLT(req, mapping);
            // 4. 獲取/編譯 Templates
            Templates templates = xsltCache.computeIfAbsent(xsltPath, p -> {
                try { return tFactory.newTemplates(new StreamSource(getServletContext().getResourceAsStream(p))); }
                catch (Exception e) { throw new RuntimeException(e); }
            });
            // 5. 轉換輸出
            Transformer transformer = templates.newTransformer();
            transformer.setParameter("contextPath", req.getContextPath()); // 傳遞上下文參數
            transformer.transform(new DOMSource(xmlDoc), new StreamResult(resp.getOutputStream()));
        } catch (Exception e) {
            log("Pipeline error", e);
            resp.sendError(500);
        }
    }
}

2. 業務 Bean 示例 (產出 XML)

public class ProductListBean implements BusinessBean {
    public Document execute(HttpServletRequest req) {
        DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();
        dbf.setNamespaceAware(true);
        Document doc = dbf.newDocumentBuilder().newDocument();
        Element root = doc.createElement("catalog");
        doc.appendChild(root);
        root.setAttribute("timestamp", new Date().toString());

        List products = productDao.findAll(); // 純業務邏輯
        for (Product p : products) {
            Element item = doc.createElement("product");
            item.setAttribute("id", String.valueOf(p.getId()));
            item.appendChild(createElement(doc, "name", p.getName()));
            item.appendChild(createElement(doc, "price", String.valueOf(p.getPrice())));
            item.appendChild(createElement(doc, "image", p.getImageUrl()));
            root.appendChild(item);
        }
        return doc;
    }
    private Element createElement(Document doc, String name, String text) {
        Element e = doc.createElement(name);
        e.setTextContent(text);
        return e;
    }
}

3. XSLT 樣式表 (catalog.xsl)

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="https://www.w3.org/1999/XSL/Transform">
  <xsl:output method="html" encoding="UTF-8" indent="yes"/>
  <xsl:template match="/catalog">
    <html><head><title>產品目錄</title></head><body>
      <h1>產品列表 (更新於: <xsl:value-of select="@timestamp"/>)</h1>
      <table border="1">
        <tr><th>名稱</th><th>價格</th><th>圖片</th></tr>
        <xsl:for-each select="product">
          <tr>
            <td><xsl:value-of select="name"/></td>
            <td><xsl:value-of select="price"/></td>
            <td><img src="{image}" width="100"/></td>
          </tr>
        </xsl:for-each>
      </table>
    </body></html>
  </xsl:template>
</xsl:stylesheet>

避坑指南與最佳實踐

• ⚠️ **XSLT 學習曲線**：團隊需投入培訓，建議建立「XSLT 模式庫」（頁首、頁尾、表格、表單、分頁等通用模板）。
• ⚠️ **性能調優**：
  • 緩存 `Templates` 對象（線程安全，重入性好）。
  • 大數據量使用 SAX/StAX 流式生成 XML，避免 DOM 佔用大內存。
  • XSLT 中避免 `//` 深度搜索，使用具體路徑；善用 `` 索引優化交叉引用。
• ⚠️ **字符編碼**：全鏈路 UTF-8（XML Declaration、Servlet Response、XSLT Output、資料庫連接）。
• ⚠️ **錯誤處理**：XSLT 編譯/轉換異常需捕獲，輸出友好錯誤頁（亦可用 XSLT 渲染錯誤 XML）。
• ✅ **漸進遷移**：舊 JSP 頁面可通過「JSP 產出 XML → 通用 XSLT」過渡，逐步剝離業務邏輯至 Bean。
• ✅ **測試策略**：Bean 單元測試驗證 XML Schema 合規；XSLT 測試使用獨立 Demo XML，瀏覽器/命令行 (`xsltproc`, `saxon`) 驗證輸出。

現代視角的傳承

雖然現代框架（Spring MVC、Struts2、JSF、Thymeleaf、React/Vue+API）已主流，但 **「統一入口 + 數據模型 + 視圖模板」的管道思想始終未變**。XML+XSLT 方案在以下場景仍具獨特優勢：

• 嚴格的多格式發布需求 (HTML/PDF/RSS/JSON 同源)
• 強契約異構系統集成 (銀行、電信、政府報表)
• 前後端團隊物理隔離、技術棧完全不同
• 數據庫原生 XML 能力充分利用場景

理解這一架構，有助於看透現代框架的本質，在技術選型時不被表象迷惑。