3056b2b1创建于 2024年12月26日历史提交

XML生成

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

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

注意事项

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

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

开发步骤

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

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

XML模块的API接口可以参考@ohos.xml的详细描述,按需求调用对应函数可以生成一份完整的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 serializer: xml.XmlSerializer = new xml.XmlSerializer(arrayBuffer); // 基于Arraybuffer构造XmlSerializer对象
    
    // 方式2:基于DataView构造XmlSerializer对象
    // let arrayBuffer: ArrayBuffer = new ArrayBuffer(2048); 
    // let dataView: DataView = new DataView(arrayBuffer); 
    // let serializer: xml.XmlSerializer = new xml.XmlSerializer(dataView);
    
  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();
    
  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);
    

    输出结果如下:

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