use std::fs::File;
use std::io::BufReader;

use xml::reader::{EventReader, XmlEvent};

fn main() -> std::io::Result<()> {
    let file = File::open("file.xml")?;
    let file = BufReader::new(file); // Buffering is important for performance

    let parser = EventReader::new(file);
    let mut depth = 0;
    for e in parser {
        match e {
            Ok(XmlEvent::StartElement { name, .. }) => {
                println!("{:spaces$}+{name}", "", spaces = depth * 2);
                depth += 1;
            }
            Ok(XmlEvent::EndElement { name }) => {
                depth -= 1;
                println!("{:spaces$}-{name}", "", spaces = depth * 2);
            }
            Err(e) => {
                eprintln!("Error: {e}");
                break;
            }
            // There's more: https://docs.rs/xml-rs/latest/xml/reader/enum.XmlEvent.html
            _ => {}
        }
    }

    Ok(())
}

文档解析可以正常结束或因错误而结束。无论具体原因如何，解析过程都将停止，迭代器将正常终止。

您还可以通过解析器的 next() 方法更细致地控制何时从解析器中获取下一个事件。

match parser.next() {
    ...
}

在文档结束或发生错误时，解析器将记住最后一个事件，并在随后的 next() 调用中始终返回它。如果使用迭代器，则它将一次产生错误或文档结束事件，之后将产生 None。

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

您可以在 src/analyze.rs 中找到一个更广泛的 EventReader 使用示例，这是一个小型程序（顺便说一句，它是用 cargo build 构建的，构建后可以运行），它显示了有关指定XML文档的各种统计信息。它还可以用于检查XML文档的有效性 - 如果文档不是有效的，则此程序将以错误退出。

解析不受信任的输入

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

编写XML文档

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

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。