2001 年 7 月 9 日,W3C 宣布發布 XML 協定工作小組(WG)的兩份工作草案文件。該工作小組推出了 SOAP 規範 1.2 版與「XML 協定抽象模型」文件的最新版本。
這次 SOAP 規範的更新,釐清了原本含糊不清的內容,也簡化了不同實作之間的互操作性問題,同時還兼顧了對既有實作的向後相容。儘管工作小組在 SOAP 的演進上邁出了積極的一步,但這輪工作重心仍放在「澄清」上。熟悉 SOAP 1.1 版規範的人,看到最新版應該會有似曾相識之感。至於抽象模型文件,其宗旨是提供一套通用術語與概念,供 SOAP 規範的讀者共同使用。雖然它並未給出 SOAP 處理器的具體設計,卻讓大家得以深入了解:規範制定者們心中,SOAP 處理器的各個元件究竟該如何彼此協同運作。
伴隨這些文件的發布,現在似乎正是回顧工作小組近期動態、爭議與決定的好時機。當然,這份概述不可能面面俱到,難免會偏向我个人認為值得關注的面向;因此,我在文末附上更多可供深入參考的連結。
發布會前夕,我們在法國 Dinard 召開了一場由 Cannon 主持的面对面(F2F)會議。正如我們所料,與會所帶來的進展,遠比單靠電子郵件與電話往返來得大得多。其中最鮮明的一項決定,正是關於這套協定的名稱。最終結論是:由於「SOAP」這個縮寫在業界已廣為人知,我們不想把它換成其他相對陌生的詞彙——例如「XML 協定」。既然決定保留 SOAP 這個名字,問題就變成:我們是否還希望 SOAP 繼續代表「Simple Object Access Protocol」?於是大家投票表決,「SOAP」不應再被視為一個縮寫,而就是 SOAP 本身——如今這幾個字母背後,也不再有任何特殊含義。
F2F 會議上更為關鍵的一項決定(從實作者的角度看),是關於 SOAP 處理模型的。在 SOAP 的早期版本中,有一點並不明確:在處理過程中執行 MustUnderstand(MU)檢查時,每個標頭部究竟能否按特定順序被處理,還是說所有 MU 檢查都必須在處理其餘每個標頭部「之前」全部完成。工作小組決定:一個 SOAP 處理節點在處理「任何」標頭部之前,必須先向其他 SOAP 節點展現它已執行完所有的 MU 檢查。因此,若某個實作選擇在 SOAP 訊息流入時就邊收邊處理、並在處理每個標頭部的同時進行 MU 檢查,那麼這個實作就必須支援某種「復原(undo)」的概念。也就是說,一旦處理途中出現 MU 錯誤,先前處理過的標頭部就不該留下任何副作用。用來說明這種「無副作用」處理方式的最佳(雖略顯誇張)例子,見清單 1。
清單 1:流式訊息的無副作用應用
<env:Header xmlns:env="https://www.w3.org/2001/06/soap-envelope">
<c:fireNuke xmlns:c="https://us.gov/potus" env:MustUnderstand="1"/>
<c:getAuthorization xmlns:c="https://us.gov/potus" env:MustUnderstand="1"/>
</env>
從這個例子可以清楚看到:如果我們允許 SOAP 處理器在尚未驗證「getAuthorization 標頭部的語義已被理解」之前,就先處理了「fireNuke」標頭部,那最終恐怕會演變出一些誰都不樂見的結果。
圍繞 MustUnderstand,工作小組還作成另一項關鍵決策:為 MU 出錯訊息制定一套標準化的結構。如此一來,一旦出現未被理解的 MU 標頭部,回傳的錯誤就會遵循某種固定格式,讓這些錯誤更容易被程式化地分析。核心構想是:在 MU 錯誤中設一個定義良好的標頭部,裡頭列出所有未被理解的 MU 標頭部。舉例來說,若上述範例中的 getAuthorization 標頭部未被理解,那麼 MU 錯誤中就該出現類似清單 2 的標頭部。
清單 2:MU 錯誤中的可選標頭部
<env:Header xmlns:env="https://www.w3.org/2001/06/soap-envelope">
<f:Misunderstood qname="c:getAuthorization" xmlns:c="https://us.gov/potus/"
xmlns:f="https://www.w3.org/2001/06/soap-faults">
</env>
近期爭議最大的話題之一,莫過於 SOAPAction HTTP 標頭部。就目前的形式而言,一個普遍(雖非一致)的看法是:它的用途與定義都略嫌含糊。規範僅說它應承載訊息的「意圖」,而且只針對 HTTP 做了定義。至於在其他傳輸協定中該如何處理、如何在協定(HTTP 只是其一)之間搬移 SOAP 訊息,乃至「意圖」究竟是什麼意思(是用來路由?還是指向目標服務?),規範都隻字未提。簡單說,有人想保留它,有人想拿掉它。我們最終擬定兩個建議,並提交給抱持開放態度的 SOAP 社群:
在 F2F 會議中,我們對此進行了非正式投票,結果是 22 票支持、4 票反對——並未達成共識。SOAP 社群本身的立場也真實地反映了工作小組的分歧(同樣未取得一致),因此這個問題依舊懸而未決。
可以預料的是,新版 SOAP 自然也換上了新的名稱空間。目前新的名稱空間為 https://www.w3.org/2001/06/soap-envelope。
多少由於新名稱空間的關係,我們同時也開發了新版的錯誤模型。基本構想是:當一個 SOAP 處理節點收到帶有它並不支援的名稱空間的 SOAP 訊息時,它必須回傳一個使用舊 SOAP 1.1 名稱空間(https://schemas.xmlsoap.org/soap/envelope)的 VersionMismatch 錯誤,並且應附上一個 Upgrade 標頭部,列出它所支援的 SOAP 名稱空間清單。舉例來說,若一個 SOAP 1.2 處理節點收到 SOAP 1.1 訊息、卻因不支援 SOAP 1.1 語義而無法處理,那麼它就該回傳如清單 3 所示的錯誤訊息。
清單 3:SOAP 1.2 與 1.1 請求不匹配的錯誤訊息
<env:Envelope xmlns:env="https://schemas.xmlsoap.org/soap/envelope/">
<env:Header>
<V:Upgrade xmlns:V="https://www.w3.org/2001/06/soap-upgrade">
<envelope qname="ns1:Envelope"
xmlns:ns1="https://www.w3.org/2001/06/soap-envelope"/>
</V:Upgrade>
</env:Header>
<env:Body>
<env:Fault>
<faultcode>env:VersionMismatch</faultcode>
<faultstring>Version Mismatch</faultstring>
</env:Fault>
</env:Body>
</env:Envelope>
近來,「infoset」這個課題也被提了出來。Infoset 是一種機制,讓我們得以跳脫空白、角括號、單雙引號等瑣碎的細節符號,來描述一份 XML 文件。它使我們能對 XML 當中的「實際資料」進行更抽象的討論,而不必糾結於 XML 的特定文字格式。這一機制有個饒富趣味的用途:它讓諸如「擁有更簡潔語法的二進位 XML」這類全新 XML 格式的出現成為可能。在調查 Infoset 及其在 SOAP 規範中可能用途的過程中,Martin Gudgin 依據 XML infoset 重寫了規範的第 4 部分。因此,從 Martin 的成果中擷取片段來看,一個以 Infoset 定義的標頭部元素,其內容可能包含:
請注意,它是如何把焦點放在 XML 當中的「實際資料」,而非資料的特定文字格式上。而在更高的層次——例如定義某種特定傳輸協定上的 SOAP 時——注意力才會轉向 XML 具體呈現形式的那些細節。同樣值得一提的是一項決定:讓 boolean 資料型別接受 0、1、true 與 false(其中「0」是 MU 標頭部中的預設值)。
XML 協定小組目前新設了兩個下屬機構:傳輸綁定任務組(Transport Binding Task Force)與 RPC 任務組(RPC Task Force)。這兩個任務組的首要目標,是敲定 SOAP 規範在各個課題上的語法與語義。傳輸綁定任務組光是「什麼是綁定?」這類最基礎的問題,就已經討論得沸沸扬扬。如果你對其中任何課題感興趣,我建議你翻閱一遍郵件列表文件,並造訪該工作小組的網頁;要我在這裡替如此包羅萬象的選項做總結,恐怕反而會扭曲原意。就姑且假設它涵蓋的觀點相當分歧吧。RPC 任務組則剛剛成立,目前仍處於收集問題的階段。
還有什麼?除了本文提到的問題之外,XML 工作小組面前還擺著不少待解的難題。想取得完整清單,請參閱問題列表;其中一些較為熱門的議題(如 SOAPAction)肯定會讓你躍躍欲試。對於任何對 SOAP 感興趣的人——無論是技術狂熱者還是實作者——我都建議你透過訂閱並加入 XML-dist-app 郵件列表來緊盯工作小組的動態。這個小組有個相當獨特之處:它大概是 W3C 各工作小組中最開放的一個——我們幾乎所有工作都以公開、透明的方式進行,而 SOAP 社群的參與、意見與回饋,正是其工作得以成功的關鍵。
作者聲明:本文提及的任何或全部決策,都應視為工作小組「當下」想法的快照。有大批人殷切期盼工作小組早日完工,因此依據其臨時決策來選擇實作方向,這種心情可以理解;但請注意,工作小組今日所作的決定,日後仍有可能改變。