鸿蒙ArkTS实战开发：XML解析

对于以XML作为载体传递的数据，实际使用中需要对相关的节点进行解析，一般包括解析XML标签和标签值、解析XML属性和属性值、解析XML事件类型和元素深度三类场景。

XML模块提供XmlPullParser类对XML文件解析，输入为含有XML文本的ArrayBuffer或DataView，输出为解析得到的信息。

表1 XML解析选项

名称	类型	必填	说明
supportDoctype	boolean	否	是否忽略文档类型。默认为false，表示对文档类型进行解析。
ignoreNameSpace	boolean	否	是否忽略命名空间。默认为false，表示对命名空间进行解析。
tagValueCallbackFunction	(name: string, value: string) => boolean	否	获取tagValue回调函数，打印标签及标签值。默认为null，表示不进行XML标签和标签值的解析。
attributeValueCallbackFunction	(name: string, value: string) => boolean	否	获取attributeValue回调函数， 打印属性及属性值。默认为null，表示不进行XML属性和属性值的解析。
tokenValueCallbackFunction	(eventType: EventType, value: ParseInfo) => boolean	否	获取tokenValue回调函数，打印标签事件类型及parseInfo对应属性。默认为null，表示不进行XML事件类型解析。

注意事项

• XML解析及转换需要确保传入的XML数据符合标准格式。

• XML解析目前不支持按指定节点解析对应的节点值。

解析XML标签和标签值

1. 引入模块。

   import xml from '@ohos.xml';
   import util from '@ohos.util'; // 需要使用util模块函数对文件编码

2. 对XML文件编码后调用XmlPullParser。 可以基于ArrayBuffer构造XmlPullParser对象， 也可以基于DataView构造XmlPullParser对象。

   let strXml: string =
   '<?xml version="1.0" encoding="utf-8"?>' +
     '<note importance="high" logged="true">' +
     '<title>Play</title>' +
     '<lens>Work</lens>' +
     '</note>';
   let textEncoder: util.TextEncoder = new util.TextEncoder();
   let arrBuffer: Uint8Array = textEncoder.encodeInto(strXml); // 对数据编码，防止包含中文字符乱码
   // 1.基于ArrayBuffer构造XmlPullParser对象
   let that: xml.XmlPullParser = new xml.XmlPullParser(arrBuffer.buffer as object as ArrayBuffer, 'UTF-8');
   
   // 2.基于DataView构造XmlPullParser对象
   // let dataView: DataView = new DataView(arrBuffer.buffer as object as ArrayBuffer);
   // let that: xml.XmlPullParser = new xml.XmlPullParser(dataView, 'UTF-8');

3. 自定义回调函数，本例直接打印出标签及标签值。

   let str: string = '';
   function func(name: string, value: string): boolean {
     str = name + value;
     console.info(str);
     return true; //true:继续解析 false:停止解析
   }

4. 设置解析选项，调用parse函数。

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

   输出结果如下所示：

   note
   title
   Play
   title
   lens
   Work
   lens
   note

解析XML属性和属性值

1. 引入模块。

   import xml from '@ohos.xml';
   import util from '@ohos.util'; // 需要使用util模块函数对文件编码

2. 对XML文件编码后调用XmlPullParser。

   let strXml: string =
     '<?xml version="1.0" encoding="utf-8"?>' +
       '<note importance="high" logged="true">' +
       '    <title>Play</title>' +
       '    <title>Happy</title>' +
       '    <lens>Work</lens>' +
       '</note>';
   let textEncoder: util.TextEncoder = new util.TextEncoder();
   let arrBuffer: Uint8Array = textEncoder.encodeInto(strXml); // 对数据编码，防止包含中文字符乱码
   let that: xml.XmlPullParser = new xml.XmlPullParser(arrBuffer.buffer as object as ArrayBuffer, 'UTF-8');

3. 自定义回调函数，本例直接打印出属性及属性值。

   let str: string = '';
   function func(name: string, value: string): boolean {
     str += name + ' ' + value + ' ';
     return true; // true:继续解析 false:停止解析
   }

4. 设置解析选项，调用parse函数。

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

   输出结果如下所示：

   importance high logged true // note节点的属性及属性值

解析XML事件类型和元素深度

1. 引入模块。

   import xml from '@ohos.xml';
   import util from '@ohos.util'; // 需要使用util模块函数对文件编码

2. 对XML文件编码后调用XmlPullParser。

   let strXml: string =
     '<?xml version="1.0" encoding="utf-8"?>' +
     '<note importance="high" logged="true">' +
     '<title>Play</title>' +
     '</note>';
   let textEncoder: util.TextEncoder = new util.TextEncoder();
   let arrBuffer: Uint8Array = textEncoder.encodeInto(strXml); // 对数据编码，防止包含中文字符乱码
   let that: xml.XmlPullParser = new xml.XmlPullParser(arrBuffer.buffer as object as ArrayBuffer, 'UTF-8');

3. 自定义回调函数，本例直接打印元素事件类型及元素深度。

   let str: string  = '';
   function func(name: xml.EventType, value: xml.ParseInfo): boolean {
     str = name + ' ' + value.getDepth(); // getDepth 获取元素的当前深度
     console.info(str)
     return true; //true:继续解析 false:停止解析
   }

4. 设置解析选项，调用parse函数。

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

   输出结果如下所示：

    0 0 // 0：<?xml version="1.0" encoding="utf-8"?> 对应事件类型		START_DOCUMENT值为0  0：起始深度为0
    2 1 // 2：<note importance="high" logged="true"> 对应事件类型START_TAG值为2       1：深度为1
    2 2 // 2：<title>对应事件类型START_TAG值为2                                       2：深度为2
    4 2 // 4：Play对应事件类型TEXT值为4                                               2：深度为2
    3 2 // 3：</title>对应事件类型END_TAG值为3                                        2：深度为2
    3 1 // 3：</note>对应事件类型END_TAG值为3                                         1：深度为1（与<note对应>）
    1 0 // 1：对应事件类型END_DOCUMENT值为1                                           0：深度为0

场景示例

此处以调用所有解析选项为例，提供解析XML标签、属性和事件类型的开发示例。

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

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

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

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

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

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

输出结果如下所示：

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

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。 

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

如果你是一名有经验的资深Android移动开发、Java开发、前端开发、对鸿蒙感兴趣以及转行人员，可以直接领取这份资料

 获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（HarmonyOS NEXT）最新学习路线

•  HarmonOS基础技能

• HarmonOS就业必备技能 
•  HarmonOS多媒体技术

• 鸿蒙NaPi组件进阶

• HarmonOS高级技能

• 初识HarmonOS内核 
• 实战就业级设备开发

 有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V2.0白皮书》

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

 《鸿蒙开发基础》

• ArkTS语言
• 安装DevEco Studio
• 运用你的第一个ArkTS应用
• ArkUI声明式UI开发
• .……

 《鸿蒙开发进阶》

• Stage模型入门
• 网络管理
• 数据管理
• 电话服务
• 分布式应用开发
• 通知与窗口管理
• 多媒体技术
• 安全技能
• 任务管理
• WebGL
• 国际化开发
• 应用测试
• DFX面向未来设计
• 鸿蒙系统移植和裁剪定制
• ……

《鸿蒙进阶实战》

• ArkTS实践
• UIAbility应用
• 网络案例
• ……

 获取以上完整鸿蒙HarmonyOS学习资料，请点击→纯血版全套鸿蒙HarmonyOS学习资料

总结

总的来说，华为鸿蒙不再兼容安卓，对中年程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，他们才能在这个变革的时代中立于不败之地。