DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> XML學習教程 >> XML詳解
用 XQuery 打造 mashup:以圖書館新書搜尋為例
編輯:XML詳解     

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 的優勢

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. 範例應用程式架構

嵌入 XQuery 引擎

用一個簡單的 Java servlet 就能把 XQuery 引擎嵌進來。市面上的引擎選擇不少,商用與開源皆有,本範例採用開源的 Saxon 8.7。

清單 1. 嵌入 Saxon XQuery 引擎

Configuration config = new Configuration();
staticQueryContext = new StaticQueryContext(config);
dynamicQueryContext = new DynamicQueryContext(config);

準備 XML 資料與格式

收集 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 應用,您會發現擴充網站變得相對簡單而敏捷,能更快貼近業務目標。

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