您还可以使用 xml::reader::ParserConfig 结构稍微调整解析过程。请参阅其文档以获取更多信息示例。

您可以在 src/analyze.rs 中找到使用 EventReader 的更广泛示例，这是一个小型程序（顺便说一下，它使用 cargo build 构建，并在构建后可以运行）它显示了指定 XML 文档的多种统计数据。它也可以用于检查 XML 文档的格式正确性 - 如果文档格式不正确，则此程序将错误退出。

解析不受信任的输入

解析器是用 Rust 的安全子集编写的，因此根据 Rust 的保证，最坏的情况是引发恐慌。您可以使用 ParserConfig 设置名称、属性、文本、实体等的最大长度限制。您还应该通过 io::Read 的 take(max) 方法设置最大文档大小。

编写 XML 文档

xml-rs 还提供了一个类似于 StAX 事件编写器的流式写入器。使用它，您可以向任何 Write 实现器写入 XML 文档。

use std::io;
use xml::writer::{EmitterConfig, XmlEvent};

/// A simple demo syntax where "+foo" makes `<foo>`, "-foo" makes `</foo>`
fn make_event_from_line(line: &str) -> XmlEvent {
    let line = line.trim();
    if let Some(name) = line.strip_prefix("+") {
        XmlEvent::start_element(name).into()
    } else if line.starts_with("-") {
        XmlEvent::end_element().into()
    } else {
        XmlEvent::characters(line).into()
    }
}

fn main() -> io::Result<()> {
    let input = io::stdin();
    let output = io::stdout();
    let mut writer = EmitterConfig::new()
        .perform_indent(true)
        .create_writer(output);

    let mut line = String::new();
    loop {
        line.clear();
        let bytes_read = input.read_line(&mut line)?;
        if bytes_read == 0 {
            break; // EOF
        }

        let event = make_event_from_line(&line);
        if let Err(e) = writer.write(event) {
            panic!("Write error: {e}")
        }
    }
    Ok(())
}

上面的代码示例还演示了如何从配置中创建一个写入器。类似的事情也适用于 EventReader。

该库提供了一个 XML 事件构建 DSL，有助于构建复杂的事件，例如具有命名空间定义的事件。以下是一些示例

// <a:hello a:param="value" xmlns:a="urn:some:document">
XmlEvent::start_element("a:hello").attr("a:param", "value").ns("a", "urn:some:document")

// <hello b:config="name" xmlns="urn:default:uri">
XmlEvent::start_element("hello").attr("b:config", "value").default_ns("urn:defaul:uri")

// <![CDATA[some unescaped text]]>
XmlEvent::cdata("some unescaped text")

当然，也可以直接创建 XmlEvent 枚举变体，而不是使用构建 DSL。更多示例可以在 xml::writer::XmlEvent 文档中找到。

写入器有多个配置选项；有关更多信息，请参阅 EmitterConfig 文档。

错误报告

请在以下地址报告问题： https://github.com/kornelski/xml-rs/issues。