Web 2.0 應用為使用者帶來更動態的體驗,其底層往往就是 Ajax(Asynchronous JavaScript and XML)。主 HTML 文件載入之後,Ajax 能在不重整整個頁面的前提下更新內容。換個角度想,Web 內容因此變成一塊塊可以隨時取用的資料片段,而客戶端的 JavaScript 完全能自行決定呈現方式——純文字、XML、JSON 物件,或 HTML 片段皆可。
新的開發典範早已超出傳統的「模型—視圖—控制器」框架。諷刺的是,像 Direct Web Remoting(DWR)與 JavaServer Faces(JSF)這類 Ajax 框架本身也帶來難題:它們雖然在多個層面簡化了開發,卻也或多或少掌控了 Web 內容的呈現方式。許多現有框架並未提供統一方案來面對真實世界的複雜性,尤其是來自 XML 的資料整合,以及來自 RSS feed 的內容聯播——這些需求日益升高,也意味著伺服器端需要更高效的 Web 服務支援。
要接上這些變化,可以打造 mashup 應用,把 Web 內容、XML 資料與 Web 服務結合起來。本文示範如何用 XQuery(一項在 Web 服務領域頗具前景的技術)搭配 XML 來完成這件事。
案例場景是這樣的:某個由數家地方圖書館組成的公共圖書館系統,各館管理員會定期採購新書,卻不確定其他館是否已經買過同樣的書。這個應用透過 Web 服務發布並共享各館的馆藏資訊,把新書資料匯集起來,讓使用者能一次搜尋整個系統的新書。
XQuery 是 W3C 的標準,專為從 XML 文件中擷取資訊而設計。相較於 Java DOM API 這類既有的物件導向處理模型,它在 XML 處理上有幾項明顯優勢。
伺服器端 XML 處理更單純
雖然可以透過 JavaScript 使用 DOM API 解析 XML,但這不表示所有 XML 處理都該搬到客戶端——尤其當業務邏輯日益複雜時。如何拿捏客戶端與伺服器端的分工,是設計 Web 應用的一項基本課題。XQuery 把複雜邏輯留在伺服器端,好處不少:安全性更容易全面兼顧,應用程式也更好維護,而 XQuery 函式本身又進一步簡化了開發流程。
控制網路傳輸量
設計時必須權衡有多少內容在網路上往返、頻率有多高。每一次伺服器請求都有成本,因此絕對要避免讓每次按鍵或滑鼠移動都觸發一次非同步呼叫;否則不必要的流量與負載,足以讓應用程式癱瘓。舉例來說,56K 撥接連線傳輸 100KB 的內容約需 14 秒。XQuery 能藉由精簡傳輸內容改善體驗——例如若要限制 XML 的大小,可在回傳前呼叫標準的 string-length() 函式。本範例採取另一種做法:以節點計數把結果上限設為 100 筆 book 項目。
多條件查詢整合
Web 搜尋常需要多個條件並用。這個範例應用提供三個欄位,使用者可以填其中一項,也可以最多三項組合。XQuery 函式與 XPath 表達式的搭配,正好提供了實作這類查詢所需的表達力。
業務邏輯不必另外寫程式
XQuery 是宣告式語言,能以緊湊的方式把業務邏輯封裝在查詢裡,藉此整合既有的 XML 資料與服務。查詢輸出還能指定格式,因此實作業務規則時往往不需要額外寫一層程式。
圖 1 呈現了應用程式的設計。伺服器回應的格式由客戶端決定,可以是 HTML 片段、XML、純文字或 JSON 物件。內嵌的 XQuery 依據動態的搜尋條件執行預先定義好的查詢,業務邏輯與呈現邏輯都寫在查詢之中。XML 資料來源則可以多元——檔案系統、資料庫,或代表 REST Web 服務的 URI。
圖 1. 範例應用程式架構
用一個簡單的 Java servlet 就能把 XQuery 引擎嵌進來。市面上的引擎選擇不少,商用與開源皆有,本範例採用開源的 Saxon 8.7。
清單 1. 嵌入 Saxon XQuery 引擎
Configuration config = new Configuration();
staticQueryContext = new StaticQueryContext(config);
dynamicQueryContext = new DynamicQueryContext(config);
收集 XML 資料前,得先想清楚:資料從哪裡來、是否需要 DTD 或 schema、要不要做 XML 驗證。本程式為資料格式定義了一份 DTD,並假設所有資料來源在交給 XQuery 處理前都已是符合該 DTD 的 XML 文件。清單 2 是資料格式的示例。
清單 2. XML 資料格式範例
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE library SYSTEM "dtd/book.dtd">
<booklist>
<book category="COOKING">
<title lang="en">Everyday Italian</title>
<authors>
<author>Giada De Laurentiis</author>
</authors>
<isbn></isbn>
<numberCopies>1</numberCopies>
<status>On Shelf</status>
<year>2005</year>
<library>John C. Hart Library</library>
<price>30.00</price>
</book>
...
</booklist>
三個搜尋欄位意味著六種查詢組合,還得再加上「完全沒輸入條件」的預設情境。與傳統 Web 框架不同,XQuery 把這些分支邏輯直接寫在查詢檔裡,好處是日後調整不必停機——例如想把結果改成「只找近三年出版的新書」,直接改檔即可。
XML 資料可以來自多處。book_collection.xml 定義了一個 XML 資料集合,其中一個來源就是應用程式本身:https://localhost:9080/bookinfor/newbooks_localhost.xml。測試時務必確認 Web 應用程式的 context root 設定正確(此例為 bookinfor)。清單 3 是該集合文件。
清單 3. XQuery 集合
<collection>
<doc href="newbooks_library_01.xml"/>
<doc href="newbooks_library_02.xml"/>
<doc href="newbooks_library_03.xml"/>
<doc href="newbooks_library_04.xml"/>
<doc href="https://localhost:9080/bookinfor/newbooks_localhost.xml"/>
</collection>
設計這類應用時,效能必須納入考量,因此本範例把輸出上限設為 100 筆。相較於 Java 這類物件導向實作,XQuery 在伺服器端幾乎不需要額外開發就能完成業務邏輯。當 XML 資料量龐大時,可以把內嵌的 XQuery 引擎與 IBM DB2 Viper 搭配使用,後者能處理最大可達 2GB 的 XML 內容。清單 4 是 booklist_app.xql 中的業務邏輯。
清單 4. 含簡單業務邏輯的 XQuery
(: -------------------------- :)
(: declares ...... :)
(: -------------------------- :)
declare namespace local = "https://localhost/ns";
declare variable $title as xs:string external;
declare variable $author as xs:string external;
declare variable $year as xs:string external;
declare variable $emptymsg as xs:string external;
declare variable $oversizedmsg as xs:string external;
declare variable $outputformat as xs:string external;
(: -------------------------- :)
(: functions :)
(: -------------------------- :)
declare function local:error_view($helpmsg as xs:string) {
if($helpmsg) then $helpmsg
else ('<report status="0">Please call 1-800-123-4567</report>')
};
declare function local:html_view($doc) {
<table>
<tr>
<td>Library Name</td>
<td>Book Title</td>
<td>Number of Copies</td>
<td>Status</td>
</tr>
{
for $book in $doc/book
where $book/title/@lang = "en"
order by $book/library
return
<tr>
<td>{$book/library}</td>
<td>{$book/title/text()}</td>
<td>{$book/numberCopies}</td>
<td>{$book/status}</td>
</tr>
}
</table>
};
(: -------------------------- :)
(: the business logic :)
(: -------------------------- :)
let $docs := ('bookinfor/book_collection.xml')
let $searchdoc := (
<report status='1'>
{
if($title and $year and $author) then (
for $doc in collection($docs)//booklist/book[contains(title,$title) and (year = $year)]
where contains($doc//authors, $author)
return $doc
)
else if($title and $year) then (
for $doc in collection($docs)//booklist/book[contains(title,$title) and (year = $year)]
order by $doc//booklist/book/title
return ($doc)
)
else if($title and $author) then (
for $doc in collection($docs)//booklist/book[contains(title,$title)]
where contains($doc//authors, $author)
order by $doc//booklist/book/title
return ($doc)
)
else if($author and $year) then (
for $doc in collection($docs)//booklist/book[(year = $year)]
where contains($doc//authors, $author)
order by $doc//booklist/book/title
return ($doc)
)
else if($title) then (
for $doc in collection($docs)//booklist/book[contains(title,$title)]
order by $doc//booklist/book/title
return ($doc)
)
else if($author) then (
for $doc in collection($docs)//booklist/book
where contains($doc//authors, $author)
order by $doc//booklist/book/title
return ($doc)
)
else if($year) then (
for $doc in collection($docs)//booklist/book[(year = $year)]
order by $doc//booklist/book/title
return ($doc)
)
else (
for $doc in collection($docs)
return ($doc//booklist/book)
)
}
</report>
)
(: -------------------------- :)
(: return results :)
(: -------------------------- :)
return
if (count($searchdoc//book) eq 0) then local:error_view($emptymsg)
else if (count($searchdoc//book) gt 100)
then local:error_view($oversizedmsg)
else if ($outputformat eq $html)
then local:html_view($searchdoc)
else $searchdoc
要在內嵌引擎中執行查詢,需先設定參數並預先編譯,執行後再把結果送回 Web 用戶端,由客戶端 JavaScript 組裝並呈現。請注意,本範例把 c:/tmp/xmldatasources/ 設為靜態查詢環境的路徑,因此務必確認其中含有 bookinfor 目錄,並在測試前把 XML 資料檔複製過去。清單 5 是內嵌查詢的呼叫方式。
清單 5. 呼叫 XQuery 查詢
dynamicQueryContext.setParameter("emptymsg", "No results exist!");
dynamicQueryContext.setParameter("oversizedmsg",
"Too many results, please refine queries");
staticQueryContext.setBaseURI("c:/tmp/xmldatasources/");
fileReader = new FileReader(request.getRealPath("/") + "/queries/booklist_app.xql");
queryExpression = staticQueryContext.compileQuery(fileReader);
writer = new StringWriter();
StreamResult result = new StreamResult(writer);
Properties props = new Properties();
queryExpression.run(dynamicQueryContext, result, props);
retContent = writer.getBuffer();
必須承認,XQuery 仍有其限制,學習曲線也不算平緩。沒有任何單一技術能解決所有業務問題,實務上很可能仍需與 XPath、XSLT 等技術搭配使用。
話雖如此,XQuery 的主要特性與能力已引起廣泛關注:強大的 XML 處理力,加上在 mashup 應用上的潛質,都讓它值得投入。一旦以 XQuery 完成動態 Web 應用,您會發現擴充網站變得相對簡單而敏捷,能更快貼近業務目標。