[Hibernate]使用XDoclet生成hbm.xml

用XDoclet生成hbm.xml就是在.java文件里写入一些元数据，XDoclet会从这些数据以及类本身得到足够的信息来生成目标文件。当然，除了用于hibernate，XDoclet还可以用于web、ejb等等很多用途。

XDoclet要从sourceforge上下载，包含了很多jar包、文档和例子，我觉得文档做得还是不错的，查起来比较方便。要使用XDoclet，一般要通过ant来完成，也就是在ant脚本里加入XDoclet的内容。

由于eclipse已经包含了ant支持，因此我没有专门去下载一个ant回来，而是直接使用eclipse带的，版本是1.5.3。

创建一个名为build.xml的脚本（其实应该换个名，比如gen-hbm.xml，看起来比较明白），内容如下：

<?xml version="1.0" encoding="ISO-8859-1"?>

<project name="XDoclet Examples" default="hibernate" basedir=".">

<property name="xdoclet.root.dir" value="c:/xdoclet-1.2.1"/>

<property name="xdoclet.lib.dir" value="${xdoclet.root.dir}/lib"/>

<path id="myclasspath">

<fileset dir="${xdoclet.lib.dir}">

<include name="*.jar"/>

</fileset>

</path>

<taskdef

name="hibernatedoclet"

classname="xdoclet.modules.hibernate.HibernateDocletTask"

classpathref="myclasspath"

/>

<target name="hibernate" description="Generate mapping documents">

<echo>+---------------------------------------------------+</echo>

<echo>| |</echo>

<echo>| R U N N I N G H I B E R N A T E D O C L E T |</echo>

<echo>| |</echo>

<echo>+---------------------------------------------------+</echo>

<hibernatedoclet

destdir="./src"

excludedtags="@version,@author,@todo,@see"

addedtags="@xdoclet-generated at ${TODAY},@copyright The XDoclet Team,@author XDoclet,@version ${version}"

force="false"

verbose="true">

<fileset dir="./src">

<include name="org/haree/struts/form/UserForm.java"/>

</fileset>

<hibernate version="2.0"/>

</hibernatedoclet>

</target>

</project>

我曾经卡住的一个地方就是在taskdef里的classpathref属性。一开始我在eclipse的ant运行参数里设置了XDoclet相关的包，总是提示：

Can't create a hibernate element under hibernatedoclet. Make sure
the jar file containing the corresponding subtask class is on the
classpath specified in the <taskdef> that defined {2}.

后来如上设置了classpathref，即包含了XDoclet使用到的包，并将eclipse的ant里关于XDoclet的包都去掉，竟然就成功了。其实现在也不明白为什么会这样。。。

++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

<?xml version="1.0" encoding="UTF-8"?>

<project name="XDoclet-Elms" default="hibernate" basedir=".">

<property name="xdoclet.root.dir" value="D:/xdoclet-1.2.2"/>

<property name="xdoclet.lib.dir" value="${xdoclet.root.dir}/lib"/>

<path id="x-classpath">

<fileset dir="${xdoclet.lib.dir}">

<include name="*.jar"/>

</fileset>

</path>

<taskdef

name="hibernatedoclet"

classname="xdoclet.modules.hibernate.HibernateDocletTask"

classpathref="x-classpath"

/>

<target name="hibernate" description="Generate pojos's mapping xml">

<hibernatedoclet

destdir="./src/java"

excludedtags="@version,@author,@todo,@see"

addedtags="@xdoclet-generated at ${TODAY},@copyright The XDoclet Team,@author XDoclet,@version ${version}"

force="false"

verbose="true">

<fileset dir="./src/java">

<include name="com/beida/jbedu/exam/pojos/examination/*.java"/>

</fileset>

<hibernate version="2.0"/>

</hibernatedoclet>

</target>

</project>