你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

核心 IO 操作

项目
09/26/2024

除了提供读取空间数据文件的工具外，空间 IO 模块还公开核心基础库，以便快速高效地读取和写入 XML 和带分隔符的数据。

atlas.io.core 命名空间包含两个可快速读取和写入 CSV 和 XML 数据的低级别类。这些基类为空间 IO 模块中的空间数据读取器和编写器提供动力。请随时使用它们来添加对 CSV 或 XML 文件的更多读取和写入支持。

读取带分隔符的文件

atlas.io.core.CsvReader 类读取包含带分隔符的数据集的字符串。此类提供两种读取数据的方法：

read 函数可读取完整的数据集，并返回一个二维字符串数组，该数组表示带分隔符的数据集的所有单元格。
getNextRow 函数读取带分隔符的数据集中的每一行文本，并返回一个字符串数组，该数组表示该数据集行中的所有单元格。在处理下一行之前，用户可以处理该行并释放该行中的任何不需要的内存。因此，函数的内存效率更高。

默认情况下，读取器会使用逗号字符作为分隔符。但是，分隔符可以更改为任意单个字符或设置为 'auto'。当设置为 'auto' 时，读取器会分析字符串中的第一行文本。然后，它会从下表中选择最常见的字符用作分隔符。

分隔符	字符
逗号	`,`
选项卡	`\t`
管道	`\|`

此读取器还支持用于处理包含分隔符字符的单元格的文本限定符。引号 ('"') 字符是默认文本限定符，但可以更改为任意单个字符。

写入带分隔符的文件

atlas.io.core.CsvWriter 写入对象数组作为带分隔符的字符串。任何单个字符均可用作分隔符或文本限定符。默认分隔符是逗号 (',')，默认文本限定符是引号 ('"') 字符。

请按照以下步骤使用该类：

创建类的实例，并根据需要设置自定义分隔符或文本限定符。
使用 write 函数或 writeRow 函数将数据写入类。对于 write 函数，传递一个二维对象数组，该数组表示多个行和单元格。若要使用 writeRow 函数，请传递对象数组，该数组表示具有多个列的数据行。
调用 toString 函数以检索带分隔符的字符串。
（可选）调用 clear 方法以使编写器可重用并减少其资源分配，或调用 delete 方法以释放编写器实例。

备注

写入的列数将被限制为传递给编写器的第一行数据中的单元格的数目。

读取 XML 文件

在分析 XML 文件时，atlas.io.core.SimpleXmlReader 类的速度要快于 DOMParser。但是，atlas.io.core.SimpleXmlReader 类要求 XML 文件的格式正确。格式不正确的 XML 文件（如缺少结束标记）可能会导致错误。

下面的代码演示如何使用 SimpleXmlReader 类将 XML 字符串分析为 JSON 对象并将其串行化为所需的格式。

//Create an instance of the SimpleXmlReader and parse an XML string into a JSON object.
var xmlDoc = new atlas.io.core.SimpleXmlReader().parse(xmlStringToParse);

//Verify that the root XML tag name of the document is the file type your code is designed to parse.
if (xmlDoc && xmlDoc.root && xmlDoc.root.tagName && xmlDoc.root.tagName === '<Your desired root XML tag name>') {

    var node = xmlDoc.root;

    //Loop through the child node tree to navigate through the parsed XML object.
    for (var i = 0, len = node.childNodes.length; i < len; i++) {
        childNode = node.childNodes[i];

        switch (childNode.tagName) {
            //Look for tag names, parse and serialized as desired.
        }
    }
}

写入 XML 文件

atlas.io.core.SimpleXmlWriter 类以内存高效的方式写入格式正确的 XML。

下面的代码演示如何使用 SimpleXmlWriter 类生成格式正确的 XML 字符串。

//Create an instance of the SimpleXmlWriter class.
var writer = new atlas.io.core.SimpleXmlWriter();

//Start writing the document. All write functions return a reference to the writer, making it easy to chain the function calls to reduce the code size.
writer.writeStartDocument(true)
    //Specify the root XML tag name, in this case 'root'
    .writeStartElement('root', {
        //Attributes to add to the root XML tag.
        'version': '1.0',
        'xmlns': 'http://www.example.com',
         //Example of a namespace.
        'xmlns:abc': 'http://www.example.com/abc'
    });

//Start writing an element that has the namespace abc and add other XML elements as children.
writer.writeStartElement('abc:parent');

//Write a simple XML element like <title>Azure Maps is awesome!</title>
writer.writeElement('title', 'Azure Maps is awesome!');

//Close the element that we have been writing children to.
writer.writeEndElement();

//Finish writing the document by closing the root tag and the document.
writer.writeEndElement().writeEndDocument();

//Get the generated XML string from the writer.
var xmlString = writer.toString();

以上代码中生成的 XML 将如下所示。

<?xml version="1.0" encoding="UTF-8"?>
<root version="1.0" xmlns="http://www.example.com" xmlns:abc="http://www.example.com/abc">
    <abc:parent>
        <title>Azure Maps is awesome!</title>
    </abc:parent>
</root>