1# XML生成
2
3
4XML可以作为数据交换格式，被各种系统和应用程序所支持。例如Web服务，可以将结构化数据以XML格式进行传递。
5
6
7XML还可以作为消息传递格式，在分布式系统中用于不同节点之间的通信与交互。
8
9
10## 注意事项
11
12- XML标签必须成对出现，生成开始标签就要生成结束标签。
13
14- XML标签对大小写敏感，开始标签与结束标签大小写要一致。
15
16
17## 开发步骤
18
19XML模块提供XmlSerializer类来生成XML数据，输入为固定长度的Arraybuffer或DataView对象，该对象用于存放生成的XML数据。
20
21通过调用不同的方法来写入不同的内容，如startElement(name: string)写入元素开始标记，setText(text: string)写入标签值。
22
23XML模块的API接口可以参考[@ohos.xml](../reference/apis-arkts/js-apis-xml.md)的详细描述，按需求调用对应函数可以生成一份完整的XML数据。
24
251. 引入模块。
26
27   ```ts
28   import { xml, util } from '@kit.ArkTS';
29   ```
30
312. 创建缓冲区，构造XmlSerializer对象。可以基于Arraybuffer构造XmlSerializer对象，也可以基于DataView构造XmlSerializer对象。
32
33   ```ts
34   // 方式1：基于Arraybuffer构造XmlSerializer对象
35   let arrayBuffer: ArrayBuffer = new ArrayBuffer(2048); // 创建一个2048字节的缓冲区
36   let serializer: xml.XmlSerializer = new xml.XmlSerializer(arrayBuffer); // 基于Arraybuffer构造XmlSerializer对象
37
38   // 方式2：基于DataView构造XmlSerializer对象
39   // let arrayBuffer: ArrayBuffer = new ArrayBuffer(2048);
40   // let dataView: DataView = new DataView(arrayBuffer);
41   // let serializer: xml.XmlSerializer = new xml.XmlSerializer(dataView);
42   ```
43
443. 调用XML元素生成函数。
45
46   ```ts
47   serializer.setDeclaration(); // 写入xml的声明
48   serializer.startElement('bookstore'); // 写入元素开始标记
49   serializer.startElement('book'); // 嵌套元素开始标记
50   serializer.setAttributes('category', 'COOKING'); // 写入属性及属性值
51   serializer.startElement('title');
52   serializer.setAttributes('lang', 'en');
53   serializer.setText('Everyday'); // 写入标签值
54   serializer.endElement(); // 写入结束标记
55   serializer.startElement('author');
56   serializer.setText('Giana');
57   serializer.endElement();
58   serializer.startElement('year');
59   serializer.setText('2005');
60   serializer.endElement();
61   serializer.endElement();
62   serializer.endElement();
63   ```
64
654. 使用Uint8Array操作Arraybuffer，调用TextDecoder对Uint8Array解码后输出。
66
67   ```ts
68   let uint8Array: Uint8Array = new Uint8Array(arrayBuffer); // 使用Uint8Array读取arrayBuffer的数据
69   let textDecoder: util.TextDecoder = util.TextDecoder.create(); // 调用util模块的TextDecoder类
70   let result: string = textDecoder.decodeToString(uint8Array); // 对uint8Array解码
71   console.info(result);
72   ```
73
74   输出结果如下：
75
76   ```
77   <?xml version="1.0" encoding="utf-8"?><bookstore>
78     <book category="COOKING">
79       <title lang="en">Everyday</title>
80       <author>Giana</author>
81       <year>2005</year>
82     </book>
83   </bookstore>
84   ```
85