DIV CSS 佈局教程網

用 JS 呼叫 WebService:手刻 SOAP 封包做身分驗證
編輯:關於JavaScript     

本文分享如何以 JavaScript 拼出 SOAP 封包去呼叫 WebService,並在 SOAP Header 中帶入帳號密碼完成驗證。註解寫得相當完整,直接看程式碼即可。

 <html>
<head>
<title>無標題頁</title>
<script language="javascript" type="text/javascript">
// <![CDATA[
// define
var xmlhttp;
var value = new Array();
var variable = new Array();

// 顯示回應訊息
function handleStateChange() {
  var h = document.getElementById("Label1");
  if (xmlhttp.readyState == 4) {
    if (xmlhttp.status == 200) {
      alert(xmlhttp.responseText);
      h.innerHTML = xmlhttp.responseText;
    } else if (xmlhttp.status == 404) {
      h.innerHTML = "<br>找不到請求的服務器資源!";
    }
  } else if (xmlhttp.readyState == 0) {
    h.innerHTML = "<br>未初始化!";
  } else if (xmlhttp.readyState == 1) {
    h.innerHTML = "<br>正在加載……!";
  } else if (xmlhttp.readyState == 2) {
    h.innerHTML = "<br>已經加載完成!";
  } else if (xmlhttp.readyState == 3) {
    h.innerHTML = "<br>正在和服務器交互";
  } else {
    h.innerHTML = xmlhttp.responseXML;
  }
}

// 取得請求資料的長度
function getlen(str) {
  var bytesCount = 0;
  for (var i = 0; i < str.length; i++) {
    var c = str.charAt(i);
    if (/^[u0000-u00ff]$/.test(c)) { // 匹配雙字節
      bytesCount += 1;
    } else {
      bytesCount += 2;
    }
  }
  return bytesCount;
}

// 建立 XMLHttpRequest 物件
function createXMLHttpRequest() {
  if (window.ActiveXObject) {
    xmlhttp = new ActiveXObject("Microsoft.XMLHTTP");
  } else if (window.XMLHttpRequst) {
    xmlhttp = new XMLHttpRequest();
  }
}

// 以 HTTP POST 送出請求
// 這段程式就是用 JS 拼出一段字串,而這段字串正是用瀏覽器檢視 WEBSERVICE 方法時看到的那段
function RequestByPost(method, variable, value, url, _Namespace) {
  createXMLHttpRequest();
  var data;
  data = '<?xml version="1.0" encoding="utf-8"?>';
  data = data + '<soap:Envelope xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="https://www.w3.org/2001/XMLSchema" xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/">';
  // 加上這段即可實作 SOAP 頭
  // UserName、Pwd 是我的 SOAP 驗證形式,需替換成自己的
  data = data + "<soap:Header>";
  data = data + '<UserSoapHeader xmlns="https://tempuri.org/">';
  data = data + "<UserName>admin</UserName>";
  data = data + "<Pwd>faaaa</Pwd>";
  data = data + "</UserSoapHeader>";
  data = data + "</soap:Header>";
  data = data + '<soap:Body>';
  data = data + '<' + method + ' xmlns="' + _Namespace + '">';
  for (var i = 0; i < variable.length; i++) {
    data = data + '<' + variable[i] + '>' + value[i] + '</' + variable[i] + '>';
  }
  data = data + '</' + method + '>';
  data = data + '</soap:Body>';
  data = data + '</soap:Envelope>';

  xmlhttp.onreadystatechange = handleStateChange;
  xmlhttp.Open("POST", url, true);
  xmlhttp.SetRequestHeader("Content-Type", "text/xml; charset=utf-8");
  // xmlhttp.SetRequestHeader("Content-Length", getlen(data));
  xmlhttp.SetRequestHeader("SOAPAction", _Namespace + method);
  xmlhttp.Send(data);
  alert(data);
}

// 測試呼叫
function Button2_onclick() {
  // 方法名、參數名、參數值、服務 URL、服務所使用的命名空間
  RequestByPost("HelloWorld", [], [], "https://localhost:13267/SERVICES/WebService.asmx", "https://tempuri.org/");
}

window.onload = function () {
  Button2_onclick();
}
// ]]>
</script>
</head>
<body>
<label id='Label1'>ss</label>
</body>
</html>

幾個關鍵點值得留意。第一,Content-Type 必須是 text/xml,而 SOAPAction 標頭要是「命名空間 + 方法名」的組合,少了它伺服器會直接回 500。第二,身分驗證資訊放在 soap:Header 中的自訂節點裡,這與放在 Body 中的方法參數是兩回事,後端通常會用 SOAP 擴充方法去攔截它。第三,範例中的帳號密碼是寫死在前端的,這只是為了示範封包結構;正式環境絕對不能這麼做,前端程式碼等於公開,正確做法是把驗證交給後端的身分機制(如 token 或 session)。

另外,以今天的觀點來看,直接手刻 SOAP 已屬少見,改用 fetch 搭配 JSON 的 REST 介面會簡潔許多;但理解 SOAP 封包長什麼樣子,在維護老系統時仍然用得上。

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