XSLT 2.0 是 W3C 發布的 XML 轉換語言新規範,其中不少特性正是為了補上 XSLT 1.0 的不足。本系列從 1.0 使用者的視角出發——想解掉老問題、想學新技術、想知道有何新玩意值得期待——既做高層概覽,也做深入剖析,並附上取自常見應用的實例與實務建議,協助你真正動手遷移。
你大概聽過「XSLT 2.0 大致相容 1.0,另外多了一堆新東西」。但實際情況更微妙:你的 1.0 樣式表可能只用到 1.0 功能的一小部分,而你真正想用的 2.0 特性,又可能只是 2.0 龐大特性集中的一小塊。所以規劃升級時,把注意力放在「你實際在用的舊寫法」與「真正吸引你的新功能」這兩端就好。
本文提出五種立場鮮明的選項——嚴格說是四種升級路徑加上「不升級」。要從中挑一個,得同時權衡兩類因素:組織自身的能力條件(推力),以及吸引你的 2.0 特性(拉力)。
2.0 規範引入了「樣式表模組」這個術語,指可被 import 或 include 進某個集合單元(通常是一個檔案)的單位。模組的切分比單純按模板劃分更強,因為 XSLT 宣告通常只在單一模組內有效。如果你傾向漸進式遷移,除了既有的模組切分之外,不妨刻意用模組把舊的 1.0 程式碼與新程式碼分開。
供應商可以(自願)提供支援 BC 的 2.0 處理程序。BC 由 version 屬性控制,而這個屬性可以出現在任何元素上——這點和 1.0 不同,1.0 只允許它出現在頂層 xsl:stylesheet。當某元素帶著 version="1.0",該元素及其子樹就會啟用 BC,概念上像是「照 1.0 方式執行的程式碼孤島」,只有極少數例外。
關鍵在於:BC 是依文件結構啟用的,不是依執行時的流程。舉例來說,若 xsl:call-template 帶著 version="1.0",但它實際呼叫到的命名模板標的是 version="2.0",那麼執行該模板時並不會啟用 BC。
同理,被 import 或 include 的樣式表模組若標了 version="1.0",那個模組就會啟用 BC,即使主樣式表是 2.0。也別忘了:BC 模式下由 2.0 處理程序產生的結果,未必和真正的 1.0 處理程序一模一樣。完整的差異清單可查 XSLT 2.0 規範附錄 J、F&O 附錄 D 與 XPath 2.0 附錄 I 的相容性附錄。
有些工具會為 1.0 與 2.0 處理程序準備不同的程式碼,但它們在更低的層次運作。對策略規劃而言,理解到這個程度已經足夠。
每條路各有得失。以下各節先描述做法,再列出優點與代價。有些選項把「沿用既有的在地規範調整或程式碼清理」列為優點,意思是團隊既有的清理清單(例如關於程式風格、關於哪些模組有權放特定宣告的內部約定)仍然適用。
這基本上等於從頭來過。為了真正發揮 2.0 語法與特性的優勢,要有心理準備:整個設計可能需要重新規劃,大部分樣式表模組需要重寫。若現有樣式表的模組化結構本來就很好,可以保留;更常見的情況是,只要你的 1.0 樣式表架構清晰,就能省下一些規劃時間——具體省多少,取決於你想採用哪些 2.0 特性。
優點:
缺點:
如果全面重寫太激進,次佳選擇是把大部分樣式表模組轉到 2.0,同時重用一些 1.0 模組。1.0 孤島可以小到單一模板,也可以大到一整層結構。這條路一樣需要規劃,重點是決定新 2.0 特性用在哪裡,並評估舊模組在新結構下的可重用性。
優點:
缺點:
如果你只是為了某幾個特定的 2.0 特性,可以在既有 1.0 樣式表中「補上」2.0 孤島,用支援 BC 的 2.0 處理程序來跑。若結果不如預期,再逐步調整 1.0 模組直到滿意。這條路把火力集中在真正需要的新功能上,規劃與重新設計的負擔最小。它在你需要的特性容易切割隔離時最為有效——哪些特性比較容易隔離,請見後文〈縮小選擇範圍〉。
優點:
缺點:
想快速把 1.0 樣式表變成 2.0?那就把 version 屬性改成 2.0,跑跑看 2.0 處理程序能不能給出預期結果。不行就開始除錯:逐一回溯每個模板的輸出並修正到滿意為止。修正手段可能是改用適當的 2.0 指令,或者(若支援 BC)把版本屬性設回 1.0 看看會發生什麼。這條路顯然不太在意是否用上新特性。
優點:
缺點:
version="1.0",那就需要支援 BC 的處理程序。你也可能捫心自問:既然 1.0 樣式表跑得好好的,何必改?不必學 2.0 語法、不必規劃 2.0 結構、不必裝 2.0 處理程序。這對某些情況確實可行,但別忘了 2.0 能做 1.0 根本做不到的事,也補上了 1.0 的許多結構性缺陷。
優點:
缺點:
上面的選項刻意寫得立場分明,實務上完全可以混合。例如:用選項 1 與 2 的思維擬定長遠藍圖,再用選項 4 的「先改再說」手法落地執行。又或者,如果你對現有的模組切分不滿意,可以先依功能重新整理所有模組,接著再進一步把綁死特定 XSLT 版本的模組拆開,這就同時用到了選項 2 與 3 的精神。
還有一種做法:挑一個最吸引你的特性(例如樣式表函數,詳見第 1 部分),找出程式碼中所有可以用上它的地方,然後決定要把這些部分隔離起來(選項 3),還是徹底重構(選項 1)。
如果你的任務是「從資料儲存中取出資料,加上標籤或格式化後呈現,而且不需要大幅改變結構」,那麼 XQuery 很可能就夠用了。關於 XQuery 1.0 以及它與 XSLT 的比較,可以參考其他相關文章。
除了把你推向某個選項的技術拉力,企業文化同樣是變數。
升級到 2.0 通常是被 1.0 沒有的新特性吸引。你是嗎?如果是,最吸引你的是哪一項?還有哪些好東西是「時機成熟再說」?
企業文化在規劃上做得如何?能承擔多大風險?有沒有人有能力通讀整個程式碼庫、找出共通問題與機會?團隊偏好低成本的小修小補,還是寧可一次做對但成本高?有沒有維護(bug 修正)的資源?修 bug 是主動進行還是事後救火,過去成效如何?
你有時間學新規範嗎?做遷移規劃呢?重新設計樣式表結構呢?相對地,重新撰寫模組又有多少時間?新特性的上線時程有沒有硬性期限?如果無法一次負擔全部升級成本,團隊是要走漸進路線(如選項 3),還是用快速修補應付?
選項 1 對你們來說是否太冒進?反過來說,是否有架構師要求層次分明的樣式表設計,而其他選項都達不到?如果是,那在規劃這種設計時,不妨把 2.0 的擴充特性集一併納入考量。
先確認:樣式表是否需要跑在不同廠商、不同平台,甚至遵循不同 XSLT 版本的處理程序上?
如果你的作業環境裡無法使用支援 BC 的 2.0 處理程序,選項 2 與 3 就直接出局;選項 4 也會大受限制,因為所有修正都必須用 2.0 的方式來做。
這一節提供一些快速排除法。前提是:你得先知道自己最想用 2.0 的哪些具體特性。
回答完企業評估問題、檢視完 2.0 特性清單之後,你就能用本文的決策因素擬出升級的初步計畫。這畢竟只是高層次的策略分析;隨著計畫往下推進,這些問題還是值得回頭再問一次。