本文中將講述hibernate的基本配置及配置文件的應用,這對于正確熟練使用hibernate是相當關鍵的。
配置文件中映射元素詳解
對象關系的映射是用一個xml文檔來說明的。映射文檔可以使用工具來生成,如xdoclet,middlegen和andromda等。下面從一個映射的例子開始講解映射元素,映射文件的代碼如下。
<?xml version="1.0"?>
<!--
所有的xml映射文件都需要定義如下所示的doctype。
hibernate會先在它的類路徑(classptah)中搜索dtd文件。
-->
<!doctype hibernate-mapping public
"-//hibernate/hibernate mapping dtd 3.0//en"
"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
<!--
hibernate-mapping有幾個可選的屬性:
schema屬性指明了這個映射的表所在的schema名稱。
default-cascade屬性指定了默認的級聯風格 可取值有 none、save、update。
auto-import屬性默認讓我們在查詢語言中可以使用非全限定名的類名 可取值有 true、false。
package屬性指定一個包前綴。
-->
<hibernate-mapping schema="schemaname" default-cascade="none"
auto-import="true" package="test">
<!--用class元素來定義一個持久化類 -->
<class name="people" table="person">
<!-- id元素定義了屬性到數據庫表主鍵字段的映射。-->
<id name="id">
<!-- 用來為該持久化類的實例生成唯一的標識 -->
<generator class="native"/>
</id>
<!-- discriminator識別器 是一種定義繼承關系的映射方法-->
<discriminator column="subclass" type="character"/>
<!-- property元素為類聲明了一個持久化的,javabean風格的屬性-->
<property name="name" type="string">
<column name="name" length="64" not-null="true" />
</property>
<property name="sex"
not-null="true"
update="false"/>
<!--多對一映射關系-->
<many-to-one name="friend"
column="friend_id"
update="false"/>
<!--設置關聯關系-->
<set name="friends" inverse="true" order-by="id">
<key column="friend_id"/>
<!—一對多映射-->
<one-to-many class="cat"/>
</set>
</class>
</hibernate-mapping>
組件應用的方法
組件有兩種類型,即組件(component)和動態組件(dynamic-component)。在配置文件中,component元素為子對象的元素與父類對應表的字段建立起映射關系。然后組件可以聲明它們自己的屬性、組件或者集合。component元素的定義如下所示:
<component name="propertyname" class="classname" insert="true|false"
upate="true|false" access="field|property|classname">
<property ...../>
<many-to-one .... />
........
</component>
在這段代碼中,name是指屬性名,class是類的名字,insert指的是被映射的字段是否出現在sql的insert語句中,upate指出被映射的字段是否出現在sql的update語句中,access指出訪問屬性的策略。
hiebernate的基本配置
hibernate的數據庫連接信息是從配置文件中加載的。hibernate的配置文件有兩種形式:一種是xml格式的文件,一種是properties屬性文件。properties形式的配置文件默認文件名是hibernate.properties,一個properties形式的配置文件內容如下所示:
#指定數據庫使用的驅動類
hibernate.connection.driver_class = com.mysql.jdbc.driver r
#指定數據庫連接串
hibernate.connection.url = jdbc:mysql://localhost:3306/db
#指定數據庫連接的用戶名
hibernate.connection.username = user
#指定數據庫連接的密碼
hibernate.connection.password = password
#指定數據庫使用的方言
hibernate.dialect = net.sf.hibernate.dialect.mysqldialect
#指定是否打印sql語句
hibernate.show_sql=true
在配置文件中包含了一系列屬性的配置,hibernate將根據這些屬性來連接數據庫。
在xml格式的配置文件中,除了基本的hibernate配置信息,還可以指定具體的持久化類的映射文件,這可以避免將持久化類的配置文件硬編碼在程序中。xml格式的配置文件的默認文件名為hibernate.cfg.xml,一個xml配置文件的示例如下所示:
<?xml version='1.0' encoding='utf-8'?>
<!doctype hibernate-configuration public
"-//hibernate/hibernate configuration dtd 3.0//en"
"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">
<hibernate-configuration>
<session-factory>
<!--顯示執行的sql語句-->
<property name="show_sql">true</property>
<!--連接字符串-->
<property name="connection.url">jdbc:mysql://localhost:3306/stu</property>
<!--連接數據庫的用戶名-->
<property name="connection.username">root</property>
<!--數據庫用戶密碼-->
<property name="connection.password">root</property>
<!--數據庫驅動-->
<property name="connection.driver_class">com.mysql.jdbc.driver</property>
<!--選擇使用的方言-->
<property name="dialect">org.hibernate.dialect.mysqldialect</property>
<!--映射文件 -->
<mapping resource="com/stuman/domain/admin.hbm.xml" />
<!--映射文件-->
<mapping resource="com/stuman/domain/student.hbm.xml" />
</session-factory>
</hibernate-configuration>
properties形式的配置文件和xml格式的配置文件可以同時使用。當同時使用兩種類型的配置文件時,xml配置文件中的設置會覆蓋properties配置文件的相同的屬性。
對象標識符號
在關系數據庫表中,主鍵(primary key)用來識別記錄,并保證每條記錄的唯一性。在java語言中,通過比較兩個變量所引用對象的內存地址是否相同,或者比較兩個變量引用的對象值是否相同來判斷兩對象是否相等。hibernate為了解決兩者之間的不同,使用對象標識符(oid)來標識對象的唯一性。oid是關系數據庫中主鍵在java對象模型中的等價物。在運行時,hibernate根據oid來維持java對象和數據庫表中記錄的對應關系。如下代碼所示,三次調用了session的load()方法,分別加載oid為1或3的user對象。
transaction tx = session.begintransaction();
user user1 = (user)session.load(user.class,new long(1));
user user2 = (user)session.load(user.class,new long(1));
user user3 = (user)session.load(user.class,new long(3));
system.out.println( user1 == user2 );
system.out.println( user1 == user3 );
應用程序在執行上述代碼時,第一次加載oid為1的user對象,從數據庫中查找id為1的記錄,然后創建相應的user實例,并把它保存在session緩存中,最后將該實例的引用賦值給變量user1。第二次加載oid為1的對象時,直接把session緩存中oid為1的實例的引用賦值給變量user2。因此,表達式user1==user2的結果為true。
標識的生成可以使用不同的策略,表1為hibernate內置的標識生成策略。
表1 hibernate標識生成策略
標識符生成器
| 描述 |
| increment | 適用于代理主鍵。由hibernate自動以遞增方式生成。 |
| identity | 適用于代理主鍵。由底層數據庫生成標識符。 |
| sequence | 適用于代理主鍵。hibernate根據底層數據庫的序列生成標識符,這要求底層數據庫支持序列。 |
| hilo | 適用于代理主鍵。hibernate分局high/low算法生成標識符。 |
| seqhilo | 適用于代理主鍵。使用一個高/低位算法來高效的生成long,short或者int類型的標識符。 |
| native | 適用于代理主鍵。根據底層數據庫對自動生成標識符的方式,自動選擇identity、sequence或hilo。 |
| uuid.hex | 適用于代理主鍵。hibernate采用128位的uuid算法生成標識符。 |
uuid.string
| 適用于代理主鍵。uuid被編碼成一個16字符長的字符串。 |
| assigned | 適用于自然主鍵。由java應用程序負責生成標識符。 |
| foreign | 適用于代理主鍵。使用另外一個相關聯的對象的標識符。 |
hibernate映射類型
在對象/關系映射文件中,hibernate采用映射類型作為java類型和sql類型的橋梁。hibernate映射類型分為2種:內置映射類型和自定義映射類型。
1、內置映射類型
hibernate對所有的java原生類型、常用的java類型如string、date等都定義了內置的映射類型。表2列出了hibernate映射類型、對應的java類型以及對應的標準sql類型。
表2 hibernate內置映射類型
| hibernate映射類型 | java類型 | 標準sql類型 | 大小 |
| integer/int | java.lang.integer/int | integer | 4字節 |
| long | java.lang.long/long | bigint | 8字節 |
| short | java.lang.short/short | smallint | 2字節 |
| byte | java.lang.byte/byte | tinyint | 1字節 |
| float | java.lang.float/float | float | 4字節 |
| double | java.lang.double/double | double | 8字節 |
| big_decimal | java.math.bigdecimal | numeric | |
| character | java.lang.character/java.lang.string/char | char(1) | 定長字符 |
| string | java.lang.string | varchar | 變長字符 |
| boolean/ yes_no/true_false | java.lang.boolean/boolean | bit | 布爾類型 |
| date | java.util.date/java.sql.date | date | 日期 |
| timestamp | java.util.date/java.util.timestamp | timestamp | 日期 |
| calendar | java.util.calendar | timestamp | 日期 |
| calendar_date | java.util.calendar | date | 日期 |
| binary | byte[] | blob
| blob |
| text | java.lang.string | text | clob |
| serializable | 實現java.io.serializablej接口的任意java類 | blob | blob |
| clob | java.sql.clob | clob | clob |
| blob | java.sql.blob | blob | blob |
| class | java.lang.class | varchar | 定長字符 |
| locale | java.util.locale | varchar | 定長字符 |
| timezone | java.util.timezone | varchar | 定長字符 |
| currency | java.util.currency | varchar | 定長字符 |
2、自定義映射類型
hibernate提供了自定義映射類型接口,允許用戶以編程的方式創建自定義的映射類型。用戶自定義的映射類型需要實現net.sf.hibernate.usertype或net.sf.hibernate.compositeusertype接口。具體的創建自定義映射類型的方法請參考hibernate官方文檔或相關資料,這里不再詳細介紹。