简介
（）是 提供处理 与 对象映
射的标准库。在 中已经包含了 定义的所有 ，在处理 文档
时，使用 要比使用 （ 、 和 ）更方便。（但不表明
、 和 就再无用武之地，并且 的实现也是基于 ）。
框架中提供两种编写 和 对象交互的方法。其一，通过 （
!"#）文档生成 类的方式。其二，通过编写标注 类，之
后生成相应的 文档（第二种，生成 文档并不是必须的）。 通过分
析 类中的标记（#），将 类转换为相应的 文档。在方
案一中，通过 文件生成的 类，已经被编译器（$）进行了标注，因此
无需手工标注，而对应第二种方案，必须是编程人员手工添加这些标记。
定义的标记比较多，也很复杂，要想灵活的控制转换过程，可以使用直接标注
的方式。使用 转换的方式，相对比较简单，但需要使用者具有熟练的
编写经验，此外，使用 方式生成 文档还有一大优势，就是在分布式
系统中，不能保证 信息的发送端和接收端都是使用的 运行环境，因
此， 实际上将会成为端到端通信的一个标准，规定了通信的信息格式，因
此，一般在分布式系统中可以先编写 文件，之后通信两端根据 提供的
协议各自根据自身的情况，实现对 文档的处理。
下文采用第一种方式对 的使用方法进行介绍。编写示例的流程是，先
编写 文件，通过编译器（$%!&'）编译生成 类，编写
测试程序（一般名称叫 ((），最后给出执行结果。
本 文 内 容 源 于 官 方 网 站 提 供 的 帮 助 文
档 )&*++$,+'+(#-.-./#!'0# ，本文
并不是对原有官方文档进行简单的翻译，而是挑选出源文档中具有代表性的内
容，进行较深入的讲解，本文提供的实例与原文档提供的实例完全不同，是作
者根据相应内容进行设计的，作者希望这些实例能够提供对原文档的一个补充
说明。读者可以不借助原文档直接阅读下面的内容，因为本文内容基本可以自
成体系，此外本文保持了原文档的编号方式，方便读者到原文档中查找相应内
容。由于作者的局限性，很多地方仍有不足，因此作者不保证示例和评论的正
