HarmonyOS开发知识：XML生成-解析-转换

 XML概述

XML（可扩展标记语言）是一种用于描述数据的标记语言，旨在提供一种通用的方式来传输和存储数据，特别是Web应用程序中经常使用的数据。XML并不预定义标记。因此，XML更加灵活，并且可以适用于广泛的应用领域。

XML文档由元素（element）、属性（attribute）和内容（content）组成。

• 元素指的是标记对，包含文本、属性或其他元素。

• 属性提供了有关元素的其他信息。

• 内容则是元素包含的数据或子元素。

XML还可以通过使用XML Schema或DTD（文档类型定义）来定义文档结构。这些机制允许开发人员创建自定义规则以验证XML文档是否符合其预期的格式。

XML还支持命名空间、实体引用、注释、处理指令等特性，使其能够灵活地适应各种数据需求。

语言基础类库提供了XML相关的基础能力，包括：XML的生成XML的生成XML的生成、XML的解析

XML生成

XML可以作为数据交换格式，被各种系统和应用程序所支持。例如Web服务，可以将结构化数据以XML格式进行传递。

XML还可以作为消息传递格式，在分布式系统中用于不同节点之间的通信与交互。

注意事项

• XML标签必须成对出现，生成开始标签就要生成结束标签。

• XML标签对大小写敏感，开始标签与结束标签大小写要一致。

开发步骤

XML模块提供XmlSerializer类来生成XML文件，输入为固定长度的Arraybuffer或DataView对象，该对象用于存放输出的XML数据。

通过调用不同的方法来写入不同的内容，如startElement(name: string)写入元素开始标记，setText(text: string)写入标签值。

按需求调用对应函数可以生成一份完整的XML文件。

1. 引入模块。

   import { xml, util } from '@kit.ArkTS';

2. 创建缓冲区，构造XmlSerializer对象（可以基于Arraybuffer构造XmlSerializer对象， 也可以基于DataView构造XmlSerializer对象）。

   // 1.基于Arraybuffer构造XmlSerializer对象
   let arrayBuffer: ArrayBuffer = new ArrayBuffer(2048); // 创建一个2048字节的缓冲区
   let thatSer: xml.XmlSerializer = new xml.XmlSerializer(arrayBuffer); // 基于Arraybuffer构造XmlSerializer对象
   
   // 2.基于DataView构造XmlSerializer对象
   let arrayBuffer: ArrayBuffer = new ArrayBuffer(2048); // 创建一个2048字节的缓冲区
   let dataView: DataView = new DataView(arrayBuffer); // 使用DataView对象操作ArrayBuffer对象
   let thatSer: xml.XmlSerializer = new xml.XmlSerializer(dataView); // 基于DataView构造XmlSerializer对象

3. 调用XML元素生成函数。

   thatSer.setDeclaration(); // 写入xml的声明
   thatSer.startElement('bookstore'); // 写入元素开始标记
   thatSer.startElement('book'); // 嵌套元素开始标记
   thatSer.setAttributes('category', 'COOKING'); // 写入属性及属性值
   thatSer.startElement('title');
   thatSer.setAttributes('lang', 'en');
   thatSer.setText('Everyday'); // 写入标签值
   thatSer.endElement(); // 写入结束标记
   thatSer.startElement('author');
   thatSer.setText('Giada');
   thatSer.endElement();
   thatSer.startElement('year');
   thatSer.setText('2005');
   thatSer.endElement();
   thatSer.endElement();
   thatSer.endElement();

4. 使用Uint8Array操作Arraybuffer，调用TextDecoder对Uint8Array解码后输出。

   let view: Uint8Array = new Uint8Array(arrayBuffer); // 使用Uint8Array读取arrayBuffer的数据
   let textDecoder: util.TextDecoder = util.TextDecoder.create(); // 调用util模块的TextDecoder类
   let res: string = textDecoder.decodeWithStream(view); // 对view解码
   console.info(res);

   输出结果如下：

<?xml version=\"1.0\" encoding=\"utf-8\"?><bookstore>\r\n  <book category=\"COOKING\">\r\n    <title lang=\"en\">Everyday</title>\r\n    <author>Giada</author>\r\n    <year>2005</year>\r\n  </book>\r\n</bookstore>

XML解析

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

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

表1 XML解析选项

名称	类型	必填	说明
supp