[Hibernate]使用XDoclet生成hbm.xml

用XDoclet生成hbm.xml就是在.java檔案裡寫入一些中繼資料，XDoclet會從這些資料以及類本身得到足夠的資訊來生成目标檔案。當然，除了用于hibernate，XDoclet還可以用于web、ejb等等很多用途。

Hibernate真是受歡迎，有那麼多工具為它服務，XDoclet、MiddleGen、各種插件。。。

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