XML解析

注意事項(xiàng)

• XML解析及轉(zhuǎn)換需要確保傳入的XML數(shù)據(jù)符合標(biāo)準(zhǔn)格式。

• XML解析目前不支持按指定節(jié)點(diǎn)解析對(duì)應(yīng)的節(jié)點(diǎn)值。

解析XML標(biāo)簽和標(biāo)簽值

1. 引入模塊。

   import xml from '@ohos.xml';
   import util from '@ohos.util'; // 需要使用util模塊函數(shù)對(duì)文件編碼

2. 對(duì)XML文件編碼后調(diào)用XmlPullParser。

   可以基于ArrayBuffer構(gòu)造XmlPullParser對(duì)象， 也可以基于DataView構(gòu)造XmlPullParser對(duì)象。

   let strXml =
     '<?xml version="1.0" encoding="utf-8"?>' +
       '<note importance="high" logged="true">' +
       '<title>Play</title>' +
       '<lens>Work</lens>' +
       '</note>';
   let textEncoder = new util.TextEncoder();
   let arrBuffer = textEncoder.encodeInto(strXml); // 對(duì)數(shù)據(jù)編碼，防止包含中文字符亂碼
   // 1.基于ArrayBuffer構(gòu)造XmlPullParser對(duì)象
   let that = new xml.XmlPullParser(arrBuffer.buffer, 'UTF-8');
   
   // 2.基于DataView構(gòu)造XmlPullParser對(duì)象
   let dataView = new DataView(arrBuffer.buffer);
   let that = new xml.XmlPullParser(dataView, 'UTF-8');

3. 自定義回調(diào)函數(shù)，本例直接打印出標(biāo)簽及標(biāo)簽值。

   let str = '';
   function func(name, value){
     str = name + value;
     console.info(str);
     return true; //true:繼續(xù)解析 false:停止解析
   }

4. 設(shè)置解析選項(xiàng)，調(diào)用parse函數(shù)。

   let options = {supportDoctype:true, ignoreNameSpace:true, tagValueCallbackFunction:func};
   that.parse(options);

   輸出結(jié)果如下所示：

   note
   title
   Play
   title
   lens
   Work
   lens
   note

解析XML屬性和屬性值

1. 引入模塊。

   import xml from '@ohos.xml';
   import util from '@ohos.util'; // 需要使用util模塊函數(shù)對(duì)文件編碼

2. 對(duì)XML文件編碼后調(diào)用XmlPullParser。

   let strXml =
     '<?xml version="1.0" encoding="utf-8"?>' +
       '<note importance="high" logged="true">' +
       '    <title>Play</title>' +
       '    <title>Happy</title>' +
       '    <lens>Work</lens>' +
       '</note>';
   let textEncoder = new util.TextEncoder();
   let arrBuffer = textEncoder.encodeInto(strXml); // 對(duì)數(shù)據(jù)編碼，防止包含中文字符亂碼
   let that = new xml.XmlPullParser(arrBuffer.buffer, 'UTF-8');

3. 自定義回調(diào)函數(shù)，本例直接打印出屬性及屬性值。

   let str = '';
   function func(name, value){
     str += name + ' ' + value + ' ';
     return true; // true:繼續(xù)解析 false:停止解析
   }

4. 設(shè)置解析選項(xiàng)，調(diào)用parse函數(shù)。

   let options = {supportDoctype:true, ignoreNameSpace:true, attributeValueCallbackFunction:func};
   that.parse(options);
   console.info(str); // 一次打印出所有的屬性及其值

   輸出結(jié)果如下所示：

   importance high logged true // note節(jié)點(diǎn)的屬性及屬性值

解析XML事件類(lèi)型和元素深度

1. 引入模塊。

   import xml from '@ohos.xml';
   import util from '@ohos.util'; // 需要使用util模塊函數(shù)對(duì)文件編碼

2. 對(duì)XML文件編碼后調(diào)用XmlPullParser。

   let strXml =
     '<?xml version="1.0" encoding="utf-8"?>' +
     '<note importance="high" logged="true">' +
     '<title>Play</title>' +
     '</note>';
   let textEncoder = new util.TextEncoder();
   let arrBuffer = textEncoder.encodeInto(strXml); // 對(duì)數(shù)據(jù)編碼，防止包含中文字符亂碼
   let that = new xml.XmlPullParser(arrBuffer.buffer, 'UTF-8');

3. 自定義回調(diào)函數(shù)，本例直接打印元素事件類(lèi)型及元素深度。

   let str = '';
   function func(name, value){
     str = name + ' ' + value.getDepth(); // getDepth 獲取元素的當(dāng)前深度
     console.info(str)
     return true; //true:繼續(xù)解析 false:停止解析
   }

4. 設(shè)置解析選項(xiàng)，調(diào)用parse函數(shù)。

   let options = {supportDoctype:true, ignoreNameSpace:true, tokenValueCallbackFunction:func};
   that.parse(options);

   輸出結(jié)果如下所示：

   0 0 // 0：<?xml version="1.0" encoding="utf-8"?> 對(duì)應(yīng)事件類(lèi)型START_DOCUMENT值為0  0：起始深度為0
   2 1 // 2：<note importance="high" logged="true"> 對(duì)應(yīng)事件類(lèi)型START_TAG值為2       1：深度為1
   2 2 // 2：<title>對(duì)應(yīng)事件類(lèi)型START_TAG值為2                                       2：深度為2
   4 2 // 4：Play對(duì)應(yīng)事件類(lèi)型TEXT值為4                                               2：深度為2
   3 2 // 3：</title>對(duì)應(yīng)事件類(lèi)型END_TAG值為3                                        2：深度為2
   3 1 // 3：</note>對(duì)應(yīng)事件類(lèi)型END_TAG值為3                                         1：深度為1（與<note對(duì)應(yīng)>）
   1 0 // 1：對(duì)應(yīng)事件類(lèi)型END_DOCUMENT值為1                                           0：深度為0

場(chǎng)景示例

此處以調(diào)用所有解析選項(xiàng)為例，提供解析XML標(biāo)簽、屬性和事件類(lèi)型的開(kāi)發(fā)示例。

import xml from '@ohos.xml';
import util from '@ohos.util';

let strXml =
  '<?xml version="1.0" encoding="UTF-8"?>' +
    '<book category="COOKING">' +
    '<title lang="en">Everyday</title>' +
    '<author>Giada</author>' +
    '</book>';
let textEncoder = new util.TextEncoder();
let arrBuffer = textEncoder.encodeInto(strXml);
let that = new xml.XmlPullParser(arrBuffer.buffer, 'UTF-8');
let str = '';

function tagFunc(name, value) {
  str = name + value;
  console.info('tag-' + str);
  return true;
}

function attFunc(name, value) {
  str = name + ' ' + value;
  console.info('attri-' + str);
  return true;
}

function tokenFunc(name, value) {
  str = name + ' ' + value.getDepth();
  console.info('token-' + str);
  return true;
}

let options = {
  supportDocType: true,
  ignoreNameSpace: true,
  tagValueCallbackFunction: tagFunc,
  attributeValueCallbackFunction: attFunc,
  tokenValueCallbackFunction: tokenFunc
};
that.parse(options);

輸出結(jié)果如下所示：

tag-
token-0 0
tag-book
attri-category COOKING
token-2 1
tag-title
attri-lang en
token-2 2
tag-Everyday
token-4 2
tag-title
token-3 2
tag-author
token-2 2
tag-Giada
token-4 2
tag-author
token-3 2
tag-book
token-3 1
tag-
token-1 0