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>
