如果您曾经使用过 XDoclet 或者已经阅读过第一篇 XDoclet 教程，那么您可以跳过这一页。
XDoclet 使自动生成部署描述符更为便利。XDoclet 是一个代码生成实用程序，它允许您使用象 JavaDoc 标记之类的东西来向诸如类、方法和字段之类的语言特征添加元数据。随后，它利用这些额外的元数据来生成诸如部署描述符和源代码之类的相关文件。给这一概念起了一个名称：面向属性的编程（attribute-oriented programming）（不要与面向方面的编程（aspect-oriented programming）相混淆，这是另一个 AOP）。
XDoclet 通过解析源文件来生成这些相关文件，其解析方式类似于 JavaDoc 引擎解析源代码以创建 JavaDoc 文档。实际上，XDoclet 早期的版本是依赖于 JavaDoc 的。XDoclet 和 JavaDoc 一样，不仅能够访问您以 JavaDoc 标记形式添加到代码的那些额外的元数据，还能够访问源代码的结构，即包、类、方法和字段。随后，它将数据的这一层次结构树应用到模板。它使用整棵树及（您可以定义的）一些模板来生成支持文件，用别的方法生成的支持文件是单调的。本教程集中讨论了如何使用 XDoclet 附带的现有模板。
XDoclet 提供了一个 Ant 任务，它使您能够创建 web.xml 文件、ejb-jar.xml 文件和更多其它文件。在本教程中，您将使用 XDoclet，用 webdoclet Ant 任务生成 Web 应用程序部署描述符。此外，您还将生成 EJB 支持文件。注：XDoclet Ant 任务并不与标准 Ant 分发版一起提供。您必须从 http://xdoclet.sourceforge.net 下载 XDoclet Ant 任务。
因此，您可能会问：“关我什么事？我是一名出色的 Java/J2EE Web 开发人员，我永远也不需要 XDoclet。”您也可能会说：“我已经使用了 XDoclet，为什么要写自己的模板呢？”正如我前面所表述的那样，您不知道您缺什么。一旦您开始使用 XDoclet，您就会爱不释手。一旦您开始编写自己的模板，您就永远不会做重复的工作。如果您正在编写单调乏味的代码，那么您大概会转而使用 XDoclet。允许 XDoclet 生成单调的内容，坚持编写好的内容。人类发明了计算机来让它做那些枯燥无味的事情，而将自己解脱出来，去做有创造性的事情。XDoclet 将开发人员从单调无味的代码中解脱出来。XDoclet 是您原先的 J2EE 和 Web 服务开发过程中缺少的那一部分。它可以加快您的开发速度。您必须掌握如何使用 XDoclet 模板。