输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心
全部文档
指南
API
开放能力API

XML生成

更新时间: 2026-08-29 09:41
本文导读

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

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

注意事项

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

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

开发步骤

XML模块提供XmlSerializer及XmlDynamicSerializer类来生成XML数据，使用XmlSerializer需传入固定长度的ArrayBuffer或DataView对象作为输出缓冲区，用于存储序列化后的XML数据。

XmlDynamicSerializer类动态扩容，程序根据实际生成的数据大小自动创建ArrayBuffer。

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

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

使用XmlSerializer生成XML示例如下：

  1. 引入模块。

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

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

    方式1：基于ArrayBuffer构造XmlSerializer对象

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

    方式2：基于DataView构造XmlSerializer对象

    let arrayBuffer: ArrayBuffer = new ArrayBuffer(2048); // 创建一个2048字节的缓冲区
let dataView: DataView = new DataView(arrayBuffer); // 创建一个DataView
let serializer: xml.XmlSerializer = new xml.XmlSerializer(dataView); // 基于DataView构造XmlSerializer对象
    XmlSerializer.ets

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

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

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

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

    输出结果如下：

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

使用XmlDynamicSerializer生成XML示例如下：

  1. 引入模块。

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

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

    let dySerializer = new xml.XmlDynamicSerializer('utf-8');
dySerializer.setDeclaration(); // 写入XML的声明
dySerializer.startElement('bookstore'); // 写入元素开始标记
dySerializer.startElement('book'); // 嵌套元素开始标记
dySerializer.setAttributes('category', 'COOKING'); // 写入属性及其属性值
dySerializer.startElement('title');
dySerializer.setAttributes('lang', 'en');
dySerializer.setText('Everyday'); // 写入标签值
dySerializer.endElement(); // 写入结束标记
dySerializer.startElement('author');
dySerializer.setText('Giana');
dySerializer.endElement();
dySerializer.startElement('year');
dySerializer.setText('2005');
dySerializer.endElement();
dySerializer.endElement();
dySerializer.endElement();
let arrayBuffer = dySerializer.getOutput();
    XmlDynamicSerializer.ets

  3. 使用Uint8Array操作ArrayBuffer，并调用TextDecoder对Uint8Array解码后输出。

    let uint8Array: Uint8Array = new Uint8Array(arrayBuffer);
let result: string = util.TextDecoder.create().decodeToString(uint8Array);
console.info(result);
    XmlDynamicSerializer.ets

    输出结果如下：

    <?xml version="1.0" encoding="utf-8"?>
<bookstore>
  <book category="COOKING">
    <title lang="en">Everyday</title>
    <author>Giana</author>
    <year>2005</year>
  </book>
</bookstore>
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 开发与测试 开放能力API 中进行搜索
请输入您想要搜索的关键词