DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> XML學習教程 >> XML詳解
用 XSL-FO 打造可列印文件:以 Java 與 XML 實作可攜式資料庫報表
編輯:XML詳解     

大多數 XML 文件只承載資料,外觀交給應用程式決定;但只要報表需要被列印、被歸檔,格式化資訊立刻變成剛需。本文說明 XSL-FO(XML Stylesheet Language - Formatting Objects)如何把格式化資訊直接寫進 XML 文件本身,並以一個 Java 資料庫報表產生器為例,示範如何省去複雜的 XSLT 樣式表。本文是先前〈以 Java 與 XML 實作可攜式資料庫報表〉的續篇。

格式化物件(FO)的定位

XSL 由兩個主要部分組成:一是用來轉換 XML 文件的語言,也就是 XSLT;二是用來描述格式化語意的 XML 詞彙,也就是 XSL-FO。XSLT 靠樣式表把標記資料變成可讀文件,但需要三個東西才能運作:來源 XML、樣式表、以及處理器。

如果你手上沒有樣式表,也不想維護兩份文件呢?答案就是把格式化資訊寫進文件裡,而這正是 FO 的用途。透過 FO,你可以定義頁面配置、字型風格、顏色、圖形呈現與許多其他設計屬性。難怪翻完四百多頁的 XSL-FO 規範時,多數人會對 W3C 定義的格式化物件數量感到吃驚——它早已不只服務紙本,也向多媒體輸出敞開大門。若不想啃完四百頁,可以改讀 Elliote Rusty Harold 那份六十來頁的摘要。

有意思的是,XSL 規範並未提供官方的 FO 文件 DTD 供驗證使用。所幸 RenderX 提出了一份實驗性的 FO DTD,能作為驗證依據。

什麼時候該用 FO

先把 XML 文件粗分成兩類:一是純粹在應用程式之間傳遞資料的資料文件,二是要給人閱讀的文件。

第一類完全不需要格式化資訊。程式不在乎資料長得好不好看,就連縮排都常被視為多餘。第二類通常在閱讀前先經過樣式表轉換,因此同類文件的外觀會高度一致。但有些時候你偏偏不想用樣式表,因為你希望同一類物件能各自擁有不同外觀——這就是 FO 派上用場的時機。

要手工控制格式,一般人會用文書處理軟體。問題在於各家都有私有格式:在 Windows 上用 Word 寫的文件,拿到 Linux 用 StarOffice 開啟,版面幾乎不可能完全一致。但如果文件本身存成使用 FO 的 XML,那麼不論換到哪個平台、哪套軟體,格式資訊都能保留。這也是 FO 最大的價值:一種文件格式,處處通行。

文書處理器與 XML

AbiWord 是一款輕量、快速、開放原始碼的文書處理器,直接以 XML 儲存文件,並能在 DocBook 與 XSL-FO 子集之間雙向轉換;加上一點外部工具的加工,同一份文件來源就能產出多種輸出格式。另一個以 XML 儲存的例子是 StarWriter,也就是 StarOffice 與 OpenOffice 的文書元件,其 DTD 可在 OpenOffice 網站下載。

FO 看似是儲存文件的理想格式,但它並非唯一選項。DocBook 是 OASIS 推動的文件中 DTD,我自己用它寫過不少技術材料,讀者拿到列印成品時從未察覺背後是 XML。流程是這樣的:先用 Norman Walsh 提供的樣式表產生 FO 文件,再交給 Apache 的 FO 處理器 FOP 轉成 PDF。

有些人認為「在 XML 文件裡塞進格式資訊」違反了 XML 的基本精神。就 XML 作為不受格式干擾的資料交換機制而言,他們說得沒錯;但 FO 屬於另一套技術 XSL,而 XSL 同樣以 XML 表示。把 XSL-FO 看作「專門描述版面配置的一套詞彙」,一切就說得通了。

動手寫一份 FO 文件

下面示範如何直接產出 FO,避開樣式表。FO 文件的根元素固定是 fo:root,真正的開頭應該長這樣:

<?xml version="1.0" encoding="utf-8"?>
<fo:root xmlns:fo="https://www.w3.org/1999/XSL/Format">

一份 FO 文件大致由五個部分組成:XML 宣告與命名空間、頁面配置資訊、頁首與頁尾內容、文件主體內容,以及最後千萬別忘記的封閉標籤。

