XML 在 HarmonyOS 中的生成，解析与转换（上）

一、XML 概述

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

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

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

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

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

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

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

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

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

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

二、XML 生成

注意事项

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

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

开发步骤

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

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

XML 模块的 API 接口可以参考 @ohos.xml 的详细描述，按需求调用对应函数可以生成一份完整的 XML 文件。

​ 1. 引入模块。

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

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

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

// 2.基于DataView构造XmlSerializer对象
let arrayBuffer = new ArrayBuffer(2048); // 创建一个2048字节的缓冲区
let dataView = new DataView(arrayBuffer); // 使用DataView对象操作ArrayBuffer对象
let thatSer = 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 = new Uint8Array(arrayBuffer); // 使用Uint8Array读取arrayBuffer的数据
let textDecoder = util.TextDecoder.create(); // 调用util模块的TextDecoder类
let res = textDecoder.decodeWithStream(view); // 对view解码
console.info(res);

输出结果如下：

< ?xml version="1.0" encoding="utf-8"? >rn  rn    < title lang="en" >Everyday< /title >rn    < author >Giada< /author >rn    < year >2005< /year >rn  < /book >rn< /bookstore >

审核编辑 黄宇