在 sparks.com,我們運用 XML 來標準化各系統之間的資料表示——從 Java 物件到 HTML 資料顯示,無所不包。特別值得一提的是,我們發現只要以非常基本的 XML 結構來實作標準化,資料的共享與操作便會容易許多。在這個過程中,我們累積了不少運用 XML 的實用心得,以下詳細說明我們目前的應用方式。
在使用 XML 之前,第一步是建立一套與你要處理的資訊相契合的 XML 資料格式。
從資料庫產生 HTML 早已不是新鮮事,但從資料庫產生 XML 卻頗為新穎。以下說明具體的產生步驟。
XSL(可擴展樣式表語言)是定義 XML 資料顯示格式的絕佳方式,若能寫成幾個靜態樣板,效果會更好。
XML 加上 XSL,就等於 HTML。這聽起來似乎不合邏輯,但用戶眼前所見的 HTML 頁面,其實正是 XML 與 XSL 共同作用的成果。
XML 的能力源自它的靈活性。然而不幸的是,它有時靈活到讓人望著空白頁面發愁,不知從何下手。
在任何 XML 專案中,第一步都是建立標準化的資料格式。為此,你得先做出以下決定:
確定資料範圍
由於沒有標準的 XML 格式,開發者可以自由地設計自己的格式。然而,如果你的格式只能被單一應用程式辨識,那麼你只能執行該程式來使用它;若還有其他程式也能讀懂你的 XML 格式,那顯然會有幫助。當某個 XML 格式被修改時,使用它的系統可能也得跟著改動,因此你應該建立盡可能完整的格式。由於大多數系統會忽略它們無法辨識的標籤,所以改動 XML 格式最安全的做法是「新增」標籤,而非「修改」既有標籤。
在 sparks.com,我們盤點了不同產品展示所需的所有產品資料。儘管並非每個頁面都會用到全部資料,我們仍據此開發出一套適用於所有資料的完整 XML 格式。舉例來說,產品明細頁顯示的資料比產品瀏覽頁多,但這兩種情況我們仍採用相同的資料格式,因為每個頁面的 XSL 樣板只取用其所需的欄位。
是否使用 DTD
在 sparks.com,我們採用「格式良好」的 XML,而非僅「語法正確」的 XML,因為前者不需要 DTD。DTD 會在用戶點擊與看見頁面之間多加一層處理,而我們發現這一層太過耗費運算資源。當然,在以 XML 格式與其他公司溝通時,DTD 仍相當實用,因為它能確保資料在傳送與接收時結構正確。
選擇解析引擎
如今可用的解析引擎有好幾個,選哪一個幾乎完全取決於你的應用需求。若你決定使用 DTD,那麼該引擎必須能依 DTD 驗證你的 XML;你也可以把驗證獨立到另一個程序中,但那樣會拖累效能。
SAX 與 DOM 是兩種基本的解析模型。SAX 以事件為基礎,在 XML 被解析時把事件發送給引擎,接著讓事件與輸出檔同步;DOM 解析引擎則會為動態 XML 資料與 XSL 樣式表建立層級樹狀結構,透過隨機存取 DOM 樹來提供 XML 資料,就像由 XSL 樣式表來決定呈現方式那樣。關於 SAX 的爭論,主要集中在它是否能降低 DOM 結構的記憶體過度消耗、縮短 XSL 樣式表的解析時間等方面。
然而,我們發現許多採用 SAX 的系統並未充分發揮其能力,反而用它來建立 DOM 結構,再透過 DOM 發送事件。這種做法在進行任何 XML 處理之前,都得先從樣式表建立 DOM,效能自然下滑。
建立好 XML 格式後,我們需要一種能把它從資料庫中動態移植出來的方法。
產生 XML 文檔相對簡單,因為它只需要一個能處理字串的系統即可。我們建立了一套由 Java servlet、Enterprise JavaBean server、JDBC 與 RDBMS(關聯式資料庫管理系統)組成的系統,其運作流程如下:
產生 XML 的範例
在 Java 中建立 XML 文檔字串的實際代碼,可以拆分成幾個方法與類別。啟動 XML 產生程序的代碼放在 EJB 方法裡,這個執行個體會立刻建立一個 StringBuffer,用來存放產生的 XML 字串。
stringbuffer xml = new stringbuffer();
xml.append(xmlutils.begindocument("/browse_find/browse.xsl", "browse", request));
xml.append(product.toxml());
xml.append(xmlutils.enddocument("browse");
out.print(xml.tostring());
後面三個 xml.append() 的參數,本身就是對其他方法的呼叫。
產生文件標頭
第一個 append 方法呼叫 xmlutils 類別來產生 XML 標頭,其 Java servlet 代碼如下:
public static string begindocument(string stylesheet, string page)
{
stringbuffer xml = new stringbuffer();
xml.append( "<?xml version=\"1.0\"?>\n")
.append( "<?xml-stylesheet href=\"")
.append(stylesheet).append( "\"")
.append( " type =\"text/xsl\"?>\n");
xml.append( "<").append(page).append(">\n");
return xml.tostring();
}
這段代碼產生了 XML 標頭:<?xml?> 標籤把本檔定義為支援 1.0 版的 XML 檔;第二行代碼指向用以顯示資料的正確樣式表位置;最後納入的是頂層標籤(本例為 <browse>)。在檔案結尾,只需關閉 <browse> 標籤即可。產生的標頭如下:
<?xml version="1.0"?> <?xml-stylesheet href="/browse_find/browse.xsl" type="text/xsl"?> <browse>
填入產品資訊
完成標頭後,控制方法會呼叫 Java 物件來產生它的 XML,本例呼叫的是 product 物件。product 物件用兩個方法來產生它的 XML 表示:第一個方法 toxml() 透過產生 <product> 與 </product> 標籤來建立 product 節點,接著呼叫 internalxml() 提供產品 XML 所需的內容。internalXML() 是一連串的 stringbuffer.append() 呼叫,最後把 StringBuffer 轉成字串回傳給控制方法。
public string toXML()
{
stringbuffer xml = new stringbuffer( "<product>\n");
xml.append(internalXML());
xml.append( "</product>\n");
return xml.tostring();
}
public string internalXML()
{
stringbuffer xml = new
stringbuffer( "\t")
.append(producttype).append( "\n");
xml.append( "\t").append(idvalue.trim())
.append( "\n");
xml.append( "\t").append(idname.trim())
.append( "\n");
xml.append( "\t").append(page.trim())
.append( "\n");
庅?
xml.append( "\t").append(amount).append("\n");
xml.append( "\t").append(vendor).append("\n");
xml.append( "\t\n");
xml.append( "\t").append(pubdesc).append("\n");
xml.append( "\t").append(vendesc).append("\n");
庅?
return xml.tostring();
}
關閉文件
最後,xmlutils.enddocument() 方法被呼叫,用以關閉 XML 標籤(本例為 </browse>),並最終完成整份架構好的 XML 檔。控制方法的整個 StringBuffer 也被轉成字串,回傳給最初處理該 HTTP 請求的 servlet。
為了得到 HTML 輸出,我們把產生的 XML 檔與控制 XML 資料如何呈現的 XSL 樣板結合起來。我們的 XSL 樣板由精心編排的 XSL 與 HTML 標籤組成。
開始建立樣板
我們的 XSL 樣板開頭與下面這段代碼類似:第一行是必要代碼,把本檔定義為 XSL 樣式表,其中 xmlns:xsl 屬性引用本檔所使用的 XML 名稱空間,version 屬性則定義名稱空間的版本號,檔案結尾再關閉標籤。由 <xsl:template> 開始的第二行代碼確定了 XSL 樣板的模式,match 屬性是必填的,此處指向 XML 標籤 <basketpage>;在我們的系統裡,<basketpage> 標籤內含 <product> 標籤,這讓 XSL 樣板得以存取嵌在 <product> 標籤內的產品資訊,最後同樣要在檔案結尾關閉 <xsl:template> 標籤。
接下來看看格式良好的 HTML。由於它將被 XML 解析引擎處理,因此必須符合格式良好 XML 的所有規則——基本上,這意味著所有開始標籤都必須有對應的結束標籤,例如通常不被關閉的 <p> 標籤,也必須用 </p> 關閉。
<xsl:stylesheet xmlns:xsl="https://www.w3.org/1999/xsl/transform" version="1.0"> <xsl:template match="basketpage"> <html> <head> <title>shopping bag / adjust quantity</title> </head> <body bgcolor="#cccc99" background="fixed" link="#990000" vlink="#990000"> <br> <br> </xsl:template> </xsl:stylesheet>
在樣板主體內,有許多 XSL 標籤被用來為資料呈現提供邏輯。以下說明兩個常用的標籤。
choose
<xsl:choose> 標籤類似於傳統程式語言中 if-then-else 結構的開頭。在 XSL 中,choose 標籤表示:在代碼進入的區塊中,條件成立時將觸發對應動作。帶有 test 屬性的 <xsl:when> 標籤緊跟在 choose 之後,若條件成立,位於 <xsl:when> 開始與結束標籤之間的內容便會被採用;若條件不成立,則採用 <xsl:otherwise> 之間的內容,整個區塊最後以 </xsl:choose> 收尾。
在本例中,when 標籤會檢查 XML 的 quantity 標籤:若該標籤含有值為真的 error 屬性,quantity 標籤便會顯示下列表格單元中的內容;若屬性值不為真,XSL 則顯示 otherwise 標籤之間的內容——本例中若 error 屬性不為真,則什麼都不顯示。
<xsl:choose> <xsl:when test="quantity[@error='true']"> <td bgcolor="#ffffff"><img height="1" width="1" src="/files/uploadimg/20090204/0929110.gif"/></td> <td valign="top" bgcolor="#ffffff" colspan="2"><font face="verdana, arial" size="1" color="#cc3300"><b>*not enough in stock. your quantity was adjusted accordingly.</b></font></td> </xsl:when> <xsl:otherwise> </xsl:otherwise> </xsl:choose>
for-each
<xsl:for-each> 標籤可用來對相似 XML 資料的多種情況套用同一個樣式表。對我們而言,可以從資料庫取出一系列產品資訊,並在網頁上進行統一格式化,例子如下:
<xsl:for-each select="package"> <xsl:apply-templates select="product"/> </xsl:for-each>
for-each 迴圈在程式遇到 <package> 標籤時開始,並在遇到 </package> 標籤時結束。一旦迴圈啟動,每次 <package> 標籤出現時,都會套用這個樣板。
總有一天,瀏覽器將內建 XML 解析引擎。到那時,你可以直接把 XML 與 XSL 檔傳給瀏覽器,由瀏覽器依樣式表中列出的規則顯示 XML 資料。不過在此之前,開發者仍得在伺服器端建立解析功能。
在 sparks.com,我們已在 Java servlet 中整合了一個 XML 解析器,它使用一種稱為 XSLT(XSL transformation)的機制,依 XSL 標籤的指示把 XML 資料填入 XSL 樣板。
當我們的 Java servlet 處理 HTTP 請求時,servlet 會取出動態產生的 XML,再把它傳給解析引擎。根據 XML 檔中的指令,解析引擎會找出對應的 XSL 樣式表,透過 DOM 結構建立 HTML 檔,然後把這個檔案傳送給發出 HTTP 請求的用戶。
若你選擇採用 SAX 模型,解析器會通讀 XML 源程式,為每個 XML 標籤建立一個事件;事件與 XML 資料相互對應,最終依 XSL 標籤把資料插入樣式表。