Xdoclet自动生成hibernate

Xdoclet基本概念

 

 

我们可以在java代码中使用类似于javadoc的注释，来表达更多的内容。这些额外的注释，通过使用xdoclet工具，我们可以将它们转换为我们需要的各种配置文件。先看一个简单的例子：

比如有一个java文件的源代码如下：

/**

 * @hibernate.class

 *          table="T_Party"

 */

public class Party {

      

       /**

        * @hibernate.id

        *          generator-class="native"

        */

       private int id;

      

       /**

        * @hibernate.many-to-one

        *          column="parentid" 

        */

       private Party parent;

      

       /**

        * @hibernate.set

        * @hibernate.key

        *   column = "parentid"

        * @hibernate.one-to-many

        *          class = "com.bjsxt.oa.model.Party"     

        */

       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) {

              this.name = name;

       }

       public Party getParent() {

              return parent;

       }

       public void setParent(Party 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" "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">

 

<hibernate-mapping>

  <class table="T_Party" name="com.bjsxt.oa.model.Party">

    <id name="id">

      <generator class="native"/>

    </id>

    <many-to-one column="parentid" name="parent"/>

    <set name="children">

      <key column="parentid"/>

      <one-to-many class="com.bjsxt.oa.model.Party"/>

    </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="GBK"?>

<projectname="OA系统构建脚本"default="生成Hibernate配置文件"basedir=".">

 

   <propertyname="src.dir"value="${basedir}/src"/>

   <propertyname="build.dir"value="${basedir}/bin"/>

    <propertyname="webapp.dir"value="${basedir}/src/webapp"/>

    <propertyname="xdoclet.home"value="D:/opensources/xdoclet/xdoclet-plugins-1.0.3"/>

 

   <!-- Build classpath -->

   <pathid="xdoclet.task.classpath">

         <filesetdir="${xdoclet.home}/lib">

         <includename="**/*.jar"/>

         </fileset>

         <filesetdir="${xdoclet.home}/plugins">

         <includename="**/*.jar"/>

         </fileset>

   </path>

    <taskdef

       name="xdoclet"

       classname="org.xdoclet.ant.XDocletTask"

       classpathref="xdoclet.task.classpath"

    />

   

    <targetname="生成Hibernate配置文件">

       <xdoclet>

           <filesetdir="${src.dir}/com/bjsxt/oa/model">

              <includename="**/*.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_200706"

              jdbcdriver="com.mysql.jdbc.Driver"

              jdbcusername="root"

              jdbcpassword="mysql"

              dialect="org.hibernate.dialect.MySQLDialect"

              showsql="true"

           />

       <span style='font-size: 10pt