用 POST 送 XML 的好處是結構清楚、擴充容易,代價是前端要自己組字串、後端要自己解。下面把整個流程拆成五段來看。
這段程式碼幾乎每個老專案都有,重點是 traverse 兩條路:原生物件與 IE 的 ActiveX。
var XMLHttpReq = false;
function createXMLHttpRequest() {
if (window.XMLHttpRequest) {
XMLHttpReq = new XMLHttpRequest(); // Mozilla 系
} else if (window.ActiveXObject) {
try {
XMLHttpReq = new ActiveXObject('Msxml2.XMLHTTP');
} catch (e) {
try {
XMLHttpReq = new ActiveXObject('Microsoft.XMLHTTP');
} catch (e) { }
}
}
}
function createXML() {
var xml = '<user>';
xml += '<name>sunjianbin</name>';
xml += '<password>7980421</password>';
xml += '</user>';
return xml;
}
注意這裡的字串拼接順序,以及結尾標籤必須與開頭對應。実務上若資料含有 <、>、& 等字元,必須先做跳脫處理,否則 XML 會解析失敗。
function sendRequest(url, xml) {
createXMLHttpRequest();
XMLHttpReq.open('POST', url, true);
XMLHttpReq.onreadystatechange = processResponse;
XMLHttpReq.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
XMLHttpReq.send(xml);
}
若後端要的是 application/xml,就把 Content-Type 改過來;兩者對應的伺服器端解析方式不同,這一步寫錯是最常見的失敗原因。
function processResponse() {
if (XMLHttpReq.readyState !== 4) { return; }
if (XMLHttpReq.status === 200) {
readXML();
} else {
alert('您請求的頁面發生異常。');
}
}
function readXML() {
var objects = XMLHttpReq.responseXML.getElementsByTagName('user');
for (var i = 0; i < objects.length; i++) {
var object = objects[i];
var name = object.getElementsByTagName('name')[0].firstChild.data;
var password = object.getElementsByTagName('passWord')[0].firstChild.data;
alert('name>>>' + name + ', password>>>' + password);
}
}
這裡有兩個實務上的坑。第一,responseXML 只有在回應標頭的 Content-Type 為 text/xml 時才會被解析,否則會拿到 null,此時得改用 DOMParser 自行解析 responseText。第二,firstChild.data 在節點為空或含空白時會出錯,較穩健的寫法是先判斷 firstChild 是否存在。
function sendTo() {
var url = '/test/servlet/test';
sendRequest(url, createXML());
}
這整套流程放到今天,多數情況已經被 fetch 與 JSON 取代。但如果你要維護的是既有系統,或需要跟只吃 XML 的舊 SOAP 服務溝通,上面這五段仍然是必備的基本功。