所需工具: hibernate-2.1、Hibernate-extension、Middlegen-Hibernate
1. 映射(.*hbm)文件的生成
1.1 在數(shù)據(jù)庫中建表;
1.2 在Middlegen-Hibernate中配置數(shù)據(jù)庫連接文件及輸出目錄:
配置數(shù)據(jù)庫驗(yàn)證文件:
(紅色部分為配置修改部分)
D:\Middlegen-Hibernate-r5\config\database\oracle.xml
value="${src.dir}/sql/${name}-oracle.sql"/>
value="D:\oracle\ora90/jdbc/lib/classes12.jar"/>
value="${database.driver.file}"/>
value="oracle.jdbc.driver.OracleDriver"/>
value="jdbc:oracle:thin:@172.18.11.243:1521:JavaTest"/>
value="SecureAssess"/>
value=" SecureAssess "/>
value=" SecureAssess "/>
value=""/>
—property name="jboss.datasource.mapping" value="Oracle7"/-->
—property name="jboss.datasource.mapping" value="Oracle8"/-->
name="jboss.datasource.mapping" value="Oracle9i"/>
注: database.url--數(shù)據(jù)庫連接串
database.schema—數(shù)據(jù)庫的命名空間
D:\Middlegen-Hibernate\builder.xml
(1)指定我們配置好的數(shù)據(jù)庫驗(yàn)證文件
oracle.xml">
]>
value="d:samples "/>
destination="${build.gen-src.dir}"
package="org.hibernate.sample"http://在指定輸出目錄中生成文件包
genXDocletTags="true"http://在生成的.*hbm文件中包含Doclet供POJO使用
genIntergratedCompositeKeys="false" javaTypeMapper="middlegen.plugins.hibernate.HibernateJavaTypeMapper"
/>
配置完畢,在MiddleGen 根目錄下運(yùn)行ant,就將出現(xiàn)MiddleGen的界面,依據(jù)需要對(duì)表進(jìn)行設(shè)計(jì).
可以看到,數(shù)據(jù)庫中的表結(jié)構(gòu)已經(jīng)導(dǎo)入到MiddleGen 的操作界面中,選定數(shù)據(jù)庫
表視圖中的表元素,我們即可調(diào)整各個(gè)數(shù)據(jù)庫表的屬性。
★ Domain Class Name
對(duì)應(yīng)POJO 的類名
★ Key Generator
主鍵產(chǎn)生器
可選項(xiàng)說明:主鍵由外部程序負(fù)責(zé)生成,無需Hibernate參與。
2) hilo
通過hi/lo 算法實(shí)現(xiàn)的主鍵生成機(jī)制,需要額外的數(shù)據(jù)庫表保存主鍵生成歷史狀態(tài)。
3) seqhilo
與hilo 類似,通過hi/lo 算法實(shí)現(xiàn)的主鍵生成機(jī)制,只是主鍵歷史狀態(tài)保存在Sequence中,適用于支持Sequence的數(shù)據(jù)庫,如Oracle。
4) increment
主鍵按數(shù)值順序遞增。此方式的實(shí)現(xiàn)機(jī)制為在當(dāng)前應(yīng)用實(shí)例中維持一個(gè)變量,以保存著當(dāng)前的最大值,之后每次需要生成主鍵的時(shí)候?qū)⒋酥导?SPAN lang=EN-US>1作為主鍵。
這種方式可能產(chǎn)生的問題是:如果當(dāng)前有多個(gè)實(shí)例訪問同一個(gè)數(shù)據(jù)庫,那么由于各個(gè)實(shí)例各自維護(hù)主鍵狀態(tài),不同實(shí)例可能生成同樣的主鍵,從而造成主鍵重復(fù)異常。因此,如果同一數(shù)據(jù)庫有多個(gè)實(shí)例訪問,此方式必須避免使用。
5) identity
采用數(shù)據(jù)庫提供的主鍵生成機(jī)制。如DB2、SQL Server、MySQL
中的主鍵生成機(jī)制。
6) sequence
采用數(shù)據(jù)庫提供的sequence 機(jī)制生成主鍵。如Oralce 中的Sequence。
7) native
由Hibernate根據(jù)底層數(shù)據(jù)庫自行判斷采用identity、hilo、sequence其中一種作為主鍵生成方式。
8) uuid.hex
由Hibernate基于128 位唯一值產(chǎn)生算法生成16 進(jìn)制數(shù)值(編碼后以長(zhǎng)度32 的字符串表示)作為主鍵。
9) uuid.string
與uuid.hex 類似,只是生成的主鍵未進(jìn)行編碼(長(zhǎng)度16)。在某些數(shù)據(jù)庫中可能出現(xiàn)問題(如PostgreSQL)。
10) foreign
使用外部表的字段作為主鍵。一般而言,利用uuid.hex方式生成主鍵將提供最好的性能和數(shù)據(jù)庫平臺(tái)適應(yīng)性。另外由于常用的數(shù)據(jù)庫,如Oracle、DB2、SQLServer、MySql 等,都提供了易用的主鍵生成機(jī)制(Auto-Increase 字段或者Sequence)。我們可以在數(shù)據(jù)庫提供的主鍵生成機(jī)制上,采用generator-class=native的主鍵生成方式。不過值得注意的是,一些數(shù)據(jù)庫提供的主鍵生成機(jī)制在效率上未必最佳,大量并發(fā)insert數(shù)據(jù)時(shí)可能會(huì)引起表之間的互鎖。數(shù)據(jù)庫提供的主鍵生成機(jī)制,往往是通過在一個(gè)內(nèi)部表中保存當(dāng)前主鍵狀
態(tài)(如對(duì)于自增型主鍵而言,此內(nèi)部表中就維護(hù)著當(dāng)前的最大值和遞增量),之后每次插入數(shù)據(jù)會(huì)讀取這個(gè)最大值,然后加上遞增量作為新記錄的主鍵,之
后再把這個(gè)新的最大值更新回內(nèi)部表中,這樣,一次Insert操作可能導(dǎo)致數(shù)據(jù)
庫內(nèi)部多次表讀寫操作,同時(shí)伴隨的還有數(shù)據(jù)的加鎖解鎖操作,這對(duì)性能產(chǎn)生
了較大影響。因此,對(duì)于并發(fā)Insert要求較高的系統(tǒng),推薦采用uuid.hex 作為主鍵生成機(jī)制。
★3 如果需要采用定制的主鍵產(chǎn)生算法,則在此處配置主鍵生成器,主鍵生成器必須實(shí)現(xiàn)net.sf.hibernate.id.IdentifierGenerator 接口。
★4 Schema Name
數(shù)據(jù)庫Schema Name。
★5 Persister
自定義持久類實(shí)現(xiàn)類類名。如果系統(tǒng)中還需要Hibernate 之外的持久層實(shí)現(xiàn)機(jī)制,如通過存儲(chǔ)過程得到目標(biāo)數(shù)據(jù)集,甚至從LDAP中獲取數(shù)據(jù)來填充我們的POJO。
★6 Enable proxies
是否使用代理(用于延遲加載[Lazy Loading])。
★7 Dynamic Update
如果選定,則生成Update SQL 時(shí)不包含未發(fā)生變動(dòng)的字段屬性,這樣可以在一定程度上提升SQL執(zhí)行效能。
★8 Mutable
類是否可變,默認(rèn)為選定狀態(tài)(可變)。如果不希望應(yīng)用程序?qū)Υ祟悓?duì)應(yīng)的數(shù)據(jù)記錄進(jìn)行修改(如對(duì)于數(shù)據(jù)庫視圖),則可將取消其選定狀態(tài),之后對(duì)此類的Delete和Update操作都將失效。
★9 Implement the Lifecyle interface
是否實(shí)現(xiàn)Lifecyle接口。Lifecyle接口提供了數(shù)據(jù)固化過程中的控制機(jī)制,通過實(shí)現(xiàn)Lifecyle接口,我們可以在數(shù)據(jù)庫操作中加入回調(diào)(Call Back)機(jī)制,如在數(shù)據(jù)庫操作之前,之后觸發(fā)指定操作。
★10 Implement the Validatable interface
是否實(shí)現(xiàn)Validatable接口。通過實(shí)現(xiàn)Validatable接口,我們可以在數(shù)據(jù)被
固化到數(shù)據(jù)庫表之前對(duì)其合法性進(jìn)行驗(yàn)證。值得注意的是,通過實(shí)現(xiàn)Lifecyle接口,我們同樣可以在數(shù)據(jù)操作之前驗(yàn)證數(shù)據(jù)合法性,不同的是,Validatable 接口中定義的validate 方法可能會(huì)被調(diào)用多次,因此設(shè)計(jì)中應(yīng)避免在Validatable 接口的validate 方法實(shí)現(xiàn)中加入業(yè)務(wù)邏輯的驗(yàn)證。
2. POJO文件的生成
POJO 的生成工作可以通過Hibernate Extension 來完成,Hibernate Extension 的
tools\bin目錄下包含三個(gè)工具:
★ hbm2java.bat
根據(jù)映射文件生成對(duì)應(yīng)的POJO。通過MiddleGen 我們已經(jīng)得到了映射文件,
下一步就是通過hbm2java.bat工具生成對(duì)應(yīng)的POJO。
★ class2hbm.bat
根據(jù)POJO class 生成映射文件,這個(gè)工具很少用到,這里也就不再詳細(xì)介紹。
★ddl2hbm.bat
由數(shù)據(jù)庫導(dǎo)出庫表結(jié)構(gòu),并生成映射文件以及POJO。這個(gè)功能與MiddleGen的功能重疊,但由于目前還不夠成熟(實(shí)際上已經(jīng)被廢棄,不再維護(hù)),提供的功能也有限,所以我們還是采用MiddleGen生成映射文件,之后由hbm2java根據(jù)映射文件生成POJO 的方式。為了使用以上工具,首先我們需要配置一些參數(shù),打開D:\Hibernate-extension\tools\bin\setenv.bat 文件,修改其中JDBC_DRIVER和HIBERNATE_HOME環(huán)境變量,使其指向我們的實(shí)際JDBC Driver文件和Hibernate所在目錄,如
set JDBC_DRIVER=c:\mysql\mysql.jar
set HIBERNATE_HOME=c:\hibernate
同時(shí)檢查一下環(huán)境變量CP中的各個(gè)項(xiàng)目中是否實(shí)際存在,特別是%CORELIB%下的jar文件,某些版本的發(fā)行包中,默認(rèn)配置中的文件名與實(shí)際的文件名有所出入(如%CORELIB%\commons-logging.jar, 在Hibernate 發(fā)行包中,可能實(shí)際的文件名是commons-logging-1.0.3.jar,諸如此類).
配置文件如下:
@echo off
rem -------------------------------------------------------------------
rem Setup environment for hibernate tools
rem -------------------------------------------------------------------
set JDBC_DRIVER=D:\oracle\ora90\jdbc\lib\classes12.jar
set HIBERNATE_HOME=D:\hibernate-2.1
set HIBERNATETOOLS_HOME=D:\Hibernate-extension\tools
echo HIBERNATETOOLS_HOME set to %HIBERNATETOOLS_HOME%
if "%HIBERNATE_HOME%" == "" goto noHIBERNATEHome
set CORELIB=%HIBERNATE_HOME%\lib
set LIB=%HIBERNATETOOLS_HOME%\lib
set CP=%CLASSPATH%;%JDBC_DRIVER%;%HIBERNATE_HOME%\hibernate2.jar;%CORELIB%\commons-logging-1.0.4.jar;%CORELIB%\commons-lang-1.0.1.jar;%CORELIB%\cglib-full-2.0.2.jar;%CORELIB%\dom4j-1.4.jar;%CORELIB%\odmg-3.0.jar;%CORELIB%\xml-apis.jar;%CORELIB%\xerces-2.4.0.jar;%CORELIB%\xalan-2.4.0.jar;%LIB%\jdom.jar;%CORELIB%\commons-collections-2.1.1.jar;%LIB%\..\hibernate-tools.jar
if not "%HIBERNATE_HOME%" == "" goto end
:noHIBERNATEHome
echo HIBERNATE_HOME is not set. Please set HIBERNATE_HOME.
goto end
:end
使用hbm2java,根據(jù)MiddleGen生成的映射文件生成Java 代碼:打開Command Window,在D:\Hibernate-extension\tools\bin目錄下執(zhí)行:
hbm2java d:\samples\org\hibernate\sample\*.xml --output=d:\samples\