XDoclet教程.docVIP

代码生成器XDoclet 目录 基础篇 概要 XDoclet体系结构 XDoclet操作 XDoclet生成结构模型 XDoclet虚假的复杂型 XDoclet标签 XDT模板语言 使用XDoclet的一个例子 提高应用篇 定制自己的XDoclet标签 使用XDoclet生成web.xml文件 使用XDoclet生成Hibernate影射文件及DDL和数据库 其它 第十二章 关于JavaDoc Tags 第十三章 Using XDoclet 附 一些关于XDoclet资料的网址 概要 XDoclet 是一个通用的代码生成实用程序,是一个扩展的Javadoc Doclet引擎(现已与Javadoc Doclet独立),XDoclet是EJBDoclet的后继者，而EJBDoclet是由Rickard Oberg发起的。（/xdoclet/index.html），它允许您使用象 JavaDoc 标记之类的东西来向诸如类、方法和字段之类的语言特征添加元数据。随后，它利用这些额外的元数据来生成诸如部署描述符和源代码之类的相关文件。可以让你创建自己的javadoc @tags进而利用XDoclet中的Templet enging基于这些@tags生成源代码或其他文件（例如xml的deployment descriptors）。XDoclet 继承了 JavaDoc 引擎的思想，允许根据定制 JavaDoc 标记生成代码和其他文件。当然，XDoclet 也可以访问整个解析树。这样，它就可以访问类、类的包结构和类的方法。 开放源代码的 XDoclet 代码生成引擎，是许多的 Java 框架不可缺少的组成部分，常常被用作面向属性的编程和持续集成的引擎。XDoclet 能够很容易成为您的 Java 编程工具箱中的一个更加通用的跨技术代码生成工具智能代码生成器XDoclet 的核心功能是根据以下组合来生成代码的（或者生成其他配置/数据文件）进行特殊标记的 Java 源文件。 预先定义的模板。 与其他基于模板的代码生成技术相比，XDoclet 具有以下独特优势： XDoclet 与 Apache Ant紧密集成，从而提供了高度自动化的操作。 把控制代码生成和模板处理的 XDoclet 标签作为内联注释嵌入到 Java 源代码文件中。这消除了同步多个相关文件和控制文件的需要。 XDoclet 的内置 Java 解析器使用它对 Java 代码结构的深入理解，为输入的 Java 代码建立内部结构模型。该结构模型又经常被叫作元数据（metadata），因为它包含与关联代码有关的数据。 XDoclet 的模板生成逻辑拥有对输入 Java 代码的内部结构模型的完全访问权。 xDoclet是一种通过读取JAVA源文件中的特定标签，然后生成指定文件的工具。xDoclet标签本身已经提供了一些常用的标签，例如@ejb，@hibernate，@web等等xdoclet-1.2的安装路径\docs\tags）。 A typical XDoclet comment might look like this: /** * This is the Account entity bean. It is an example of how to use the * EJBDoclet tags. * * @see Customer * * @ejb.bean * name=bank/Account * type=CMP * jndi-name=ejb/bank/Account * local-jndi-name=ejb/bank/LocalAccount * primkey-field=id * * @ejb.finder * signature=java.util.Collection findAll() * unchecked=true * * @ejb.transaction * type=Required * * @erface * remote-class=erfaces.Account * * @ejb.value-object * match=* * * @version 1.5 */ There are three parts to that comment: The comment, the javadoc tag, and the XDoclet tags. xdt模板语言接下来，也是最核心的部分，就是有关xdt模板语言XDoclet 提供了自己的模板引擎。该模板引擎在概念上类似于 JavaServer Pages（JSP）技