DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> XML學習教程 >> XML詳解
用 XSLT 處理 WSDL:從資料抽取到 RDF 轉換
編輯:XML詳解     

IBM、微軟與 Ariba 於 9 月完成的 Web 服務描述語言(WSDL)1.0 規範,其實只是整波 Web 服務架構努力的開場。由 130 家公司共同支持的通用描述、發現與整合(UDDI)倡議,才是更底層的地基。隨著時間推移, implementations 開始冒出:從 IBM 範圍廣泛的 AlphaWorks 工具,到微軟的 .NET 策略。這些工具多半先在更大的框架中登場,並與該框架緊密耦合。

但你其實不必等整合好的 WSDL 工具問世。只要有 W3C 的通用工具 XSLT——擴展樣式表轉換語言——WSDL 就能做很多事。XSLT 無疑是 W3C 最成功的成果之一,市面上已有三十多個獨立或內嵌的實作。閱讀本文前,建議你對 XSLT 與資源描述框架(RDF)已有基本認識。

XSLT 作為探測工具

從資深工程師到疲於奔命的網站管理員,都愛用這個新的 XML 關鍵字來測試各種 XML 處理流程。規範的墨跡未乾,Eric van der Vlist 就用 XSLT 把 XML 片段塞進原本渾然不知的解析器裡;Rick Jiffe 以 XSLT 驅動的 Schematron,提供了一套驗證大量使用名稱空間的 XML 詞彙的方法——而當時 XML Schema 的進度還相當落後。沿著這個思路,本文也將 XSLT 當成探針,實際剖開一份 WSDL 文件來看。

從 WSDL 中抽取資料

Web 服務白頁與黃頁的開發者,以及服務供應商本身,往往需要在各種報表與目錄格式中呈現 WSDL 描述裡的資料。這正是 XSLT 最擅長的資料抽取與報表場景。

在第一篇 WSDL 文章中,我們給過一個範例:某項服務用來查詢認可特定產品的職業滑雪者,請求與回應皆以 SOAP 傳輸。清單 1 的樣式表把描述中宣告的可用服務整理成一張簡潔的表格,同時抽出各服務的傳送方式與位址。

即使只是這麼單純的用途,轉換過程仍不算簡單,複雜度有一部分來自 WSDL 1.0 本身的設計:關聯性是以限定名稱(QName)形式的屬性值來表達的,而 XSLT 1.0 並未提供處理「名稱空間範圍之外之名稱空間」的工具。這在 XSLT 社群中被廣泛討論,並列為 XSLT 1.1 的熱門候選功能,畢竟 WSDL、XML Schema 乃至 XSLT 自身,都在內容中大量使用限定名稱。有了這些設施,清單 1 會精簡許多。

清單 1 的模板 1.1 先架好 HTML 骨架,接著是幾個使用鍵(key)的查詢表。並非所有鍵都在後續實際用到,但表 1.1 至 1.4 完整展示了基本模式:鍵收集代表 WSDL 頂層組件的元素節點,並以其 name 元素作為索引。

查詢表 1.5 更值得留意。後面的轉換要列出每個連接埠(port)綁定時所指定的傳送方式,而 WSDL 把這項資訊放在本地名稱為 binding 的元素中。查詢表 1.5 就負責把每個 WSDL 綁定元素捕進索引裡。

模板 1.2 為每個 WSDL 服務元素輸出一張表,內容大多是普通的 XSLT。它採用「拉取」模型(顯式迴圈搭配 XPath 取值),而非「推送」模型(模板比對),因為在這個場景下直接動手剪裁資料更為直觀。中央迴圈為服務元素中的每個連接埠輸出一列;在標籤之後,再從本地名稱為 address 的元素取出 location 屬性。這裡刻意只比對本地名稱,因為 WSDL 定義了兩種 address 元素——一種用於 SOAP,另一種用於 HTTP——同時也讓樣式表能容忍若干擴充。

接著是傳送資訊,透過 binding-uri 與 binding-local-name 兩個變數取得,兩者都在 xsl:for-each 中定義。前面提到「屬性中的限定名稱」是什麼意思,看 binding-local-name 的定義就明白了:要讓連接埠的 binding 屬性值能對上相應的 WSDL 綁定元素,必須先剝掉名稱空間前綴,這一步由 substring-after() 完成。

binding-uri 則拿 binding-local-name 當索引去查 1.5 表,而該表把每個綁定名稱映射到對應的傳送專用綁定元素名稱空間 URL。在我們的範例中,binding-uri 最終會是 SOAP 的 URI:https://schemas.XMLsoap.org/wsdl/soap/。回到表格的第三欄,binding-uri 又被當成索引去查另一張表,把名稱空間 URI 換成人類可讀的描述字串,例如「SOAP」。

查詢表 1.6 值得細看,因為它用到了較進階的 XSLT 技巧:在樣式表中自行建構查詢表。你可以在鍵的下方看到 x:ns-to-binding 元素。熟悉鍵的人知道,鍵定義索引,而這些索引會在與 match 屬性模式相符的來源節點上建立。較少人知道的是:每次用 XSLT 的 document() 函式載入額外來源文件時,所有鍵都會一併套用。因此,在變換結束標籤之前,那段 xsl:variable 以特殊的 document() 呼叫形式,把樣式表本身當成附加來源文件載入,於是樣式表中與 ns-to-binding 相符的節點也就被索引起來了。對於那些不想改動來源文件、也不想依賴外部檔案就能建立查詢表的場合,這是相當好用的一招。

