在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>