雖然 JSON 已成為主流的資料交換格式,但在既有系統、SOAP 介面或某些 Java 企業專案裡,XML 依然是常見的回應型別。jQuery 的 ajax() 只要把 dataType 指定為 xml,就能直接拿到一個可用 jQuery 選擇器查詢的 XML 文件物件,操作方式與 HTML 幾乎一致。
$.ajax({
url: '...',
type: 'POST',
dataType: 'xml',
error: function(xml) {
alert("Error loading XML document" + xml);
},
success: function(xml) {
$(xml).find("X").each(function(i) {
alert($(this).attr("Xattr"));
});
}
});
關鍵在最後兩行:$(xml) 把回傳的文件包裝成 jQuery 物件後,find() 就能用 CSS 選擇器語法取出想要的節點,attr() 則用來讀取屬性值。若節點內容是文字而非屬性,改用 text() 即可。
以 Struts 的 Action 為例,重點是 Content-Type 必須標明為 XML 並指定 UTF-8 編碼,否則前端解析容易出錯或出現亂碼:
public ActionForward execute(ActionMapping mapping, ActionForm form,
HttpServletRequest request, HttpServletResponse response) throws Exception {
response.setContentType("text/xml; charset=utf-8");
response.setCharacterEncoding("utf-8");
PrintWriter pw = response.getWriter();
Document doc = new Document(); // 準備 XML 文件
doc.write(pw);
return null;
}
首先是編碼一致性。前端頁面、HTTP 回應標頭、XML 宣告裡的 encoding 三者要一致,最省事的做法是全站統一 UTF-8。
其次是 Content-Type 不可馬虎。若回傳 text/html 卻要求 jQuery 當 XML 解析,部分瀏覽器會直接拋出解析錯誤;反之明確標示 text/xml 後,jQuery 才能穩定地交出名稱空間感知的文件物件。
最後是錯誤處理。XML 解析失敗通常不會回報有意義的訊息,建議在 error 回呼裡一併把狀態碼與 responseText 記下來,方便排查是網路問題還是文件格式問題。若節點帶有命名空間(例如 SOAP 回應),find('X') 可能取不到,需要改用 find('ns\\:X') 或以屬性選擇器繞過。