4．4 Ant and XDoclet

如果你仔细看了上边的代码，你会发现它有一点和我们以前的"不太一样"，它javadoc中多了许多特定的javadoc,是的，那是Hibernatedoclet。它和Xdoclet是"姊妹篇"，Xdoclet是这样一种工具：它通过和Apache Ant一起来产生应用程序的部署描述符。因此除非你乐意书写xml映射文件，否要就会用到xdoclet(但是我还是建议初学者还是要给自己些机会手写**.hbm.xml)。 进入查看hibernatedoclet的详细信息，下面我们看看，这里是如果利用对象来产生映射文件的，下面，看看build.xml：

<!-- this file uses Apache Ant 1.5.3 beta 1 -->

<project name="Hibernate Example" default="about" basedir=".">

<!-- The location where your xdoclet jar files reside -->

<property name="xdoclet.lib.home" value="c:/java_api/xdoclet-1.2b3/lib"/>


<target name="clean" depends="init" description="removes all directories related to this build">

<delete dir="${dist}"/>

</target>


<target name="init" description="Initializes properties that are used by other targets.">
<property name="dist" value="dist"/>
</target>

<target name="prepare" depends="init,clean" description="creates dist directory">
<echo message="Creating required directories..."/>
<mkdir dir="${dist}"/>
</target>

<target name="hibernate" depends="prepare"
description="Generates Hibernate class descriptor files.">
<taskdef name="hibernatedoclet" classname="xdoclet.modules.hibernate.HibernateDocletTask"> <classpath>
<fileset dir="${xdoclet.lib.home}">
<include name="*.jar"/>
</fileset>
</classpath>
</taskdef>

<!-- Execute the hibernatedoclet task -->

<hibernatedoclet
destdir="."
excludedtags="@version,@author,@todo"
force="true"
verbose="true"
mergedir="${dist}">

<fileset dir=".">
<include name="**/dbdemo/*.java"/>
</fileset>

<hibernate version="2.0"/>

</hibernatedoclet>
</target>

<target name="about" description="about this build file" depends="init">
<echo message=" Use this format for the arguments:"/>
<echo message=" ant hibernate"/>
<echo message=""/>
</target>

</project>


下面试运行时模拟的一个结果：

C:\eclipse\workspace\HibernateExample>ant hibernate
Buildfile: build.xml
init:
clean:
[delete] Deleting directory C:\eclipse\workspace\HibernateExample\dist
prepare:
[echo] Creating required directories...
[mkdir] Created dir: C:\eclipse\workspace\HibernateExample\dist

hibernate:
[hibernatedoclet] Running <hibernate/>
[hibernatedoclet] Generating mapping file for dbdemo.Contact.
[hibernatedoclet] Generating mapping file for dbdemo.Book.
[hibernatedoclet] Generating mapping file for dbdemo.Address.
[hibernatedoclet] Generating mapping file for dbdemo.User.
BUILD SUCCESSFUL
Total time: 2 seconds
C:\eclipse\workspace\HibernateExample>


接下来然我们看看，"生成"了什么样的映射文件（*.hbm.xml）:

<?xml version="1.0"?>

<!DOCTYPE hibernate-mapping PUBLIC

"-//Hibernate/Hibernate Mapping DTD//EN"

"http://hibernate.sourceforge.net/hibernate-mapping-2.0.dtd">

<hibernate-mapping>
<class
name="dbdemo.User"
table="Users"
>

<id
name="userID"
column="LogonID"
type="string"
>
<generator class="assigned">
</generator>
</id>

<one-to-one
name="address"
class="dbdemo.Address"
cascade="none"
outer-join="auto"
constrained="false"
/>

<set
name="books"
table="Book_User_Link"
lazy="false"
inverse="true"
cascade="all"
sort="unsorted"
>

<key
column="UserID"
>
</key>

<many-to-many
class="dbdemo.Book"
column="BookID"
/>

</set>

<set
name="contacts"
table="Contacts"
lazy="false"
inverse="true"
cascade="all"
sort="unsorted"
>
<key
column="User_ID"
>
</key>

<one-to-many
class="dbdemo.Contact"
/>

</set>

<property
name="emailAddress"
type="string"
column="EmailAddress"
not-null="false"
unique="false"
/>

<property
name="lastLogon"
type="date"
column="LastLogon"
not-null="false"
unique="false"
/>

<property
name="password"
type="string"
column="Password"
not-null="false"
unique="false"
/>

<property
name="userName"
type="string"
column="Name"
not-null="false"
unique="false"
/>

<!--
To add non XDoclet properties, create a file named
hibernate-properties-User.xml
containing the additional properties and place it in your merge dir.
-->

</class>

</hibernate-mapping>

一旦创建完映射文件（放在classpath 中，并且和对象是"一对一"关系），你就可以通过Hibernate的接口和方法来操纵系统对象。

最后说一下，本文中例子下载包中的内容，每一个单独的例子都有main方法来运行：第一个例子：HibernateDemo.java，增加两个users，并且和address相关联（"一对一"）；第二个例子：HibernateDemoOneToMany.java，学习用Hibernate进行"一对多"映射；最后，第三个例子：HibernateDemoManyToMany.java，学习用Hibernate进行"多对多"映射。建议你按照顺序运行，如果你没有使用DB2 (e.g. sequences).的话，你也可以跟改数据库。例子包中还有一个例子：HibernateDemoHQL利用前面的例子产生的数据来说明如何用HQL来操纵数据。

作者提供的例子中很简单，但对于初学者却是非常好的一个学习的机会（希望初学者对作者的代码进行运行尝试，有许多东西本文并没有说，不过你可以通过作者的代码得到答案）。希望你能在学习Hibernate的时候从此处得到些帮助。（全文完）