Ant+XDoclet

         Ant是一个构建工具，它可以帮助我们将项目开发过程中需要完成的各种步骤组织起来，通过一个简易的方式来构建整个项目。Ant究竟能做什么呢？这取决于Ant的任务（Task），Ant有哪些任务，就能完成哪些工作！一些典型的任务是：编译java源代码、运行java程序、拷贝文件或目录、将编译完成的类打包等等。 当然，Ant是一个开放的架构，任何人，都可以按照自己的方式，添加自己的任务（Task），这需要遵守Ant的一些规范。

         Xdoclet实际上就是一个自动代码生成的工具，它可以生成各种各样的代码或配置文件，Xdoclet不是单独可以运行的工具（不像Ant工具），它可以与其它工具一起配合运行，如Ant。

         如何开始使用Ant？

          1、  确保你的机器已经安装了JDK，确保你的path环境变量中包含有java虚拟机的运行程序，确保你的环境变量中有JAVA_HOME变量

          2、  下载ant并解压

          3、  设置ANT_HOME环境变量，指向ant解压根目录

          4、  在path环境变量中，添加ANT_HOME\bin目录

          5、  打开控制台，运行：ant

          6、  如果能够运行ant（忽略这些异常：Buildfile:build.xml does not exist!），而不是出现诸如命令无法解释的错误，那么你的ant就安装成功了

         Ant的运行，靠的是一个构建脚本，默认的名称叫build.xml，如果你在任何目录下运行ant命令，Ant将自动查找当前目录下有没有build.xml文件，如果有这个文件，就读取这个文件，并运行其中的默认target。

         在OA项目中，XDoclet的使用是建立在Ant的运行下，将其配置为ant的build.xml文件中。下面看一下这个配置文件：

<?xml version="1.0" encoding="UTF-8"?>
<project name="OA[04]系统构建脚本" default="生成Hibernate配置文件" basedir=".">

   	<property name="src.dir" value="${basedir}/src"/>
	<property name="xdoclet.home" value="D:/xdoclet-plugins-1.0.3"/>

   	<!-- Build classpath -->
   	<path id="xdoclet.task.classpath">
      	<fileset dir="${xdoclet.home}/lib">
         	<include name="**/*.jar"/>
      	</fileset>
      	<fileset dir="${xdoclet.home}/plugins">
         	<include name="**/*.jar"/>
      	</fileset>
   	</path>
	<taskdef 
		name="xdoclet"
		classname="org.xdoclet.ant.XDocletTask"
		classpathref="xdoclet.task.classpath"
	/>
	
	<target name="生成Hibernate配置文件">
		<xdoclet>
			<fileset dir="${src.dir}/com/bjsxt/oa/model">
				<include name="**/*.java"/>
			</fileset>			
			<component
				classname="org.xdoclet.plugin.hibernate.HibernateConfigPlugin"
				destdir="${src.dir}"
				version="3.0"
				hbm2ddlauto="update"
				jdbcurl="jdbc:mysql://127.0.0.1/oa"
				jdbcdriver="com.mysql.jdbc.Driver"
				jdbcusername="root"
				jdbcpassword="root"
				dialect="org.hibernate.dialect.MySQLDialect"
				showsql="true"
			/>
		</xdoclet>
	</target>
	<target name="生成hibernate映射文件">
		<xdoclet>
			<fileset dir="${src.dir}/com/bjsxt/oa/model">
				<include name="**/*.java"/>
			</fileset>
			<component 
				classname="org.xdoclet.plugin.hibernate.HibernateMappingPlugin"
				version="3.0"
				destdir="${src.dir}"
			/>
		</xdoclet>
	</target>
</project>

build.xml文件中配置了XDoclet的相关配置和定义了两个任务，一个是生成Hibernate映射文件，一个是生成Hibernate配置文件。通过Ant与Xdoclet配合使用，使程序员避免了手动编写必要的xml文件，从而避免了输入错误等一些问题。而XDoclet的使用就更加简单了，XDoclet的使用很像Hibernate中注解使用，只需要按照一定的格式标识实体对象就可以了，看下面的实例：

/**
 * 
 * @author lyj
 * @hibernate.class table="T_Role"
 *
 */
public class Role {
   
	/**
	 * @hibernate.id
	 *    generator-class="native"
	 */
   private int id;
   

   /**
    * @hibernate.property
    *   not-null="true"
    *   unique="true"
    */
   private String name;
  
}

       Ant与XDoclet的配合使用，总结的很浅显，对于Ant的更多深层使用还需要在项目中进行实践。