在 Unix 命令列上,用 4XSLT 套用這個變換:

[uogbuji@borgia wsdlxslt]$ 4xslt
https://uche.ogbuji.Net/articles/wsdl/endorsementservice.XML
https://uche.ogbuji.Net/articles/wsdl/wsdlservicesummary.xslt

原始的 WSDL 文件與清單 1 的樣式表都已放上網路,細節請見「參考資料」。圖 1 是變換後的瀏覽器檢視畫面。

圖 1. 套用清單 1 樣式表後的瀏覽器檢視

如何擴充這份樣式表以抽取訊息區塊等更多資訊,應該不難想像。下一節我們來看一個更複雜、著眼點也不同的用法。

從 WSDL 產生 RDF

先前談 WSDL 的文章中提過 WSDL 可能的 RDF 形式。WSDL 的全部內容都繞著「描述」打轉,因此我們認為 RDF 是它的理想載體;而 RDF 夠靈活,要設計出一個與 WSDL 原始格式差異不大的 RDF 相容形式並非難事。接下來,就是把這個轉換自動化。

清單 2 的樣式表,能把第一篇文章中的 WSDL 範例轉成第二篇給出的 RDF 版本。

首先要指出兩份樣式表的性格差異:清單 1 大量使用「拉取」模型(以 xsl:for-each 為骨幹)來逐一列出服務中的連接埠;清單 2 則幾乎全靠「推送」技術,由一堆挑選得當的匹配與模式組出執行路徑。多數 XSLT 新手比較習慣拉取式寫法,因為對熟悉程序模型(例如 ECMAScript)的人來說它更自然。相對地,這份樣式表需要多花一點時間才能讀懂,但對於「把一種 XML 格式轉成另一種、結構不完全對應」這類調整,它其實是很好的通用骨架。

模板 2.1 開場:用 xsl:copy 複製 wsdl:description 元素,第一個 xsl:apply-templates 複製它的屬性。第二個 xsl:apply-templates 試著複製子元素,但特別值得注意的是它沒有指定模式。往下看就會發現,wsdl:types 由模板 2.7 承接,該模板會遞迴地把它底下的子樹原封不動複製過去;而一旦遇到 wsdl:description 的其他子代,情況就變了——wsdl:message 命中模板 2.4,那是一個刻意留白的程序。目前的淨效果是:除了 wsdl:types,其餘 WSDL 子代元素全被抑制。

第三個 xsl:apply-templates 做類似的事,但指定了 convert-to-rdf 模式。處理器再次遇到 wsdl:types,這回它命中另一個同樣空白的模板 2.6;至於其他頂層 WSDL 元素,則由模板 2.2 接手,開始往 RDF 靠攏。輸出結果按需求包在 rdf:RDF 元素之中。

變換的其餘部分基本是這些機制的延伸。還記得上一篇文章提過的做法嗎:為頂層子代加上從原 name 取得的 rdf:ID 屬性,就完成了向 RDF 的轉化。模板 2.2 以 xsl:attribute 實現這一點。另外別忘了,每個頂層 WSDL 元素的屬性都必須補上顯示用的名稱空間,這由以 convert-to-rdf 模式匹配屬性的模板 2.5 處理;它同樣用上了前面那招「把樣式表當來源文件載入」的查詢表技巧,將名稱空間 URI 映射成輸出時使用的前綴。

如模板 2.3 與 2.4 所示,頂層元素子節點的處理方式略有差異,這是為了配合我們在 RDF 表示上所做的簡化,例如把 wsdl:message/wsdl:part 當成匿名資源,以及把 @message 屬性轉成 rdf:resource 屬性。

同樣透過 4XSLT 執行,這份樣式表的輸出與上一篇文章的 RDF 版本十分接近。即使你對 RDF 形式的 WSDL 沒興趣,這份樣式表也能當作各種 WSDL 調整工作的起點框架。

結語

WSDL 的本質其實非常單純:一份線上服務的描述。但憑藉 UDDI 打下的基礎,它註定會被用在各種應用場景上。Rich Site Summary(RSS)就是「簡單格式也能大鳴大放」的最佳例證。本文示範的幾種手法,說明了 XSLT 變換在處理 WSDL 時的可行路徑。

清單 1 適合簡單的線上報表與編目,尤其是你需要快速微調輸出的時候——此時輸入與輸出的結構相似之處不多,只挑出需要的材料另行組裝反而合理。清單 2 的推送式做法則適合那些與 WSDL 共享同一結構基礎的轉換:例如想檢視去掉後綴的 WSDL,或在 API 摘要的各個層級抽取文件元素,甚至把 WSDL 的關聯重寫成 XLink。這些連結可能是文件內部的,也可能在使用 WSDL 匯入器拆解描述時變成外部連結;再進一步,把它們當成擴展機制,指向 WSDL 匯入設施之外的資源。真要動手,那樣的樣式表與清單 2 不會相差太遠。

希望本系列文章不只是 WSDL 的入門介紹,也留下了幾件趁手的工具,讓你能用手上現成的 XML 技術開始處理這個格式。隨著 WSDL、UDDI 及相關技術逐漸成熟並彼此聚合,會浮現一批善用這些應用的核心服務供應商。總有一天,那個「無縫整合 Web 服務」的願望,會因此離現實更近一步。

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