DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> JavaScript入門知識 >> AJAX入門 >> AJAX詳解
用 Ajax 呼叫 SOAP Web 服務(二):WS.Call、WS.Handler 與 WS.Binder
編輯:AJAX詳解     

WS.Call 的三個方法

  • add_handler:向處理鏈加入請求/回應處理器。處理器物件會在呼叫 Web 服務的前後被呼叫,以支援可擴充的前置與後置處理。
  • invoke:把指定的 SOAP.Envelope 送到 Web 服務,收到回應後呼叫回呼函式。適用於使用文字 XML 編碼的「文件樣式」服務。
  • invoke_rpc:建立一個封裝 RPC 樣式請求的 SOAP.Envelope 並送出,收到回應後呼叫回呼函式。

一般情況下,WS.Call 只是 XMLHttpRequest 之上的一層薄包裝,負責一些簡化處理,例如設定 SOAP 1.1 規範要求的 SOAPAction HTTP 標頭。

使用 ws.js

這個函式庫的 API 相當直覺。SOAP.* 物件(SOAP.Element、SOAP.Envelope、SOAP.Header、SOAP.Body)提供建構與讀取 SOAP 信封的方法,把底層 XML DOM 的細節順利抽象掉。

以下片段示範組出一個 SOAP 信封:

var envelope = new SOAP.Envelope();
var body = envelope.create_body();
var el = body.create_child(new WS.QName('method', 'urn:foo'));
el.create_child(new WS.QName('param', 'urn:foo')).set_value('bar');

產生的 SOAP 信封大致如下:

<envelope xmlns="https://schemas.xmlsoap.org">
  <body>
    <method xmlns="urn:foo">
      <param>bar</param>
    </method>
  </body>
</envelope>

RPC 樣式請求

若 SOAP 信封代表一個 RPC 樣式請求,SOAP.Body 提供了一個便利方法 set_rpc,能一次組出完整的 RPC 請求,包含操作名稱、輸入參數陣列與 SOAP 編碼樣式 URI:

var envelope = new SOAP.Envelope();
var body = envelope.create_body();
body.set_rpc(
  new WS.QName('param', 'urn:foo'),
  new Array(
    { name: 'param', value: 'bar' }
  ),
  SOAP.NOENCODING
);

每個參數都作為一個 JavaScript 物件結構傳遞,可帶有以下屬性:

  • name:指定參數名稱的字串或 WS.QName 物件。必要。
  • value:參數的值。若該值不是簡單資料型別(例如字串、整數),就應該指定一個能把值序列化成適當 XML 結構的 WS.Binder。必要。
  • xsitype:標識參數的 XML 結構描述執行個體型別的 WS.QName,例如 xsi:type="int" 對應 new WS.QName('int', 'https://www.w3.org/2000/10/XMLSchema')。選填。
  • encodingstyle:標識參數所用 SOAP 編碼樣式的 URI。選填。
  • binder:能把參數序列化為 XML 的 WS.Binder 實作。選填。

舉例來說,若參數名為「abc」、命名空間為「urn:foo」、xsi:type 為「int」、值為「3」,寫法就是:

new Array({
  name: new WS.QName('abc', 'urn:foo'),
  value: 3,
  xsitype: new WS.QName('int', 'https://www.w3.org/2000/10/XMLSchema')
})

實際呼叫

組好 SOAP.Envelope 後,把它傳進 WS.Call 的 invoke 方法即可呼叫信封內編碼的方法:

(new WS.Call(service_uri)).invoke(envelope, callback);

另一條路是手動組信封,把參數 WS.QName、參數陣列與編碼樣式傳給 invoke_rpc:

var call = new WS.Call(serviceURI);
var nsuri = 'urn:foo';
var qn_op = new WS.QName('method', nsuri);
var qn_op_resp = new WS.QName('methodResponse', nsuri);

call.invoke_rpc(
  qn_op,
  new Array(
    { name: 'param', value: 'bar' }
  ),
  SOAP.NOENCODING,
  function(call, envelope) {
    // envelope 是回應的 SOAP.Envelope
    // 回應的 XML 文字在 arguments[2]
  }
);

呼叫 invoke 或 invoke_rpc 時,WS.Call 會建立一個基本的 XMLHttpRequest 物件、傳入含 SOAP 信封的 XML 元素、接收並解析回應,然後呼叫你提供的回呼函式。

WS.Handler:前處理與後處理

為了擴充 SOAP 訊息的前置與後置處理,WS.Call 允許註冊一組 WS.Handler 物件。對於呼叫週期內的每個請求、每個回應與每個錯誤,都會呼叫這些物件。新的處理器只要繼承 WS.Handler 即可:

var MyHandler = Class.create();
MyHandler.prototype = (new WS.Handler()).extend({
  on_request : function(envelope) {
    // 前置處理
  },
  on_response : function(call, envelope) {
    // 回應後、回呼前的處理
  },
  on_error : function(call, envelope) {
  }
});

var call = new WS.Call(...);
call.add_handler(new MyHandler());

處理器最適合插入或取出正在傳遞的 SOAP 信封中的資訊。舉例來說,你可以設想一個處理器自動把適當的 Web 服務定址(WS-Addressing)元素插進 SOAP Header:

var WSAddressingHandler = Class.create();
WSAddressingHandler.prototype = (new WS.Handler()).extend({
  on_request : function(call, envelope) {
    envelope.create_header().create_child(
      new WS.QName('Action', 'https://ws-addressing', 'wsa')
    ).set_value('https://www.example.com');
  }
});

WS.Binder:自訂序列化

WS.Binder 負責 SOAP.Element 物件的自訂序列化與反序列化,實作時必須提供兩個方法:

  • to_soap_element:把 JavaScript 物件序列化為 SOAP.Element。第一個參數是要序列化的值,第二個參數是目標 SOAP.Element。此方法不傳回任何值。
  • to_value_object:把 SOAP.Element 反序列化為 JavaScript 物件,必須傳回反序列化後的值物件。
var MyBinding = Class.create();
MyBinding.prototype = (new WS.Binding()).extend({
  to_soap_element : function(value, element) {
    ...
  },
  to_value_object : function(element) {
    ...
  }
});
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved