[转]Xdoclet是什么

      在EJB的学习过程中遇到了Xdoclet,一直不明白是什么,搜了很多东西,现在把他们综合一下。

-------------------------------------------------------------------
      XDoclet是一个开源项目,可以从这里得到他:http://xdoclet.sourceforge.net/xdoclet/ 。
      XDoclet可以通过你在java源代码中的一些特殊的注释信息,自动为你生成配置文件、源代码等等,例如web、ejb的部署描述文件、为你生成struts的struts-config.xml配置文件、javascript校验等。
      正如aspx">《XDoclet in Action》部分章节中文版 一文中所说的“当初,XDoclet因为可以自动生成EJB繁杂的接口和布署描述文件而声名鹊起。然而,现在的XDoclet已经发展成了一个全功能的、面向属性的代码生成框架。J2EE代码生成只是XDoclet的一个应用方面,它可以完成的任务已经远远超越了J2EE和项目文档的生成。”
目前的版本可以为web、ejb、struts、webwork、hibnaate、jdo、jmx等等生成描述文件、源码等,XDoclet提供了ant的任务target支持,完全通过ant来完成任务。

      展开XDoclet的发布包,samples目录下有直接可以运行的ant脚本文件。这里以web应用target为例,说明XDoclet能为我们作些什么。
      下面是samples中一个struts的action代码:

   1:  import javax.servlet.http.HttpServletResponse;
   2:   
   3:  import org.apache.struts.action.Action;
   4:  import org.apache.struts.action.ActionForm;
   5:  import org.apache.struts.action.ActionForward;
   6:  import org.apache.struts.action.ActionMapping;
   7:   
   8:  /**
   9:   * Simple class to test Jakarta Struts generation (Jakarta Struts 1.2 beta 2 only).
  10:   *
  11:   * @struts.action
  12:   *    path="/struts/foo"
  13:   *
  14:   * @struts.action-forward
  15:   *    name="success"
  16:   *    path="/struts/getAll.do"
  17:   *    redirect="false"
  18:   */
  19:  public final class StrutsAction extends Action
  20:  {
  21:      public ActionForward execute(ActionMapping mapping, ActionForm form,
  22:                                   HttpServletRequest request, HttpServletResponse response)
  23:      {
  24:          return mapping.findForward("success");
  25:      }
  26:  }

注意注释部分,注意执行完ant脚本后,将为你生成struts-config.xml中相关的配置项,以下是脚本执行后生成的struts-config.xml文件中的配置:
   1:    
   
   
   2:     <action-mappings>
   3:      <action
   4:        path="/struts/foo"
   5:        type="test.web.StrutsAction"
   6:        unknown="false"
   7:        validate="true"
   8:      >
   9:        <forward
  10:          name="success"
  11:          path="/struts/getAll.do"
  12:          redirect="false"
  13:        />
  14:      
   
   action>

      至此一点我们便可以了解XDoclet是如何工作的了,想想struts中的vaild配置文件、struts-config配置文件等需要我们大量的手工工作,如果再写代码的时候把相关的元数据信息写在注释里,XDoclet将为我们自动完成这些工作,当然像 @struts.action 、@struts.action-forward 等这些特定的注释标签需要去查XDoclet的相关文档了,像前面说的一样,Xdoclet对目前流行的多种框架、技术都提供了相关的支持。相信在一些情况下,Xdoclet会大大提高我们的工作效率的,了解更多信息请参考Xdoclet网站: http://xdoclet.sourceforge.net/xdoclet/

---------------------------------------------------------------------------------------------------------------------------

用 XDoclet 减少代码膨胀

 

XDoclet 能够很容易成为您的 Java 编程工具箱中的一个更加通用的跨技术代码生成工具。不幸的是,开发人员经常忽视 XDoclet 的一般用途,只有将它捆绑在大型开发框架或者 IDE 中,作为其中的一个隐藏元素时,才会用到它。人们常常认为很难将 XDoclet 应用在定制解决方案上。这篇文章的目的就是要消除这个迷惑,把 XDoclet 从常见的复杂陷阱中解脱出来,并向您展示了如何能够利用这个代码生成引擎。

我会用一个实际的例子演示 XDoclet 的用途,该例子将接收一个 POJO(plain old Java object),并用 XDoclet 生成完整 Web 应用程序的全部文件,这些文件是把数据输入关系数据库所必需的。该示例使用了 XDoclet 的 自定义模板代码生成功能,以及它对 Hibernate 对象关系映射工具、Struct Web 应用程序框架和应用程序服务器的内部支持。(请参阅 参考资料)。

智能代码生成器

XDoclet 的核心功能是根据以下组合来生成代码的(或者生成其他配置 / 数据文件):

  • 进行特殊标记的 Java 源文件。
  • 预先定义的模板。

与其他基于模板的代码生成技术(例如 Velocity;请参阅 参考资料)相比,XDoclet 具有以下独特优势:

  • XDoclet 与 Apache Ant(请参阅 参考资料)紧密集成,从而提供了高度自动化的操作。
  • 把控制代码生成和模板处理的 XDoclet 标签作为内联注释嵌入到 Java 源代码文件中。这消除了同步多个相关文件和控制文件的需要。
  • XDoclet 的内置 Java 解析器使用它对 Java 代码结构的深入理解,为输入的 Java 代码建立内部 结构模型。该结构模型又经常被叫作 元数据(metadata),因为它包含与关联代码有关的数据。
  • XDoclet 的模板生成逻辑拥有对输入 Java 代码的内部结构模型的完全访问权。

接下来,我将进一步研究 XDoclet 是如何工作的,以帮助您理解这些特性。

XDoclet 操作

图 1 显示了 XDoclet 要求的输入和生成的输出。

图 1. XDoclet 黑盒子
图 1

您可以看到,包含嵌入式 XDoclet 标签的 Java 源代码是系统的输入。在 Apache Ant 的驱动下,XDoclet 处理输入的代码,生成的输出文本文件可以是 Java 源代码、HTML 页面、XML 文件等。为了处理输入,XDoclet 需要使用模板(保存在 .xdt 文件中)和标签处理器(用 Java 编码)。XDoclet 把模板和标签处理器打包成“模块”,不同的“模块”处理不同的问题域。

XDoclet 生成的结构模型

XDoclet 对包含嵌入式 XDoclet 标签的输入 Java 源代码进行解析,并为代码建立非常详细的结构模型。结构模型中的每个元素都代表源代码中的一个 Java 结构。图 2 显示的结构模型,揭示了 XDoclet 跟踪的代码构造和关系。

图 2. XDoclet 的解析的 Java 源代码的内部结构模型
图 2

图 2 中的结构模型跟踪类、接口、方法之类的代码构造(模型元素)。该模型还跟踪元素之间的关系,例如继承和接口实现。以内联注释的形式嵌入在源代码中的 XDoclet 标签被解析为模型元素的属性,并被跟踪。

通用的 Javadoc 引擎

能够理解 Java 代码结构模型的智能代码生成引擎不是什么新概念。实际上,它是 JDK 自带的 Javadoc 工具的运作方式。通过解析带有特殊 Javadoc 标签的 Java 源文件,Javadoc 工具可以为所有 Java 程序的内置结构元素(包括类、接口、字段和方法)生成 HTML 文档。Javadoc 还具有特殊 Java 语言概念方面的知识,例如继承、抽象类、存储类和修饰符。

XDoclet 的诞生,来自这样一个观察:适用于任意代码生成的 Javadoc 的通用版本,在许多编程场合下会极为有用。但是,实际的 Javadoc 源代码不是为通用的代码生成设计的,而只是为了生成 HTML 文档。由于无法重用现有代码,XDoclet 开发小组从头开始重写了引擎,并显著优化了它的性能。

 

深入 XDoclet

图 3 显示了 XDoclet 的内部结构,揭示了使其运行的功能块。

图 3. XDoclet 内部的功能块
图 3

如图 3 所示,Apache Ant 在运行的时候控制着 XDoclet 的配置和操作。XDoclet 解析输入的 Java 源代码,并在内存中生成结构模型。模板引擎通过处理一组模板和标签处理器,生成输出文件。模板和标签处理器可以是内置的,也可以是定制的。在代码生成期间,模板和标签处理器拥有对结构模型的完全访问。

XDoclet 虚假的复杂性

XDoclet 实质上就是一个通用的 Javadoc 引擎(请参阅侧栏, 通用的 Javadoc 引擎)。那么,是什么让它看起来这么复杂呢?答案在于:XDoclet 几乎从未被单独讨论过,而总是藏在其他许多复杂的技术中。图 4 显示了了围绕在 XDoclet 周围的复杂性迷雾(请参阅侧栏 为什么 XDoclet 看起来比实际的要复杂得多)。

为什么 XDoclet 看起来比实际的要复杂得多

Apache Ant 自动进行 Java 软件的生成过程。构建管理过程通常是生产项目中更复杂过程中的一部分。构建管理的术语和概念被集成到 Apache Ant 中,而且是理解其操作的先决条件。成熟的 Ant 脚本可能会非常复杂。Ant 的每个新版本,都会引入一些新的特性集,从而进一步增加了复杂性。这形成了 XDoclet 表面的复杂性,因为 XDoclet 需要 Ant 才能执行。

XDoclet 处理的问题领域是复杂性的另一个来源。在发布 XDoclet 的时候,XDoclet 已经可以为 EJB 组件集成、J2EE Web 容器集成、Hibernate 持久性层、Struts 框架、Java 管理扩展(JMX)等生成代码。这些问题领域中的每一个领域都有一大套该领域专用的行话和概念。从这些复杂的问题领域出来的问题,经常主导着 XDoclet 的讨论,这也提高了 XDoclet 表面的复杂性。可能是“只见森林,不见树木”。

图 4. XDoclet 的复杂耦合
Figure 4

在图 4 中,您可以看到 XDoclet 与以下内容是紧密相关的:

  • Apache Ant,它控制着 XDoclet 的操作。XDoclet 是作为一组 Ant 任务存在的,没有 Ant 则不能执行。
  • 与生成文件关联的具体问题领域的一些细节。

XDoclet 本身却是惊人地简单,正如下面示例中的工作代码所示的那样。

使用 XDoclet

现在,您可以通过研究我向您提供的数据入口应用程序示例,来观察 XDoclet 的实际工作。(要下载这个示例中使用的 Java 代码、XDoclet 模板和 Ant 脚本,请单击本文顶部或底部的 Code图标,或者请参阅 下载部分。)我们将从检查清单 1 所示的 Java 代码开始,这部分代码表示了一个客户的地址。该地址被编码成 JavaBean 组件,其中的 XDoclet 标签是以黑体字形式显示的:

清单 1. 用 XDoclet 标签标记的 AddressBean.java 源文件

   1:   package com.ibm.dw.beans; 
   2:   import java.io.Serializable; 
   3:   /** 
   4:          
   5:   * @dw.genStrutsAction action="/addAddress.do"
   6:   * @hibernate.class table="ADDRESS"
   7:   */ 
   8:   public class AddressBean implements Serializable { 
   9:   private String streetNumber = ""; 
  10:   private String street = ""; 
  11:   private String city = ""; 
  12:   private String country = ""; 
  13:   private String postalCode = ""; 
  14:   private long id = 0; 
  15:   public AddressBean() { 
  16:   } 
  17:   /** 
  18:          * @dw.genStruts formlabel="Street Number"
  19:   * @hibernate.property length="10"
  20:   */ 
  21:   public String getStreetNumber() { 
  22:     return streetNumber; 
  23:   } 
  24:   public void setStreetNumber(String inpStreetNumber) { 
  25:     streetNumber = inpStreetNumber; 
  26:   } 
  27:   /** 
  28:          * @dw.genStruts formlabel="Street"
  29:   * @hibernate.property  length="40"
  30:   */ 
  31:   public String getStreet() { 
  32:      return street; 
  33:   } 
  34:   public void setStreet(String inpStreet) { 
  35:     street = inpStreet; 
  36:   } 
  37:          ...... more Address bean properties ......
  38:   /** 
  39:          * @hibernate.id generator-class="native"
  40:   */ 
  41:   public long getId(  ) 
  42:   { 
  43:          return id; 
  44:   } 
  45:   public void setId(long inId) { 
  46:     id = inId; 
  47:   } 
  48:   } 

在清单 1 中,需要注意的是,要把 XDoclet 标签嵌入到注释中,紧放在相关代码元素(例如字段、方法、接口或类)的前面。在解析源代码时,XDoclet 会为每个标签建立一个属性,并将该属性附加到结构模型的代码元素上。现在,请注意 @dw.genStruts标签,因为这是在本例中将用到的第一个模板。

生成另外一个 Java 类

对于本例,您需要生成新的 Java 类的代码 —— 一个 Struts 表单 bean。Struts 会用这个 bean 保存并传输用户输入。bean 必须以 bean 属性的形式包含所有数据字段,而且它必须是 org.apache.struts.action.ActionForm的子类。

为了生成表单 bean 的代码,您要根据清单 2 所示的伪代码生成 XDoclet 模板。括号中的黑体字代表控制流逻辑和您要进行替换的文本。请注意模板是如何从已解析的 Java 源代码文件的结构模型中提取信息的:

清单 2. 建立 AddressBeanForm.java Struts 表单 bean 代码的伪代码模板

   1:  package 
   2:          {package name of source class}; 
   3:   import javax.servlet.http.HttpServletRequest; 
   4:   import javax.servlet.http.HttpServletResponse; 
   5:   import org.apache.struts.action.ActionForm; 
   6:   import org.apache.struts.action.ActionMapping; 
   7:   import org.apache.struts.upload.FormFile; 
   8:   /** 
   9:   * Form Bean class for 
  10:          {name of source class};. 
  11:   * 
  12:   * @struts.form name="
  13:          {name of source class}Form"
  14:   */ 
  15:   public class 
  16:          {name of source class}Form extends ActionForm { 
  17:          {loop through all the methods in the source class} 
  18:     {if the method is a JavaBean "getter" method} 
  19:        {if the method has been marked with the @dw.genStruts tag }
  20:       private 
  21:          {return type of method}
  22:                  {name of the JavaBean property}; 
  23:       public 
  24:          {return type of method}
  25:                  {name of the getter method for this property}(){ 
  26:           return 
  27:          {name of JavaBean property}; 
  28:       } 
  29:       public void 
  30:          {name of the setter method for this property}( 
  31:                                  
  32:          {return type of method}value) { 
  33:              
  34:          {name of the JavaBean property}= value;              
  35:       } 
  36:         
  37:          {end of if @dw.genStruts} 
  38:      {end of if JavaBean getter} 
  39:   {end of loop}
用 XDoclet 建立 XDoclet 标签

请注意在 清单 2的模板中生成的 XDoclet@struts.form标签。您可以用 XDoclet 在 Java 源代码中生成 XDoclet 标签,XDoclet 会在后面的操作中再次处理这些标签。在示例后面建立 structs-config.xml 的时候,XDoclet 会使用 @struts.form标签。

在清单 2 的循环中的代码生成了一个字段声明和一个访问器方法,还为输入源代码中每个用 @dw.genStruts标记的访问器方法生成了一个设置器方法。

清单 2 使用了易于理解的伪代码来表示模板替换标签。实际的 XDoclet 模板标签则相当繁琐。清单 3 显示了 genformbean.xdt 模板(所有的 XDoclet 模板都保存在 .xdt 文件中)。我已经用黑体字强调了 XDoclet 模板标签,以方便在伪代码中对其进行引用。

清单 3. 建立 Structs 表单 bean Java 代码的实际 XDoclet 模板代码

   1:   package 
   2:          <XDtPackage:packageName/>; 
   3:   import javax.servlet.http.HttpServletRequest; 
   4:   import javax.servlet.http.HttpServletResponse; 
   5:   import org.apache.struts.action.ActionForm; 
   6:   import org.apache.struts.action.ActionMapping; 
   7:   import org.apache.struts.upload.FormFile; 
   8:   /** 
   9:   * Form Bean class for 
  10:          <XDtClass:className/>. 
  11:   * 
  12:   * @struts.form name="
  13:          <XDtClass:className/>Form"
  14:   */ 
  15:   public class 
  16:          <XDtClass:className/>Form extends ActionForm { 
  17:          <XDtMethod:forAllMethods> 
  18:     <XDtMethod:ifIsGetter> 
  19:        <XDtMethod:ifHasMethodTag tagName="dw.genStruts">
  20:       private 
  21:          <XDtMethod:methodType/> <XDtMethod:propertyName/>; 
  22:       public 
  23:          <XDtMethod:methodType/> <XDtMethod:getterMethod/>(){ 
  24:           return 
  25:          <XDtMethod:propertyName/>; 
  26:       } 
  27:       public void 
  28:          <XDtMethod:setterMethod/>( 
  29:          <XDtMethod:methodType/>value) { 
  30:              
  31:          <XDtMethod:propertyName/>= value;              
  32:       } 
  33:       
  34:          
   
   XDtMethod:ifHasMethodTag> 
  35:     
   
   XDtMethod:ifIsGetter> 
  36:   
   
   XDtMethod:forAllMethods>

熟悉 Ant 脚本编写

Ant 脚本 build.xml(我已经随本文的示例代码提供了这个文件,请参阅 下载部分找到代码的链接)定义了示例应用程序使用的全部必要 Ant 目标。如果您想修改脚本,就需要熟悉 Ant。请参阅 参考资料了解 Ant 的更多信息。

您可以参考 XDoclet 的“模板语言”文档,查找 XDoclet 所有可用标签的列表(请参阅 参考资料)。

要运行用于 AddressBean.java 源文件的模板,请使用以下 Ant 命令行:

ant -Dbase.class.java=Address genstruts

这个命令可以执行定制 Ant 目标(请参阅侧栏 熟悉 Ant 脚本编写)来处理 genbeanform.xdt 模板。XDoclet 提供的 Ant 任务叫作xdoclet.DocletTask,它被用来运行模板文件。如果您对 Ant 的细节感兴趣,请参阅示例代码中的 build.xml 文件,以了解更多信息。

在 XDoclet 处理模板的时候,它在名为 generated的子目录下生成一个 AddressBeanForm.java 文件。清单 4 显示了该文件,它包含模板处理期间替换的所有文本:

清单 4. XDoclet 生成的包含 Struts 表单 bean 的 Java 源代码

   1:   package com.ibm.dw.beans; 
   2:   import javax.servlet.http.HttpServletRequest; 
   3:   import javax.servlet.http.HttpServletResponse; 
   4:   import org.apache.struts.action.ActionForm; 
   5:   import org.apache.struts.action.ActionMapping; 
   6:   import org.apache.struts.upload.FormFile; 
   7:   /** 
   8:   * Form Bean class for 
   9:          AddressBean. 
  10:   * 
  11:   * @struts.form name="
  12:          AddressBeanForm"
  13:   */ 
  14:   public class 
  15:          AddressBeanForm extends ActionForm { 
  16:       private 
  17:          java.lang.String streetNumber; 
  18:       public 
  19:          java.lang.String getStreetNumber(){ 
  20:           return 
  21:          streetNumber; 
  22:       } 
  23:       public void  setStreetNumber(  java.lang.Stringvalue) { 
  24:              
  25:          streetNumber= value;              
  26:       } 
  27:       private  java.lang.String street; 
  28:       public   java.lang.String getStreet(){ 
  29:           return   street; 
  30:       } 
  31:       public void   setStreet(  java.lang.Stringvalue) { 
  32:              
  33:          street= value;              
  34:       } 
  35:     
  36:          ...... more bean properties .....
  37:   } 

为数据表单输入生成 JSP 页面

您可以用相同的 AddressBean.java 源文件,但是用 genformjsp.xdt 模板生成数据入口表单 JSP 页面。清单 5 显示了 genformjsp.xdt:

清单 5. 使用 Struts 标签库生成 JSP 页面来显示 HTML 表单的 XDoclet 模板

   1:  <%@ page language="java" %> 
   2:   <%@ taglib  uri="/WEB-INF/struts-html.tld" prefix="html" %> 
   3:   <html:html> 
   4:   <head> 
   5:   
   
   head> 
   6:   <body bgcolor="white"> 
   7:   <html:errors/> 
   8:   <html:form action="
   9:          &lt;XDtClass:classTagValue tagName='dw.genStrutsAction'  paramName='action' />>"
  10:   <table border="0" width="100%"> 
  11:          <XDtMethod:forAllMethods> 
  12:     <XDtMethod:ifIsGetter> 
  13:        <XDtMethod:ifHasMethodTag tagName="dw.genStruts" >
  14:      <tr> 
  15:          <th align="right"> 
  16:             
  17:          <XDtMethod:methodTagValue 
  18:                     tagName="dw.genStruts" paramName="formlabel"/>
  19:          
   
   th> 
  20:          <td align="left"> 
  21:              <html:text  property="
  22:          &lt;XDtMethod:propertyName/>"
  23:                size="
  24:          <XDtMethod:ifHasMethodTag tagName="hibernate.property" > 
  25:                <XDtMethod:methodTagValue tagName="hibernate.property" paramName="length"/> 
  26:                
   
   XDtMethod:ifHasMethodTag>"/> 
  27:          
   
   td> 
  28:      
   
   tr> 
  29:       
  30:          
   
   XDtMethod:ifHasMethodTag> 
  31:     
   
   XDtMethod:ifIsGetter> 
  32:   
   
   XDtMethod:forAllMethods>
  33:      <tr> 
  34:          <td align="right"> 
  35:              <html:submit> 
  36:                  Submit 
  37:              
   
   html:submit> 
  38:          
   
   td> 
  39:          <td align="left"> 
  40:              <html:reset> 
  41:                Reset 
  42:              
   
   html:reset> 
  43:          
   
   td> 
  44:      
   
   tr> 
  45:   
   
   table> 
  46:   
   
   html:form> 
  47:   
   
   body> 
  48:   
   
   html:html> 

请注意,代码中用 取得原始 AddressBean.java 代码中在 XDoclet 标签中指定的属性值。

当您执行 genstrutsAnt 目标的时候,也会处理清单 5 显示的 genformjsp.xdt 模板。您可以在 generated子目录中找到生成的 AddressBeanForm.jsp 文件,检查文件内容,可以看到要对模板进行的替换。

试验示例,但是首先 ...

要试验本文示例中的模板化代码生成,您需要安装并测试好 Ant 和 XDoclet。本文中的代码全都基于 Ant 1.5.4 和 XDoclet 1.2.1。要生成所有的工件,并试验生成的 Web 应用程序,还需要安装 Hibernate,Struts,以及应用程序服务器,还需要能够访问关系数据库。示例基于 Hibernate 2.1.4,Struts 1.1,以及 Servlet 2.3。请参阅参考资料了解有关这些技术的更多信息。请一定要阅读我随源代码一起提供的 README 文件。

生成其他工件

您可以用 XDoclet 生成任意基于文本的输出。我向您展示的例子使用 XDoclet 生成了 Java 代码、JSP 页面、XML 文件、配置文件以及其他更多输出。它从一个简单的用 XDoclet 进行标记的 Java 源文件 AddressBean.java,建立了一个完整的数据入口 Web 应用程序。为了做到这一点,它执行了 XDoclet 的内置模板(位于 JAR 文件中,称为模块),从而生成:

  • Struts 配置和支持文件。
  • Hibernate 配置和支持文件。
  • Web 应用程序的部署描述符(web.xml)。

表 1 显示了为示例应用程序生成的所有文件(通常称为 工件(artifact)):

表 1. XDoclet 为 AddressBean.java 生成的工件

生成的工件
说明
位置

AddressBeanForm.java
Java 源文件,包含表单 bean 类,在 Struts 的表单处理中使用
generated目录

AddressBeanForm.jsp
JSP 表单,用 Struts 标签库接受用户地址输入
jsp目录

AddressBeanAction.java
Struts 动作类,接受输入值,用 Hibernate 把值保存到关系数据库
generated目录

AddressBean.hbm.xml
Hibernate 映射文件,在 AddressBeanJava 对象和数据库的关系型 ADDRESS 表之间进行映射
web/classes目录

dwschema.sql
RDBMS 表的架构,用来对 AddressBean对象的实例进行持久化
sql目录

hibernate.cfg.xml
Hibernate 运行时的配置文件
web/classes目录

web.xml
生成的 Web 应用程序的部署描述符
web目录

struts-config.xml
Struts 框架的配置文件
web目录

在这篇文章中,您详细了解了表 1 中所列的两个工件中的第一个工件的生成,深入了解了生成它们的模板。工件 AdddressBeanAction.java 则用类似的方法,利用叫作 genaction.xdt 的模板生成。XDoclet 具有内置模板和标签处理器,可以生成表 1 中的其他工件。

表 2 列出了每个生成的工件对应的 Ant 目标和 Ant 任务。您可以执行表格中的每个 Ant 目标,生成对应的工件。所有这些生成的工件,再加上原始和 AddressBean.java,共同构成了示例 Web 应用程序。您还会发现叫作 all的默认 Ant 目标,它会为您做任何事,包括为应用程序建立 WAR(可以部署的 Web 归档)。在进行处理之前,一定要阅读代码发布包中的 README.txt 文件。

XDoclet 中的合并点

在 XDoclet 的文档中,您会非常频繁地看到术语 合并点(merge point)合并文件(merge file)。合并文件是文本文件,您可以把它合并到 XDoclet 生成代码的指定位置——“合并点”上(由模板指定)。可以用合并文件来包含静态文本(例如代码片断和 XML 片断),这些文本可能很难或者不能用 XDoclet 的能力生成。例如,在示例代码的 merge/web目录下,您会找到 struts-action.xml 文件。在代码生成期间,可以用该文件合并到 Struts 的动作映射中,构成生成的 struts-config.xml 文件的一部分。

表 2. 对应于生成工件的 Ant 目录和 Ant 任务

Ant 目标
Ant 任务
工件

   1:  genstruts
   2:  xdoclet.DocletTask
   3:  AddressBeanForm.java
   4:   
   5:  genstruts
   6:  xdoclet.DocletTask
   7:  AddressBeanForm.jsp
   8:   
   9:  genstruts
  10:  xdoclet.DocletTask
  11:  AddressBeanAction.java
  12:   
  13:  generateHIB
  14:  xdoclet.modules.hibernate.HibernateDocletTask
  15:  AddressBean.hbm.xml
  16:   
  17:  generateHIB
  18:  xdoclet.modules.hibernate.HibernateDocletTask
  19:  hibernate.cfg.xml
  20:   
  21:  createDDL
  22:  xdoclet.modules.hibernate.HibernateDocletTask
  23:  dwschema.sql
  24:   
  25:  generateDD
  26:  xdoclet.modules.web.WebDocletTask
  27:  web.xml
  28:   
  29:  generateDD
  30:  xdoclet.modules.web.WebDocletTask
  31:  struts-config.xml
  32:   
XDoclet 是一个有用的、智能的代码生成器,您可以用它自动进行许多日常的 Java 开发任务。不要被它表面的复杂所吓退。随着逐渐精通 XDoclet(以及与之相关的 Apache Ant),您会节约您宝贵的时间,并在未来的开发工作中,得到数倍的回报。

参考资料

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值