我很清楚自己的處境:一旦開始寫 XSLT 樣式表來轉換中間文件,這個任務就會變成無底洞。MXReports 後續還有許多升級規劃,也就意味著程式與樣式表都得跟著大改。所以我決定只靠 FOP 直接轉換中間的 FO 文件。

描述頁面配置

在前一篇文章中,我示範了如何從 report.xml 取出頁高、頁寬、頁首高度與頁尾高度等資訊。接著用這些變數組出頁面設定,輸出結果類似:

page-height="297mm"
page-width="210mm"
margin-left="25mm"
margin-right="25mm"
margin-top="27mm"
margin-bottom="20mm">
  ...
  margin-bottom="0mm" />
...

這段設定描述的是標準 A4 頁面(210mm × 297mm)加上指定邊距,而邊距數值來自 XML 報表定義。頁面共有五個區域(regions):region-body、region-before、region-after、region-start 與 region-end,分別對應主體、頁首、頁尾與左右兩側。

圖 2. 頁面配置與各區域位置

整體報表系統的資料流可以參考下圖:資料庫經由 Java 程式讀出,組成 XML,再轉成 FO,最後由 FOP 輸出 PDF。

圖 1. 報表系統架構

隨附的 mxreports.java 收錄了全部範例程式碼,其中 writeHeader() 負責描述頁面配置並把頁首、頁尾定義為靜態物件;writeDetails() 則把報表內容組成一張類 HTML 風格的表格。之所以用表格,是因為細節區域的欄位固定,資料集每筆紀錄都要列印一列——也就是說,報表的列數等於紀錄數,欄數等於細節區域定義的欄位數。話雖如此,一般 FO 文件還是以區塊(block)與行內(inline)物件為主,表格只是其中一種工具。

如果你寫過 HTML 表格,理解 FO 表格會非常快,對照關係如下:

fo:table-and-caption 對應 table 與 caption;fo:table-body 對應 tbody;fo:table-row 對應 tr;fo:table-cell 對應 td。

這裡有個實務上的提醒:如果你打算照本文的方式使用 FOP,請務必明確指定欄寬,不要讓引擎自行推估。

把 FO 變成可讀的成品

FO 文件本身是純 XML,要變成使用者看得懂的東西,目前主要的三條路是 PDF、RTF 與 HTML。

產生 PDF 有 FOP 與 XEP 兩種選擇:FOP 是 Apache XML 專案下的免費開放原始碼工具,XEP 則是 RenderX 的商業產品。想要可再編輯的文件,可以考慮 RTF:我在 FOP 相關討論區看到 Bertrand Delacretaz 開發的 StandaloneConverter,這是一個實驗性的獨立 FO 轉 RTF 轉換器,我成功編譯並執行了它,隨附檔案中就有 currency.fo 轉出的 RTF 版本。它不會保留原始 FO 中指定的邊距,但作為交付可編輯文件的手段相當實用。至於 HTML,由於 FO 文件就是普通 XML,用 Xalan 這類 XSLT 工具轉過去即可。

現在與未來

隨著 XML 越來越普及,我相信幾年內它就會成為文件儲存與分發的標準格式。多數軟體廠商正在改寫產品以支援 XML,其中大部分仍採用私有 XML 格式,但也開始有部分廠商公開自己的 DTD——而公開 DTD 正是要靠 XSLT 達成跨系統相容的前提。

Adobe 的 PDF 已獲全球廣泛支持,用 FOP 產生 PDF 的做法也越來越常見,而 FOP 只吃 XSL-FO 文件。使用的人越多,FO 這套版面描述詞彙自然就被用得越廣。我不認為 XSL-FO 會成為公認的文件撰寫標準,但隨著 DocBook 這類 XML 詞彙普及、Java XSLT 工具随手可得,把 FO 當成輔助技術來用的人只會增加。

結語

本文介紹了 XSL-FO 這套能把格式化資訊寫進 XML 的專門詞彙,說明了以 XML 儲存文件的意義,並示範如何用 Java 產生 FO 文件、如何把它轉成各種可讀格式。這不是一篇完整的 XSL-FO 教程——範例只動用了少數幾個格式化物件,也只展示了他們的一小部分屬性。好消息是,入門所需的時間遠比想像中少;老實說,我在網上搜資料的時間還比搞懂基礎觀念的時間多。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved