這篇文章是上篇文章《
Eclipse快速上手Hibernate--1. 入門實例》的延續(xù),主要說的是如何利用Hbm映射文件產(chǎn)生普通的Java對象及數(shù)據(jù)表??梢詤⒖糎ibernate自帶的文檔《HIBERNATE - 符合Java習慣的關(guān)系數(shù)據(jù)庫持久化》的第15章--《工具箱指南》一節(jié)。同樣,這篇文章沒有過多談理論,只是給出了一個完整的實例加以說明。相關(guān)配置請參考
上篇文章。
1. 創(chuàng)建項目
· 新建一個Java項目:HibernateBegin_2,注意選中“創(chuàng)建單獨的源文件夾和輸出文件夾”,同時添加“用戶庫”:hibernate。
2. 映射文件User.hbm.xml
· 新建一個包,包名:javamxj.hibernate,然后在此包下新建一個文件,文件名:User.hbm.xml。
User.hbm.xml |
<?xml version="1.0" encoding="GBK"?><!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD//EN" "http://hibernate.sourceforge.net/hibernate-mapping-2.0.dtd"> <hibernate-mapping> <class name="javamxj.hibernate.User" table="UserTable2"> <meta attribute="class-description"> 運行 Hbm2Java 任務, 利用 hbm.xml文件生成Java類文件 @author javamxj(分享java快樂) @link Blog: htpp://javamxj.mblogger.cn htpp://blog.csdn.net/javamxj/ </meta> <id name="id" type="string" unsaved-value="null" length="32" column="ID"> <generator class="uuid.hex"/> </id> <property name="username" type="string" not-null="true" length="24"> <meta attribute="field-description">@param 用戶名</meta> </property> <property name="password" type="string" not-null="true" > <column name="密碼" length="24" not-null="true"></column> </property> </class></hibernate-mapping> |
● 與上篇文章中的User.hbm.xml文件比較,可以發(fā)現(xiàn)標簽上增加了許多額外的設定。
· 這里<meta>標簽中的內(nèi)容將插入到類的javadoc說明去。
· <id>標簽使用 uuid.hex 來定義主鍵的產(chǎn)生算法,UUID算法使用IP地址、JVM的啟動時間、系統(tǒng)時間和一個計數(shù)值來產(chǎn)生主鍵。
· <property>標簽中的<column>用于生成數(shù)據(jù)表中的列。
3. 構(gòu)建文件Build.xml
· 將上篇文章中的“hibernate.cfg.xml”配置文件復制到src目錄下。
· 在項目根目錄下建立一個build.xml,這個文件含有四個任務,這里會用到“generate-code”、“schemaexport”兩個任務,至于用法可以看注釋。要注意環(huán)境變量的設置要符合自己的實際配置,比如庫文件目錄的設置是"D:/java/Hibernate/lib",是沿用上篇文章中的設置。
<?xml version="1.0" encoding="GBK"?><project name="利用工具開發(fā)Hibernate" default="help" basedir="."> <!-- ****** 環(huán)境設置,可以根據(jù)自己的實際配置自行更改 ***** --> <!-- 源文件目錄, 可以通過 項目->屬性->Java構(gòu)建路徑 更改 --> <property name="src.dir" value="./src" /> <!-- 輸出的class文件目錄,可以通過 項目->屬性->Java構(gòu)建路徑 更改 --> <property name="class.dir" value="./bin" /> <!-- 庫文件目錄 --> <property name="lib.dir" value="D:/java/Hibernate/lib" /> <!-- 定義類路徑 --> <path id="project.class.path"> <fileset dir="${lib.dir}"> <include name="*.jar"/> </fileset> <pathelement location="${class.dir}" /> </path> <!-- ************************************************************** --> <!-- 使用說明 --> <!-- ************************************************************** --> <target name="help"> <echo message="利用工具開發(fā)Hibernate" /> <echo message="-----------------------------------" /> <echo message="" /> <echo message="提供以下任務:" /> <echo message="" /> <echo message="generate-code --> 運行Hbm2Java,利用 hbm.xml 文件生成Java類文件" /> <echo message="generate-hbm --> 運行HibernateDoclet,生成 Hibernate 類的映射文件" /> <echo message="schemaexport --> 運行SchemaExport,利用 hbm.xml 文件生成數(shù)據(jù)表" /> <echo message="" /> </target> <!-- ************************************************************** --> <!-- Hbm2Java 任務 --> <!-- ************************************************************** --> <target name="generate-code" > <echo message="運行 Hbm2Java 任務, 利用 hbm.xml 文件生成Java類文件"/> <taskdef name="hbm2java" classname="net.sf.hibernate.tool.hbm2java.Hbm2JavaTask" classpathref="project.class.path"> </taskdef> <hbm2java output="${src.dir}"> <fileset dir="${src.dir}"> <include name="**/*.hbm.xml"/> </fileset> </hbm2java> </target> <!-- ************************************************************** --> <!-- HibernateDoclet 任務 --> <!-- ************************************************************** --> <target name="generate-hbm" > <echo message="運行HibernateDoclet,生成 Hibernate 類的映射文件"/> <taskdef name="hibernatedoclet" classname="xdoclet.modules.hibernate.HibernateDocletTask" classpathref="project.class.path"> </taskdef> <hibernatedoclet destdir="${src.dir}" excludedtags="@version,@author,@todo" force="true" encoding="GBK" verbose="true"> <fileset dir="${src.dir}"> <include name="**/*.java"/> </fileset> <hibernate version="2.0" xmlencoding="GBK" /> </hibernatedoclet> </target> <!-- ************************************************************** --> <!-- SchemaExport 任務 --> <!-- ************************************************************** --> <target name="schemaexport"> <echo message="運行SchemaExport,利用 hbm.xml 文件生成數(shù)據(jù)表"/> <taskdef name="schemaexport" classname="net.sf.hibernate.tool.hbm2ddl.SchemaExportTask" classpathref="project.class.path"> </taskdef> <schemaexport config="${src.dir}/hibernate.cfg.xml" quiet="no" text="no" drop="no" output="schema-export.sql"> </schemaexport> </target></project>
· 最后的目錄結(jié)構(gòu)如下:
4. 運行任務
· 右擊“build.xml” ->“運行” ->這里應該有“Ant 構(gòu)建”和“Ant 構(gòu)建...”兩個菜單,其中“Ant 構(gòu)建”直接運行缺省任務,這里是指“help”任務;如果要運行其它的任務,可以通過“Ant 構(gòu)建...”菜單選擇。
· 這里還有一種更好的方法,Eclipse主菜單上點擊“窗口” ->“顯示視圖” ->點擊“Ant”,這樣就調(diào)出了Ant視圖,在這個視圖窗口的空白處,右擊,在彈出菜單中選擇“添加構(gòu)建文件”,然后將HibernateBegin_2項目根目錄下的“build.xml”文件載入即可。效果如圖:
這樣,想運行某個任務,直接雙擊Ant視圖中的任務即可。
● 生成User.java
· 雙擊“generate-code”任務,在控制臺應該可以看到如下輸出:
· 如果在src目錄下沒有看到“User.java”這個文件,那么選中src目錄,然后按一下“F5”功能鍵刷新一下src目錄,應該可以在包“javamxj.hibernate”下看到“User.java”。這個文件就是“Hbm2Java”生成器根據(jù)hbm文件產(chǎn)生的,如下:
package javamxj.hibernate;import java.io.Serializable;import org.apache.commons.lang.builder.ToStringBuilder;/** * * 運行 Hbm2Java 任務, 利用 hbm.xml文件生成Java類文件 * @author javamxj(分享java快樂) * @link Blog: htpp://javamxj.mblogger.cn * htpp://blog.csdn.net/javamxj/ * */public class User implements Serializable { /** identifier field */ private String id; /** persistent field */ private String username; /** persistent field */ private String password; /** full constructor */ public User(String username, String password) { this.username = username; this.password = password; } /** default constructor */ public User() { } public String getId() { return this.id; } public void setId(String id) { this.id = id; } /** * @param 用戶名 */ public String getUsername() { return this.username; } public void setUsername(String username) { this.username = username; } public String getPassword() { return this.password; } public void setPassword(String password) { this.password = password; } public String toString() { return new ToStringBuilder(this) .append("id", getId()) .toString(); }}
可以對照“User.hbm.xml”文件,看看都是哪些屬性轉(zhuǎn)化成什么代碼。
● 生成數(shù)據(jù)表
· 啟動MySql,應該確定含有HibernateTest數(shù)據(jù)庫,不過這次不需要建立數(shù)據(jù)表了。
· 雙擊“schemaexport”任務,控制臺輸出如下,注意自動生成的SQL語句:
· 同時,在項目根目錄下,也會產(chǎn)生一個“schema-export.sql”文件(如果沒有,按F5鍵刷新目錄),這個文件是在“build.xml”中設定的:
schema-export.sql |
drop table if exists UserTable2 create table UserTable2 ( ID varchar(32) not null, ddd varchar(24) not null, 密碼 varchar(24) not null, primary key (ID) ) |
· 切換到數(shù)據(jù)庫中,會發(fā)現(xiàn)已經(jīng)自動產(chǎn)生了數(shù)據(jù)表usertable2:
5. 測試程序
好了,將上篇文章中的test.java文件復制到包“javamxj.hibernate”下,然后右擊運行這個文件,可以看到數(shù)據(jù)表中生成的數(shù)據(jù)。
小結(jié)
好了,再來看看整個項目的結(jié)構(gòu),其中“User.java”和“schema-export.sql”兩個文件都是自動生成的,要注意的一點是:生成“schema-export.sql”文件需要調(diào)用“User.java”文件,所以“generate-code”任務要在“schemaexport”任務前執(zhí)行。
最好使用XMLBuddy插件來編輯xml文件,可以參考:
關(guān)于如何利用Hbm映射文件產(chǎn)生普通的Java對象及數(shù)據(jù)表,還需要多看看參考文檔,也要多加練習,在實踐中掌握,在實踐中前進。
下篇文章會談談利用XDoclet開發(fā)Hibernate。