DIV CSS 佈局教程網

JS 解析 XML 檔案與 XML 字串的完整做法
編輯:關於JavaScript     

在 JSON 全面普及之前,XML 是資料交換的共通語言。即使今天多數新專案改用 JSON,仍有大量既有系統、SOAP 介面與 Office 檔案格式是以 XML 為底。所以「怎麼在瀏覽器裡解析 XML」這件事,還是值得搞清楚。

解析 XML 檔案

<script type='text/javascript'>
loadXML = function (xmlFile) {
  var xmlDoc = null;

  // 舊版 IE:透過 ActiveX 建立 XMLDOM
  if (!window.DOMParser && window.ActiveXObject) {
    var xmlDomVersions = [
      'MSXML.2.DOMDocument.6.0',
      'MSXML.2.DOMDocument.3.0',
      'Microsoft.XMLDOM'
    ];
    for (var i = 0; i < xmlDomVersions.length; i++) {
      try {
        xmlDoc = new ActiveXObject(xmlDomVersions[i]);
        break;
      } catch (e) {}
    }
  }
  // 標準瀏覽器:用 DOM 實作建立文件
  else if (document.implementation && document.implementation.createDocument) {
    try {
      /* createDocument 的三個參數:
       * 1. 命名空間 URI
       * 2. 根元素名稱
       * 3. 文件型別(doctype) */
      xmlDoc = document.implementation.createDocument('', '', null);
    } catch (e) {}
  } else {
    return null;
  }

  if (xmlDoc != null) {
    xmlDoc.async = false;
    xmlDoc.load(xmlFile);
  }
  return xmlDoc;
};
</script>

解析 XML 字串

<script type='text/javascript'>
loadXML = function (xmlString) {
  var xmlDoc = null;

  if (!window.DOMParser && window.ActiveXObject) {
    // window.DOMParser 不存在,代表是非 IE 瀏覽器
    var xmlDomVersions = [
      'MSXML.2.DOMDocument.6.0',
      'MSXML.2.DOMDocument.3.0',
      'Microsoft.XMLDOM'
    ];
    for (var i = 0; i < xmlDomVersions.length; i++) {
      try {
        xmlDoc = new ActiveXObject(xmlDomVersions[i]);
        xmlDoc.async = false;
        xmlDoc.loadXML(xmlString);   // loadXML 方法直接載入字串
        break;
      } catch (e) {}
    }
  }
  else if (window.DOMParser &&
           document.implementation &&
           document.implementation.createDocument) {
    try {
      /* DOMParser 解析 XML 文字並回傳 XML Document 物件。
       * 以無參數的建構子實例化後,呼叫 parseFromString()。
       * parseFromString(text, contentType)
       *   text: 要解析的 XML 標記
       *   contentType: 可用的值為 "text/xml"、"application/xml"
       *                或 "application/xhtml+xml",不支援 "text/html" */
      var domParser = new DOMParser();
      xmlDoc = domParser.parseFromString(xmlString, 'text/xml');
    } catch (e) {}
  } else {
    return null;
  }

  return xmlDoc;
};
</script>

測試用的 XML 資料

<?xml version="1.0" encoding="utf-8" ?>
<DongFang>
  <Company>
    <cNname>1</cNname>
    <cIP>1</cIP>
  </Company>
  <Company>
    <cNname>2</cNname>
    <cIP>2</cIP>
  </Company>
  <Company>
    <cNname>3</cNname>
    <cIP>3</cIP>
  </Company>
  <Company>
    <cNname>4</cNname>
    <cIP>4</cIP>
  </Company>
  <Company>
    <cNname>5</cNname>
    <cIP>5</cIP>
  </Company>
  <Company>
    <cNname>6</cNname>
    <cIP>6</cIP>
  </Company>
</DongFang>

取出資料

var xmldoc = loadXML("text.xml");
var elements = xmldoc.getElementsByTagName("Company");

for (var i = 0; i < elements.length; i++) {
  var name = elements[i].getElementsByTagName("cNname")[0].firstChild.nodeValue;
  var ip = elements[i].getElementsByTagName("cIP")[0].firstChild.nodeValue;
}

IE 與 Firefox 的解析差異

這段歷史教訓值得記下來:IE 與 Firefox 不只解析器不同,解析出來的節點結構也不同。

IE 取節點值用 .text,Firefox 則是 .textContent。更麻煩的是,Firefox 會在部分層級的子節點前後插入 "\n" 換行符號——也就是說 childNodes[0] 可能只是一個換行,真正的第一個節點在 childNodes[1],第三個節點是換行、第四個才是第二筆資料。這種「索引位置會隨環境改變」的問題,是當年無數 bug 的來源。

<script>
// ---------- 解析 XML 檔案 ----------
var xmlDoc = null;

if (window.ActiveXObject) {
  xmlDoc = new ActiveXObject("Microsoft.XMLDOM");
} else if (document.implementation && document.implementation.createDocument) {
  xmlDoc = document.implementation.createDocument('', '', null);
}

if (xmlDoc != null) {
  xmlDoc.async = false;
  xmlDoc.load("house.xml");
}

// IE:用 childNodes 逐層往下
// alert(xmlDoc.getElementsByTagName("address")[0].childNodes[0].childNodes[0].childNodes[0].nodeValue);
// 或用 item(i) 走訪
// var nodes = xmlDoc.documentElement.childNodes;
// alert(nodes.item(0).childNodes.item(0).childNodes.item(0).text);

// Firefox:節點值改用 textContent,且部分層級前後多了 "\n" 節點
// 所以第一個節點是 item(1),第二個是 item(3),第三個是 item(5)
// alert(xmlDoc.getElementsByTagName("address")[0].childNodes[1].textContent);

// ---------- 解析 XML 字串 ----------
var str = "<car>"
        + "<brand><price>50萬</price><pattern>A6</pattern></brand>"
        + "<brand><price>65萬</price><pattern>A8</pattern></brand>"
        + "<brand><price>17萬</price></brand>"
        + "</car>";

var xmlStrDoc = null;
if (window.DOMParser) {
  var parser = new DOMParser();
  xmlStrDoc = parser.parseFromString(str, "text/xml");
} else {
  xmlStrDoc = new ActiveXObject("Microsoft.XMLDOM");
  xmlStrDoc.async = "false";
  xmlStrDoc.loadXML(str);
}
</script>

對照用的 house.xml

<?xml version="1.0" encoding="utf-8" ?>
<address>
  <city name="北京">
    <price>150萬</price>
    <type>一室三居</type>
  </city>
  <city name="上海">
    <price>200萬</price>
  </city>
  <city name="杭州">
    <price>230萬</price>
  </city>
  <city name="南京"></city>
</address>

給今天的開發者

最惱人的其實是節點層級——同一份 XML,在不同環境下的 childNodes 索引可能都不一樣,只能靠反覆嘗試或 debugger 去確認。

實務上有兩個更聰明的選擇。第一,別用索引,改用 getElementsByTagName() 或 querySelector() 直接抓元素,避開空白節點的干擾。第二,如果資料是自己人產的,直接改用 JSON——JSON.parse() 一行解決,可讀性與維護性都好上太多。另外若只是要讀取少量資料,DOMParser 之後搭配 querySelector 通常就足夠,不必動用整套 DOM 走訪。

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