天天看點

hibernate 的hbm.xml配置

在Hibernate中,各表的映射檔案….hbm.xml可以通過工具生成,例如在使用MyEclipse開發時,它提供了自動生成映射檔案的工具。本節簡單的講述一下這些配置檔案的配置。

配置檔案的基本結構如下:

<?xml version="1.0" encoding='UTF-8'?>

<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN"

"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd" >

<hibernate-mapping package="包名">

<class name="類名" table="表名">

<id name="主鍵在java類中的字段名" column="對應表中字段" type="類型 ">

<generator class="主鍵生成政策" />

</id>

……

</class>

</hibernate-mapping>

1. 主鍵(id)Hibernate的主鍵生成政策有如下幾種:

1) assigned 主鍵由外部程式負責生成,在 save() 之前指定。

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 位 UUID 算法 生成16 進制數值(編碼後以長度32 的字元串表示)作為主鍵。

9)

uuid.string:與uuid.hex 類似,隻是生成的主鍵未進行編碼(長度16),不能應用在 PostgreSQL 資料庫中。

10)

foreign:使用另外一個相關聯的對象的辨別符作為主鍵。

主鍵配置舉例如下:

<id name="id" column="id" type="java.lang.Integer">

<generator class="native" />

</id>

另外還可以擴充Hibernate的類來做自己的主鍵生成政策,具體例子見:http://www.javaeye.com/topic/93391。

2.

普通屬性(property)開發人員可以打開網址:http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd

來檢視hibernate3.0的dtd資訊,可看到property的定義如下:

<!ELEMENT property (meta*,(column|formula)*,type?)>

<!ATTLIST property name CDATA #REQUIRED>

<!ATTLIST property node CDATA #IMPLIED>

<!ATTLIST property access CDATA #IMPLIED>

<!ATTLIST property type CDATA #IMPLIED>

<!ATTLIST property column CDATA #IMPLIED>

<!ATTLIST property length CDATA #IMPLIED>

<!ATTLIST property precision CDATA #IMPLIED>

<!ATTLIST property scale CDATA #IMPLIED>

<!ATTLIST property not-null (true|false) #IMPLIED>

<!ATTLIST property unique (true|false) "false">

<!ATTLIST property unique-key CDATA #IMPLIED>

<!ATTLIST property index CDATA #IMPLIED> <!-- include the columns spanned by this property in an index -->

<!ATTLIST property update (true|false) #IMPLIED>

<!ATTLIST property insert (true|false) #IMPLIED>

<!ATTLIST property optimistic-lock (true|false) "true">

<!-- only supported for properties of a class (not component) -->

<!ATTLIST property formula CDATA #IMPLIED>

<!ATTLIST property lazy (true|false) "false">

<!ATTLIST property generated (never|insert|always) "never">

它的各屬性中比較常用的有:name(對應的java類的屬性名稱)、column(對應的表中的字段)、tyope(屬性的類型,eg.java.lang.String)、not-null(設定該屬性是否為空,為true時表示非空,預設為false)和length(字段的長度限制)。

Eg1.

<property name="accessname" column="accessName" type="java.lang.String"

not-null="true" />

Eg2.

<property name="state" column="state" type="java.lang.Byte"

not-null="true" />

Eg3.

<property name="description" column="description" type="java.lang.String" />

