JPivot 表現層深度解析：Mondrian OLAP 的 XML/XSLT 渲染架構

前言：另類但精明的架構選擇

JPivot 是 Mondrian OLAP 引擎的官方表現層 Tag Library。其架構乍看異類：XML/XSLT 渲染 + 純 JSP TagLib 無 MVC 框架。但深入剖析，每個設計決策都精準命中 OLAP 報告的特殊需求。本文記錄漢化實踐與架構心得。

漢化實戰三部曲

# 1. 資源檔漢化
find . -name "resources.properties" -exec sh -c '
  native2ascii -encoding UTF-8 {} ${1%.properties}_zh.properties
' _ {} \;

# 2. JSPX/XSL 模板漢化
find WEB-INF/jpivot -name "*.xml" -exec sh -c '
  cp {} ${1%.xml}_zh.xml
  # 編輯 _zh.xml 替換英文標籤為中文
' _ {} \;

# 3. 確保 Locale 解析正確
# JPivot 依據 request.getLocale() 自動載入 _zh 後綴資源

架構深度剖析：為什麼選 XML/XSLT？

OLAP 報告的特殊性

• 高度結構化：維度、度量、層級、切片、鑽取、鑽透
• 規則性強：表格、圖表、導航器皆為資料的不同投影
• 互動複雜：展開/收合、排序、過濾、頁面切換、匯出

Transform Engine vs Template Engine

結論：OLAP 報告的「高度規則化樹狀結構 + 多重投影需求」完美契合 XSLT 的強項。Martin Fowler 雖批評 XSLT 略帶 LISP 風格，但在這個特定領域，它比任何 Template Engine 都高效。

純 TagLib 架構：通用性的代價與收益

JPivot 不基於 Struts/Spring MVC 等框架，而是完全建構於 JSP TagLib 之上。這看似反模式，實則是為了：

• 零框架依賴：只要 Servlet 容器即可運行，承擔 Mondrian 「唯一官方表現層」的通用性使命
• 頁面即控制器：JSP 頁面直接編排資料查詢、轉換、渲染流程，MVC 在頁面內部以 Tag 巢狀實現
• 領域特化語言：``、``、`` 形成 OLAP 專用 DSL

典型請求流程追蹤

# 請求：testPage.jsp?query=mondrian

# 1. Controller 層 - testPage.jsp
 根據 query 參數匹配 /WEB-INF/query/mondrian.jsp 獲取資料

# 2. Model 層 - mondrian.jsp
 執行 MDX 查詢，結果放入 query01 變數

# 3. View 準備 - testPage.jsp (Transform Engine 步驟 1: Domain → Display Data)
 根據查詢結果準備表格顯示所需資料結構

# 4. View 渲染 - testPage.jsp (Transform Engine 步驟 2: Display Data → Presentation)
 使用 XSLT 渲染最終 OLAP 表格

# 5. 循環步驟 3-4 處理導航器、圖表
 準備導航資料
 渲染導航
 準備圖表資料
 渲染圖表

雙階段渲染模式 (Transform Engine 核心)

Martin Fowler 在《Patterns of Enterprise Application Architecture》中定義的 Transform Engine 兩步驟：

1. 資料轉換階段：從領域模型 (Mondrian CellSet/Result) 轉換為「顯示就緒」的結構化資料 (JPivot 內部 XML 結構)。對應 ``、`` Tag。
2. 呈現渲染階段：將顯示就緒資料透過 XSLT 轉換為最終輸出 (HTML/PDF/CSV)。對應 `` Tag。

這種分離使得：

• 同一查詢結果可輸出多種格式 (HTML 表格、Excel、PDF、圖表)
• 修改外觀只需改 XSLT，不動 Java 碼
• 新增輸出格式只需新增 XSLT，符合開放封閉原則

WCF (Web Component Framework) 核心機制

• ``：動態包含查詢頁面，支援參數傳遞
• ``：綁定資料模型引用 (`ref`) 與 XSLT 模板 (`xsluri`)，執行轉換
• 資料模型以 `id` 在 `pageScope`/`requestScope`/`sessionScope` 傳遞

現代化遷移建議

JPivot 最後釋出於 2010 年，現代 OLAP 前端建議：

若必須維護 JPivot 既有系統：升級 Servlet API、修正 XSLT 安全性 (XXE 防護)、引入 CSS Framework 美化輸出、配合 Spring Boot 嵌入式部署。

1. 上一篇文章： Apache 2.0.53 + Tomcat 5.5.9 整合指南 (Windows 版)：最簡單的 JK2 連接器配置
2. 下一篇文章： ReaderToken：支援多重分隔符與萬用字元的串流 Tokenizer 實作

Java 相關知識

Java 設計模式：計數代理模式深度解析

模式動機 在軟體系統中，服務提供者（Real Subject

基於 J2EE 的電子商務開發模型：架構優化與實戰解析

前言 隨著網路技術的普及，電子商務已從早期的靜態展示發展為動

Hibernate 3.3.2 註解版入門實戰：從環境搭建到第一個持久化類

前言 Hibernate 作為 Java 持久化領域的經典框

基於 Maven 的 Jersey REST 服務快速構建：Grizzly2 獨立模式與 Servlet 容器部署全流程

方案一：Java SE 獨立模式 項目創建 mvn arc