這篇文章是上篇文章《
Eclipse快速上手Hibernate--1. 入門(mén)實(shí)例》的延續,主要說(shuō)的是如何利用Hbm映射文件產(chǎn)生普通的Java對象及數據表??梢詤⒖糎ibernate自帶的文檔《HIBERNATE - 符合Java習慣的關(guān)系數據庫持久化》的第15章--《工具箱指南》一節。同樣,這篇文章沒(méi)有過(guò)多談理論,只是給出了一個(gè)完整的實(shí)例加以說(shuō)明。相關(guān)配置請參考
上篇文章。
1. 創(chuàng )建項目
· 新建一個(gè)Java項目:HibernateBegin_2,注意選中“創(chuàng )建單獨的源文件夾和輸出文件夾”,同時(shí)添加“用戶(hù)庫”:hibernate。
2. 映射文件User.hbm.xml
· 新建一個(gè)包,包名:javamxj.hibernate,然后在此包下新建一個(gè)文件,文件名: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 任務(wù), 利用 hbm.xml文件生成Java類(lèi)文件 @author javamxj(分享java快樂(lè )) @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 用戶(hù)名</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ā)現標簽上增加了許多額外的設定。
· 這里<meta>標簽中的內容將插入到類(lèi)的javadoc說(shuō)明去。
· <id>標簽使用 uuid.hex 來(lái)定義主鍵的產(chǎn)生算法,UUID算法使用IP地址、JVM的啟動(dòng)時(shí)間、系統時(shí)間和一個(gè)計數值來(lái)產(chǎn)生主鍵。
· <property>標簽中的<column>用于生成數據表中的列。
3. 構建文件Build.xml
· 將上篇文章中的“hibernate.cfg.xml”配置文件復制到src目錄下。
· 在項目根目錄下建立一個(gè)build.xml,這個(gè)文件含有四個(gè)任務(wù),這里會(huì )用到“generate-code”、“schemaexport”兩個(gè)任務(wù),至于用法可以看注釋。要注意環(huán)境變量的設置要符合自己的實(shí)際配置,比如庫文件目錄的設置是"D:/java/Hibernate/lib",是沿用上篇文章中的設置。
<?xml version="1.0" encoding="GBK"?><project name="利用工具開(kāi)發(fā)Hibernate" default="help" basedir="."> <!-- ****** 環(huán)境設置,可以根據自己的實(shí)際配置自行更改 ***** --> <!-- 源文件目錄, 可以通過(guò) 項目->屬性->Java構建路徑 更改 --> <property name="src.dir" value="./src" /> <!-- 輸出的class文件目錄,可以通過(guò) 項目->屬性->Java構建路徑 更改 --> <property name="class.dir" value="./bin" /> <!-- 庫文件目錄 --> <property name="lib.dir" value="D:/java/Hibernate/lib" /> <!-- 定義類(lèi)路徑 --> <path id="project.class.path"> <fileset dir="${lib.dir}"> <include name="*.jar"/> </fileset> <pathelement location="${class.dir}" /> </path> <!-- ************************************************************** --> <!-- 使用說(shuō)明 --> <!-- ************************************************************** --> <target name="help"> <echo message="利用工具開(kāi)發(fā)Hibernate" /> <echo message="-----------------------------------" /> <echo message="" /> <echo message="提供以下任務(wù):" /> <echo message="" /> <echo message="generate-code --> 運行Hbm2Java,利用 hbm.xml 文件生成Java類(lèi)文件" /> <echo message="generate-hbm --> 運行HibernateDoclet,生成 Hibernate 類(lèi)的映射文件" /> <echo message="schemaexport --> 運行SchemaExport,利用 hbm.xml 文件生成數據表" /> <echo message="" /> </target> <!-- ************************************************************** --> <!-- Hbm2Java 任務(wù) --> <!-- ************************************************************** --> <target name="generate-code" > <echo message="運行 Hbm2Java 任務(wù), 利用 hbm.xml 文件生成Java類(lèi)文件"/> <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 任務(wù) --> <!-- ************************************************************** --> <target name="generate-hbm" > <echo message="運行HibernateDoclet,生成 Hibernate 類(lèi)的映射文件"/> <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 任務(wù) --> <!-- ************************************************************** --> <target name="schemaexport"> <echo message="運行SchemaExport,利用 hbm.xml 文件生成數據表"/> <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>
· 最后的目錄結構如下:
4. 運行任務(wù)
· 右擊“build.xml” ->“運行” ->這里應該有“Ant 構建”和“Ant 構建...”兩個(gè)菜單,其中“Ant 構建”直接運行缺省任務(wù),這里是指“help”任務(wù);如果要運行其它的任務(wù),可以通過(guò)“Ant 構建...”菜單選擇。
· 這里還有一種更好的方法,Eclipse主菜單上點(diǎn)擊“窗口” ->“顯示視圖” ->點(diǎn)擊“Ant”,這樣就調出了Ant視圖,在這個(gè)視圖窗口的空白處,右擊,在彈出菜單中選擇“添加構建文件”,然后將HibernateBegin_2項目根目錄下的“build.xml”文件載入即可。效果如圖:
這樣,想運行某個(gè)任務(wù),直接雙擊Ant視圖中的任務(wù)即可。
● 生成User.java
· 雙擊“generate-code”任務(wù),在控制臺應該可以看到如下輸出:
· 如果在src目錄下沒(méi)有看到“User.java”這個(gè)文件,那么選中src目錄,然后按一下“F5”功能鍵刷新一下src目錄,應該可以在包“javamxj.hibernate”下看到“User.java”。這個(gè)文件就是“Hbm2Java”生成器根據hbm文件產(chǎn)生的,如下:
package javamxj.hibernate;import java.io.Serializable;import org.apache.commons.lang.builder.ToStringBuilder;/** * * 運行 Hbm2Java 任務(wù), 利用 hbm.xml文件生成Java類(lèi)文件 * @author javamxj(分享java快樂(lè )) * @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 用戶(hù)名 */ 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”文件,看看都是哪些屬性轉化成什么代碼。
● 生成數據表
· 啟動(dòng)MySql,應該確定含有HibernateTest數據庫,不過(guò)這次不需要建立數據表了。
· 雙擊“schemaexport”任務(wù),控制臺輸出如下,注意自動(dòng)生成的SQL語(yǔ)句:
· 同時(shí),在項目根目錄下,也會(huì )產(chǎn)生一個(gè)“schema-export.sql”文件(如果沒(méi)有,按F5鍵刷新目錄),這個(gè)文件是在“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) ) |
· 切換到數據庫中,會(huì )發(fā)現已經(jīng)自動(dòng)產(chǎn)生了數據表usertable2:
5. 測試程序
好了,將上篇文章中的test.java文件復制到包“javamxj.hibernate”下,然后右擊運行這個(gè)文件,可以看到數據表中生成的數據。
小結
好了,再來(lái)看看整個(gè)項目的結構,其中“User.java”和“schema-export.sql”兩個(gè)文件都是自動(dòng)生成的,要注意的一點(diǎn)是:生成“schema-export.sql”文件需要調用“User.java”文件,所以“generate-code”任務(wù)要在“schemaexport”任務(wù)前執行。
最好使用XMLBuddy插件來(lái)編輯xml文件,可以參考:
關(guān)于如何利用Hbm映射文件產(chǎn)生普通的Java對象及數據表,還需要多看看參考文檔,也要多加練習,在實(shí)踐中掌握,在實(shí)踐中前進(jìn)。
下篇文章會(huì )談?wù)劺肵Doclet開(kāi)發(fā)Hibernate。