用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的包都去掉，竟然就成功了。其實現在也不明白為什么會這樣。。。