所需工具: hibernate-2.1、Hibernate-extension、Middlegen-Hibernate
1. 映射(.*hbm)文件的生成
1.1 在數據庫中建表;
1.2 在Middlegen-Hibernate中配置數據庫連接文件及輸出目錄:
配置數據庫驗證文件:
(紅色部分為配置修改部分)
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--數據庫連接串
database.schema—數據庫的命名空間
D:\Middlegen-Hibernate\builder.xml
(1)指定我們配置好的數據庫驗證文件
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 根目錄下運行ant,就將出現MiddleGen的界面,依據需要對表進行設計.
可以看到,數據庫中的表結構已經導入到MiddleGen 的操作界面中,選定數據庫
表視圖中的表元素,我們即可調整各個數據庫表的屬性。
★ Domain Class Name
對應POJO 的類名
★ Key Generator
主鍵產生器
可選項說明:主鍵由外部程序負責生成,無需Hibernate參與。
2) hilo
通過hi/lo 算法實現的主鍵生成機制,需要額外的數據庫表保存主鍵生成歷史狀態。
3) seqhilo
與hilo 類似,通過hi/lo 算法實現的主鍵生成機制,只是主鍵歷史狀態保存在Sequence中,適用于支持Sequence的數據庫,如Oracle。
4) increment
主鍵按數值順序遞增。此方式的實現機制為在當前應用實例中維持一個變量,以保存著當前的最大值,之后每次需要生成主鍵的時候將此值加1作為主鍵。
這種方式可能產生的問題是:如果當前有多個實例訪問同一個數據庫,那么由于各個實例各自維護主鍵狀態,不同實例可能生成同樣的主鍵,從而造成主鍵重復異常。因此,如果同一數據庫有多個實例訪問,此方式必須避免使用。
5) identity
采用數據庫提供的主鍵生成機制。如DB2、SQL Server、MySQL
中的主鍵生成機制。
6) sequence
采用數據庫提供的sequence 機制生成主鍵。如Oralce 中的Sequence。
7) native
由Hibernate根據底層數據庫自行判斷采用identity、hilo、sequence其中一種作為主鍵生成方式。
8) uuid.hex
由Hibernate基于128 位唯一值產生算法生成16 進制數值(編碼后以長度32 的字符串表示)作為主鍵。
9) uuid.string
與uuid.hex 類似,只是生成的主鍵未進行編碼(長度16)。在某些數據庫中可能出現問題(如PostgreSQL)。
10) foreign
使用外部表的字段作為主鍵。一般而言,利用uuid.hex方式生成主鍵將提供最好的性能和數據庫平臺適應性。另外由于常用的數據庫,如Oracle、DB2、SQLServer、MySql 等,都提供了易用的主鍵生成機制(Auto-Increase 字段或者Sequence)。我們可以在數據庫提供的主鍵生成機制上,采用generator-class=native的主鍵生成方式。不過值得注意的是,一些數據庫提供的主鍵生成機制在效率上未必最佳,大量并發insert數據時可能會引起表之間的互鎖。數據庫提供的主鍵生成機制,往往是通過在一個內部表中保存當前主鍵狀
態(如對于自增型主鍵而言,此內部表中就維護著當前的最大值和遞增量),之后每次插入數據會讀取這個最大值,然后加上遞增量作為新記錄的主鍵,之
后再把這個新的最大值更新回內部表中,這樣,一次Insert操作可能導致數據
庫內部多次表讀寫操作,同時伴隨的還有數據的加鎖解鎖操作,這對性能產生
了較大影響。因此,對于并發Insert要求較高的系統,推薦采用uuid.hex 作為主鍵生成機制。
★3 如果需要采用定制的主鍵產生算法,則在此處配置主鍵生成器,主鍵生成器必須實現net.sf.hibernate.id.IdentifierGenerator 接口。
★4 Schema Name
數據庫Schema Name。
★5 Persister
自定義持久類實現類類名。如果系統中還需要Hibernate 之外的持久層實現機制,如通過存儲過程得到目標數據集,甚至從LDAP中獲取數據來填充我們的POJO。
★6 Enable proxies
是否使用代理(用于延遲加載[Lazy Loading])。
★7 Dynamic Update
如果選定,則生成Update SQL 時不包含未發生變動的字段屬性,這樣可以在一定程度上提升SQL執行效能。
★8 Mutable
類是否可變,默認為選定狀態(可變)。如果不希望應用程序對此類對應的數據記錄進行修改(如對于數據庫視圖),則可將取消其選定狀態,之后對此類的Delete和Update操作都將失效。
★9 Implement the Lifecyle interface
是否實現Lifecyle接口。Lifecyle接口提供了數據固化過程中的控制機制,通過實現Lifecyle接口,我們可以在數據庫操作中加入回調(Call Back)機制,如在數據庫操作之前,之后觸發指定操作。
★10 Implement the Validatable interface
是否實現Validatable接口。通過實現Validatable接口,我們可以在數據被
固化到數據庫表之前對其合法性進行驗證。值得注意的是,通過實現Lifecyle接口,我們同樣可以在數據操作之前驗證數據合法性,不同的是,Validatable 接口中定義的validate 方法可能會被調用多次,因此設計中應避免在Validatable 接口的validate 方法實現中加入業務邏輯的驗證。
2. POJO文件的生成
POJO 的生成工作可以通過Hibernate Extension 來完成,Hibernate Extension 的
tools\bin目錄下包含三個工具:
★ hbm2java.bat
根據映射文件生成對應的POJO。通過MiddleGen 我們已經得到了映射文件,
下一步就是通過hbm2java.bat工具生成對應的POJO。
★ class2hbm.bat
根據POJO class 生成映射文件,這個工具很少用到,這里也就不再詳細介紹。
★ddl2hbm.bat
由數據庫導出庫表結構,并生成映射文件以及POJO。這個功能與MiddleGen的功能重疊,但由于目前還不夠成熟(實際上已經被廢棄,不再維護),提供的功能也有限,所以我們還是采用MiddleGen生成映射文件,之后由hbm2java根據映射文件生成POJO 的方式。為了使用以上工具,首先我們需要配置一些參數,打開D:\Hibernate-extension\tools\bin\setenv.bat 文件,修改其中JDBC_DRIVER和HIBERNATE_HOME環境變量,使其指向我們的實際JDBC Driver文件和Hibernate所在目錄,如
set JDBC_DRIVER=c:\mysql\mysql.jar
set HIBERNATE_HOME=c:\hibernate
同時檢查一下環境變量CP中的各個項目中是否實際存在,特別是%CORELIB%下的jar文件,某些版本的發行包中,默認配置中的文件名與實際的文件名有所出入(如%CORELIB%\commons-logging.jar, 在Hibernate 發行包中,可能實際的文件名是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,根據MiddleGen生成的映射文件生成Java 代碼:打開Command Window,在D:\Hibernate-extension\tools\bin目錄下執行:
hbm2java d:\samples\org\hibernate\sample\*.xml --output=d:\samples\