Xdoclet介绍

Xdoclet基本概念我们可以在java代码中使用类似于javadoc的注释，来表达更多的内容。

这些额外的注释，通过使用xdoclet工具，我们可以将它们转换为我们需要的各种配置文件。

先看一个简单的例子：比如有一个java文件的源代码如下：/*** @hibernate.class* table="T_Organization"*/public class Organization {/*** @hibernate.id* generator-class="native"*/private int id;/*** @hibernate.many-to-one* column="parentid"*/private Organization parent;/*** @hibernate.set* @hibernate.key* column = "parentid"* @hibernate.one-to-many* class = "anization"*/private Set children;/*** @hibernate.property* column="thename"*/private String name;/*** @hibernate.property*/private String sn;/*** @hibernate.property*/private String description;/**** @return*/public Set getChildren() {return children;}public void setChildren(Set children) {this.children = children;}public String getDescription() {return description;}public void setDescription(String description) { this.description = description;}/***/public int getId() {return id;}public void setId(int id) {this.id = id;}public String getName() {return name;}public void setName(String name) { = name;}public Organization getParent() {return parent;}public void setParent(Organization parent) {this.parent = parent;}public String getSn() {return sn;}public void setSn(String sn) {this.sn = sn;}}通过xdoclet，我们可以得到关于这个类的Hibernate映射文件，如下：<?xml version="1.0" encoding="ISO-8859-1"?><!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN""/hibernate-mapping-3.0.dtd"><hibernate-mapping><class table="T_Organization"name="anization"><id name="id"><generator class="native"/></id><many-to-one column="parentid" name="parent"/><set name="children"><key column="parentid"/><one-to-many class="anization"/></set><property name="name" column="thename"/><property name="sn"/><property name="description"/></class></hibernate-mapping>如何开始使用Xdoclet？Xdoclet不是单独可以运行的工具（不像Ant工具），它可以与其它工具一起配合运行，如Ant。

我们下面的例子就是基于Ant和xdoclet的。

1、首先需要保证ant是可用的2、下载并解压xdoclet的包（我们现在使用的是xdoclet2，具体版本是xdoclet-plugins-1.0.3）。

3、在ant构建工具中定义xdoclet任务，并使用：<?xml version="1.0" encoding="UTF-8"?><project name="OA系统构建脚本"default="生成Hibernate配置文件"basedir="."><property name="src.dir"value="${basedir}/src"/><property name="xdoclet.home"value="E:/share/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><taskdefname="xdoclet"classname="org.xdoclet.ant.XDocletTask"classpathref="xdoclet.task.classpath"/><target name="生成Hibernate配置文件"><xdoclet><fileset dir="${src.dir}/com/wepull/oa/entity"><include name="**/*.java"/></fileset><componentclassname="org.xdoclet.plugin.hibernate.HibernateConfigPlugin"destdir="${src.dir}"version="3.0"hbm2ddlauto="update"jdbcurl="jdbc:sqlserver://localhost:1433;databaseName=wp_oa"jdbcdriver="com.microsoft.sqlserver.jdbc.SQLServerDriver"jdbcusername="sa"jdbcpassword="123"dialect="org.hibernate.dialect.MySQLDialect"showsql="true"/></xdoclet></target><target name="生成hibernate映射文件"><xdoclet><fileset dir="${src.dir}/com/wepull/oa/entity"><include name="**/*.java"/></fileset><componentclassname="org.xdoclet.plugin.hibernate.HibernateMappingPlugin"version="3.0"destdir="${src.dir}"/></xdoclet></target></project>以上就是一个完整的可运行的ant构建脚本。

我们努力来理解这个文件吧：1、<property>标签定义一些变量，这些变量可以通过${变量名}的方式引用2、<path>标签定义了类路径3、<taskdef>标签定义了xdoclet任务（因为ant本身肯定是不包含xdoclet任务的）4、我们在下面的两个<target>中，使用了<xdoclet>标签，这个标签正是我们自己定义的。

Xdoclet可以干什么？Xdoclet实际上就是一个自动代码生成的工具，它可以生成各种各样的代码或配置文件（如果你很清楚xdoclet，你也可以对它进行扩展）。