3. 一對多關系(

<many-to-one … />

<set …></set>

一對多關系一般是用在一個表與另一個表存在外鍵關聯的時候,例如使用者表的組織id與組織表存在外鍵關聯,則“一”方為組織表,“多”方為使用者表,因為一個組織可以包含多個使用者,而一個使用者隻能隸屬于一個組織。

對于存在一對多關系和多對一關系的雙方,需要在…hbm.xml中進行相應配置,這時在“一”方(例如:組織)需要在映射檔案中添加

<set …></set>

元素,因為它包含多個“多”方的對象,一般的格式如下:

<set name="java映射類中對應的屬性" inverse="true" lazy="true">

<key column="表中對應字段" />

<one-to-many class="多方的類" />

</set>

Eg.

<set name="userSet" inverse="true" lazy="true">

<key column="orgId" />

<one-to-many class="User" />

</set>

“多”方(例如:使用者)隸屬于一個“一”方對象,一般的格式如下:

<many-to-one name="java映射類中對應的屬性" column="表中對應字段" class="類名"

not-null="true" />

Eg.

<many-to-one name="org" column="orgId" class="Organization"

not-null="true" />

4. 一對一關系(

<one-to-one … />

一對一關系相對一對多關系來說比較少見,但也在某些情況下要用到,例如有一個使用者的基本資訊表(USER)和一個使用者的密碼表(PASSWD)就存在一對一的關系。下面來看一下一對一關系在Hibernate的配置。

其中主表(eg. 使用者的基本資訊表)的配置如下:

<one-to-one name="主表對象中子表對象的屬性名" class="子表對象的類名" cascade="save-update" />

Eg.

<one-to-one name="password" class="com.amigo.dao.pojo.Passwd"

cascade="save-update" />

子表(eg. 使用者的密碼表)的配置如下:

<one-to-one name="子表對象中主表對象的屬性名" class="主表對象的類名" constrained="true" />

Eg.

<one-to-one name="user" class="com.amigo.dao.pojo.User "

constrained="true" />

5. 多對多關系(

<many-to-many … />

在資料庫設計時,一般将多對多關系轉換為兩個一對多(或多對一)關系,例如在基于角色的權限系統中,使用者和角色存在的關系就是典型的多對多關系,即一個使用者可以具有多個角色,而一個角色又可以為多個使用者所有,一般在設計時,都會加一個使用者與角色的關聯表,該表與使用者表以及角色表都存在外鍵關聯。

在本小節中講述的是沒有分解的多對多關系在Hibernate中如何配置。設定格式如下:

<set name="java對象的屬性名" table="表名" cascade="all" outer-join="false">

<key column="表的對應字段" />

<many-to-many class="另一個表的對象類" column="另一個表的字段" />

</set>

Eg. 上述的多對多關系可以表示為:

t_user方:

<set name="roleSet" table="t_user" cascade="all" outer-join="false">

<key column="roleId" />

<many-to-many class="com.amigo.dao.pojo.Role" column="roleId" />

</set>

t_role方:

<set name="userSet" table="t_role" cascade="all" outer-join="false">

<key column="roleId" />

<many-to-many class="com.amigo.dao.pojo.User" column="roleId" />

</set>

6. 完整執行個體

在本小節中舉一些.hbm.xml映射檔案的例子,讓開發人員對其有一個感性的認識。接下來講述一個使用者表(tbl_user)、使用者與角色關聯表(tbl_user_role)、角色表(tbl_role)以及組織表(tbl_organization)的例子。

(1)tbl_user

<?xml version="1.0" encoding='UTF-8'?>

<!DOCTYPE hibernate-mapping PUBLIC

"-//Hibernate/Hibernate Mapping DTD 3.0//EN"

"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd" >

<hibernate-mapping package="com.amigo.dao.pojo">

<class name="User" table="tbl_user">

<id name="loginname" column="loginName" type="java.lang.String">

<generator class="assigned" />

</id>

<property name="name" column="name" type="java.lang.String"

not-null="true" />

<property name="password" column="password" type="java.lang.String"

not-null="true" />

<property name="mobile" column="mobile" type="java.lang.String" />

<property name="telephone" column="telephone" type="java.lang.String" />

<property name="email" column="email" type="java.lang.String" />

<property name="createtime" column="createTime" type="java.util.Date"

not-null="true" />

<property name="lastlogintime" column="lastLoginTime" type="java.util.Date" />

<property name="logintimes" column="loginTimes" type="java.lang.Long"

not-null="true" />

<property name="state" column="state" type="java.lang.Byte"

not-null="true" />

<property name="description" column="description" type="java.lang.String" />

<many-to-one name="organization" column="orgId" class="Organization"

not-null="true" />

<set name="userRoleSet" inverse="true" cascade="all-delete-orphan"

lazy="true">

<key column="loginName" />

<one-to-many class="UserRole" />

</set>

</hibernate-mapping>

(2)tbl_organization

<?xml version="1.0" encoding='UTF-8'?>

<!DOCTYPE hibernate-mapping PUBLIC

"-//Hibernate/Hibernate Mapping DTD 3.0//EN"

"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd" >

<hibernate-mapping package="com.amigo.dao.pojo">

<class name="Organization" table="tbl_organization">

<id name="orgid" column="orgId" type="java.lang.Long">

<generator class="native" />

</id>

<property name="parentorgid" column="parentOrgId" type="java.lang.Long"

not-null="true" />

<property name="orgname" column="orgName" type="java.lang.String"

not-null="true" />

<property name="orgfullname" column="orgFullName" type="java.lang.String" />

<property name="orglevel" column="orgLevel" type="java.lang.Integer"

not-null="true" />

<property name="state" column="state" type="java.lang.Byte"

not-null="true" />

<property name="description" column="description" type="java.lang.String" />

<property name="creator" column="creator" type="java.lang.String" />

<property name="createtime" column="createTime" type="java.util.Date" />

<set name="userSet" inverse="true" lazy="true">

<key column="orgId" />

<one-to-many class="User" />

</set>

</class>

</hibernate-mapping>

(3)tbl_user_role

<?xml version="1.0" encoding='UTF-8'?>

<!DOCTYPE hibernate-mapping PUBLIC

"-//Hibernate/Hibernate Mapping DTD 3.0//EN"

"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd" >

<hibernate-mapping package="com.cotel.netvote.dao.model">

<class name="UserRole" table="tbl_user_role">

<id name="urid" column="urId" type="java.lang.Integer">

<generator class="native" />

</id>

<many-to-one name="role" column="roleId" class="Role"

not-null="true" />

<many-to-one name="user" column="loginName" class="User"

not-null="true" />

</class>

</hibernate-mapping>

(4)tbl_ role

<?xml version="1.0" encoding='UTF-8'?>

<!DOCTYPE hibernate-mapping PUBLIC

"-//Hibernate/Hibernate Mapping DTD 3.0//EN"

"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd" >

<hibernate-mapping package="com.cotel.netvote.dao.model">

<class name="Role" table="tbl_role">

<id name="roleid" column="roleId" type="java.lang.Integer">

<generator class="native" />

</id>

<property name="rolename" column="roleName" type="java.lang.String"

not-null="true" />

<property name="createdate" column="createDate" type="java.util.Date"

not-null="true" />

<property name="description" column="description" type="java.lang.String" />

<set name="userRoleSet" inverse="true" lazy="true" cascade="all">

<key column="roleId" />

<one-to-many class="UserRole" />

</set>

</class>

</hibernate-mapping>