hibernate.hbm.xml文件配置入门小结（1）

在Hibernate中，各表的映射文件xxx.hbm.xml可以通过工具生成，例如在使用MyEclipse开发时，它提供了自动生成映射文件的工具。

hibernate.hbm.xml文件的基本结构如下：

1. 1   <?xml version="1.0" encoding='UTF-8'?>
2. 2
3. 3   <!DOCTYPE hibernate-mapping PUBLIC
4. 4        "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
5. 5        "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
6. 6   <hibernate-mapping package="包名">
7. 7      <class name="类名" table="表名">
8. 8         <id name="主键在java类中的字段名" column="对应表中字段" type="类型 ">
9. 9             <generator class="主键生成策略"/>
10. 10        </id>
11. 11
12. 12            ……
13. 13      </class>
14. 14  </hibernate-mapping>

1	<?xml version="1.0" encoding='UTF-8'?>
2
3	<!DOCTYPE hibernate-mapping PUBLIC
4	     "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
5	     "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
6	<hibernate-mapping package="包名">
7	   <class name="类名" table="表名">
8	      <id name="主键在java类中的字段名" column="对应表中字段" type="类型 ">
9	          <generator class="主键生成策略"/>
10	      </id>
11
12	          ……
13	    </class>
14	</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
使用另外一个相关联的对象的标识符作为主键。
主键配置举例如下：

Xml代码

1. <span style="white-space:pre">    </span><id name="id" column="id" type="java.lang.Integer">
2. <generator class="native"/>
3. </id>

<span style="white-space:pre">	</span><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的定义如下：

Xml代码

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

2        <!ATTLIST property nameCDATA #REQUIRED>

3        <!ATTLIST property nodeCDATA #IMPLIED>

4        <!ATTLIST property accessCDATA #IMPLIED>

5        <!ATTLIST property typeCDATA #IMPLIED>

6        <!ATTLIST property columnCDATA #IMPLIED>

7        <!ATTLIST property lengthCDATA #IMPLIED>

8        <!ATTLIST property precisionCDATA #IMPLIED>

9        <!ATTLIST property scaleCDATA #IMPLIED>

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

…………

它的各属性中比较常用的有：

name（对应的Java类的属性名称）

column（对应的表中的字段）

type（属性的类型，eg.java.lang.String）

not-null（设置该属性是否为空，为true时表示非空，默认为false）

length(字段的长度限制)。

示例如下：

Xml代码

1. 1   <property name="accessname" column="accessName" type="java.lang.String" not-null="true" />
2. <!--类属性名/对应一张表——表中字段——该字段属性类型——该字段是否为空-->
3. 2   <property name="state" column="state" type="java.lang.Byte" not-null="true" />
4. 3   <property name="description" column="description" type="java.lang.String" />

1	<property name="accessname" column="accessName" type="java.lang.String" not-null="true" />
	<!--类属性名/对应一张表——表中字段——该字段属性类型——该字段是否为空-->
2	<property name="state" column="state" type="java.lang.Byte" not-null="true" />
3	<property name="description" column="description" type="java.lang.String" /> 

3. 一对多关系（<many-to-one…/>和<set…></set>）

一对多关系一般是用在一个表与另一个表存在外键关联的时候，例如用户表的组织id与组织表存在外键关联，则“一”方为组织表，“多”方为用户表，因为一个组织可以包含多个用户，而一个用户只能隶属于一个组织。

对于存在一对多关系和多对一关系的双方，需要在…hbm.xml中进行相应配置，这时在“一”方（例如：组织）需要在映射文件中添加<set…></set>元素，因为它包含多个“多”方的对象，一般的格式如下：

Xml代码

1. 2   <set name="java映射类中对应的属性" inverse="true" lazy="true">
2. 3     <key column="表中对应字段"/>
3. 4        <one-to-many class="多方的类"/>
4. 5   </set>
5. 6
6. 7   <!-- 示例 -->
7. 8   <set name="userSet" inverse="true" lazy="true">
8. 9         <key column="orgId"/>
9. 10        <one-to-many class="User"/>
10. 11  </set>

2	<set name="java映射类中对应的属性" inverse="true" lazy="true">
3	  <key column="表中对应字段"/>
4	     <one-to-many class="多方的类"/>
5	</set>
6
7	<!-- 示例 -->
8	<set name="userSet" inverse="true" lazy="true">
9	      <key column="orgId"/>
10	      <one-to-many class="User"/>
11	</set>   

“多”方（例如：用户）隶属于一个“一”方对象，一般的格式如下：

xml代码

1. 2   <many-to-one name="java映射类中对应的属性" column="表中对应字段" class="类名" not-null="true" />
2. 3
3. 4   <!-- 示例 -->
4. 5   <many-to-one name="org" column="orgId" class="Organization" not-null="true" />

2	<many-to-one name="java映射类中对应的属性" column="表中对应字段" class="类名" not-null="true" />
3
4	<!-- 示例 -->
5	<many-to-one name="org" column="orgId" class="Organization" not-null="true" />

注：

1>set 元素

(1).name: 映射类属性的名字
      (2).table: 关联的目标数据库表
      (3).schema: 目标数据库表的schema名字
      (4).catalog: 目标数据库表的catalog名字
      (5).subselect: 定义一个子查询
      (6).sort: 设置排序的类型 默认值为 unsorted不排序 可选值为natural自然排序、comparatorClass实现接口类作为排序算法 避免与order-by同时使用
      (7).lazy: 是否采用延迟加载
      (8).inverse: 用于标识双向关联中被动的一方 默认值为false
      (9).cascade: 设置级联操作时的级联类型
      (10).mutable: 标识被关联对象是否可以改变 默认值为true
      (11).order-by: 设置排序规则
      (12).where: 增加筛选条件
      (13).batch-size: 延迟加载时，一次读取数据的数量 默认值为1
      (14).fetch: 设置抓取数据的策略 可选值为 join外连接抓取、select序列选择抓取
   2>list 元素（略）
   3>map 元素

4. 一对一关系（<one-to-one…/>）

一对一关系相对一对多关系来说比较少见，但也在某些情况下要用到，例如有一个用户的基本信息表（USER）和一个用户的密码表（PASSWD）就存在一对一的关系。下面来看一下一对一关系在Hibernate的配置。

Xml代码

1. 1   <!-- 其中主表（eg. 用户的基本信息表）的配置 -->
2. 2
3. 3   <one-to-one name="主表对象中子表对象的属性名" class="子表对象的类名" cascade="save-update"/>
4. 4
5. 5   <one-to-one name="password" class="com.amigo.dao.pojo.Passwd" cascade="save-update"/>
6. 6
7. 7   <!-- 子表（eg. 用户的密码表）的配置 -->
8. 8
9. 9   <one-to-one name="子表对象中主表对象的属性名" class="主表对象的类名" constrained="true" />
10. 10
11. 11  <one-to-one name="user" class="com.amigo.dao.pojo.User " constrained="true" />

1	<!-- 其中主表（eg. 用户的基本信息表）的配置 -->
2
3	<one-to-one name="主表对象中子表对象的属性名" class="子表对象的类名" cascade="save-update"/>
4
5	<one-to-one name="password" class="com.amigo.dao.pojo.Passwd" cascade="save-update"/>
6
7	<!-- 子表（eg. 用户的密码表）的配置 -->
8
9	<one-to-one name="子表对象中主表对象的属性名" class="主表对象的类名" constrained="true" />
10
11	<one-to-one name="user" class="com.amigo.dao.pojo.User " constrained="true" />

5. 多对多关系（<many-to-many…/>）

在数据库设计时，一般将多对多关系转换为两个一对多（或多对一）关系，例如在基于角色的权限系统中，用户和角色存在的关系就是典型的多对多关系，即一个用户可以具有多个角色，而一个角色又可以为多个用户所有，一般在设计时，都会加一个用户与角色的关联表，该表与用户表以及角色表都存在外键关联。

在本小节中讲述的是没有分解的多对多关系在Hibernate中如何配置。设置格式如下：

Xml代码

1. 1   <set name="java对象的属性名" table="表名" cascade="all" outer-join="false">
2. 2       <key column="表的对应字段"/>
3. 3       <many-to-many class="另一个表的对象类" column="另一个表的字段"/>
4. 4   </set>
5. 5
6. 6   <!-- t_user方 -->
7. 7   <set name="roleSet" table="t_user" cascade="all" outer-join="false">
8. 8       <key column="roleId"/>
9. 9       <many-to-many class="com.amigo.dao.pojo.Role" column="roleId"/>
10. 10  </set>
11. 11
12. 12  <!-- t_role方 -->
13. 13  <set name="userSet" table="t_role" cascade="all" outer-join="false">
14. 14      <key column="roleId"/>
15. 15      <many-to-many class="com.amigo.dao.pojo.User" column="roleId"/>
16. 16  </set>

1	<set name="java对象的属性名" table="表名" cascade="all" outer-join="false">
2	    <key column="表的对应字段"/>
3	    <many-to-many class="另一个表的对象类" column="另一个表的字段"/>
4	</set>
5
6	<!-- t_user方 -->
7	<set name="roleSet" table="t_user" cascade="all" outer-join="false">
8	    <key column="roleId"/>
9	    <many-to-many class="com.amigo.dao.pojo.Role" column="roleId"/>
10	</set>
11
12	<!-- t_role方 -->
13	<set name="userSet" table="t_role" cascade="all" outer-join="false">
14	    <key column="roleId"/>
15	    <many-to-many class="com.amigo.dao.pojo.User" column="roleId"/>
16	</set>

6. 完整实例

本小节中举一些.hbm.xml映射文件的例子，让大伙对其有一个感性的认识。接下来讲述一个用户表（tbl_user）、用户与角色关联表（tbl_user_role）、角色表（tbl_role）以及组织表（tbl_organization）的例子。

（1）用户表（tbl_user）——tbl_user.hbm.xml

1. 1   <?xml version="1.0" encoding='UTF-8'?>
2. 2
3. 3   <!DOCTYPE hibernate-mapping PUBLIC
4. 4             "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
5. 5          "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
6. 6
7. 7   <hibernate-mapping package="com.amigo.dao.pojo">
8. 8       <class name="User" table="tbl_user">
9. 9         <id name="loginname" column="loginName" type="java.lang.String">
10. 10            <generator class="assigned"/>
11. 11       </id>
12. 12       <property name="name" column="name" type="java.lang.String" not-null="true" />
13. 13       <property name="password" column="password" type="java.lang.String" not-null="true" />
14. 14       <property name="mobile" column="mobile" type="java.lang.String" />
15. 15       <property name="telephone" column="telephone" type="java.lang.String" />
16. 16       <property name="email" column="email" type="java.lang.String" />
17. 17       <property name="createtime" column="createTime" type="java.util.Date" not-null="true" />
18. 18       <property name="lastlogintime" column="lastLoginTime" type="java.util.Date" />
19. 19      <property name="logintimes" column="loginTimes" type="java.lang.Long" not-null="true" />
20. 20       <property name="state" column="state" type="java.lang.Byte" not-null="true" />
21. 21      <property name="description" column="description" type="java.lang.String" />
22. 22      <many-to-one name="organization" column="orgId" class="Organization" not-null="true" />  <!--一个组织有多个用户-->
23. 23      <set name="userRoleSet" inverse="true" cascade="all-delete-orphan" lazy="true">   <!--一一个用户表有多个用户--> </span>
24. 24          <key column="loginName"/>
25. 25          <one-to-many class="UserRole"/>
26. 26      </set>
27. 27  </hibernate-mapping>

1	<?xml version="1.0" encoding='UTF-8'?>
2
3	<!DOCTYPE hibernate-mapping PUBLIC
4	          "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
5	       "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
6
7	<hibernate-mapping package="com.amigo.dao.pojo">
8	    <class name="User" table="tbl_user">
9	      <id name="loginname" column="loginName" type="java.lang.String">
10	          <generator class="assigned"/>
11	     </id>
12	     <property name="name" column="name" type="java.lang.String" not-null="true" />
13	     <property name="password" column="password" type="java.lang.String" not-null="true" />
14	     <property name="mobile" column="mobile" type="java.lang.String" />
15	     <property name="telephone" column="telephone" type="java.lang.String" />
16	     <property name="email" column="email" type="java.lang.String" />
17	     <property name="createtime" column="createTime" type="java.util.Date" not-null="true" />
18	     <property name="lastlogintime" column="lastLoginTime" type="java.util.Date" />
19	    <property name="logintimes" column="loginTimes" type="java.lang.Long" not-null="true" />
20	     <property name="state" column="state" type="java.lang.Byte" not-null="true" />
21	    <property name="description" column="description" type="java.lang.String" />
22	    <many-to-one name="organization" column="orgId" class="Organization" not-null="true" />  <!--一个组织有多个用户-->
23	    <set name="userRoleSet" inverse="true" cascade="all-delete-orphan" lazy="true">   <!--一一个用户表有多个用户--> </span>
24	        <key column="loginName"/>
25	        <one-to-many class="UserRole"/>
26	    </set>
27	</hibernate-mapping>

（2）用户与角色关联表（tbl_user_role）——tbl_organization.hbm.xml

1. <?xml version="1.0" encoding='UTF-8'?>
2. 2
3. 3   <!DOCTYPE hibernate-mapping PUBLIC
4. 4             "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
5. 5          "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
6. 6
7. 7   <hibernate-mapping package="com.amigo.dao.pojo">
8. 8       <class name="User" table="tbl_user">
9. <!--主键-->
10. 9         <id name="loginname" column="loginName" type="java.lang.String">
11. 10            <generator class="assigned"/>
12. 11       </id>       <!--属性-->
13. 12       <property name="name" column="name" type="java.lang.String" not-null="true" />
14. 13       <property name="password" column="password" type="java.lang.String" not-null="true" />
15. 14       <property name="mobile" column="mobile" type="java.lang.String" />
16. 15       <property name="telephone" column="telephone" type="java.lang.String" />
17. 16       <property name="email" column="email" type="java.lang.String" />
18. 17       <property name="createtime" column="createTime" type="java.util.Date" not-null="true" />
19. 18       <property name="lastlogintime" column="lastLoginTime" type="java.util.Date" />
20. 19      <property name="logintimes" column="loginTimes" type="java.lang.Long" not-null="true" />
21. 20       <property name="state" column="state" type="java.lang.Byte" not-null="true" />
22. 21      <property name="description" column="description" type="java.lang.String" />
23. <!--表之间关系，一个组织有多个用户-->
24. 22      <many-to-one name="organization" column="orgId" class="Organization" not-null="true" />
25. <!--一个用户可以有多个身份角色-->
26. 23      <set name="userRoleSet" inverse="true" cascade="all-delete-orphan" lazy="true">
27. 24          <key column="loginName"/>
28. 25          <one-to-many class="UserRole"/>
29. 26      </set>
30. 27  </hibernate-mapping>

<?xml version="1.0" encoding='UTF-8'?>
2
3	<!DOCTYPE hibernate-mapping PUBLIC
4	          "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
5	       "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
6
7	<hibernate-mapping package="com.amigo.dao.pojo">
8	    <class name="User" table="tbl_user">
		<!--主键-->
9	      <id name="loginname" column="loginName" type="java.lang.String">
10	          <generator class="assigned"/>
11	     </id>       <!--属性-->
12	     <property name="name" column="name" type="java.lang.String" not-null="true" />
13	     <property name="password" column="password" type="java.lang.String" not-null="true" />
14	     <property name="mobile" column="mobile" type="java.lang.String" />
15	     <property name="telephone" column="telephone" type="java.lang.String" />
16	     <property name="email" column="email" type="java.lang.String" />
17	     <property name="createtime" column="createTime" type="java.util.Date" not-null="true" />
18	     <property name="lastlogintime" column="lastLoginTime" type="java.util.Date" />
19	    <property name="logintimes" column="loginTimes" type="java.lang.Long" not-null="true" />
20	     <property name="state" column="state" type="java.lang.Byte" not-null="true" />
21	    <property name="description" column="description" type="java.lang.String" />
		<!--表之间关系，一个组织有多个用户-->
22	    <many-to-one name="organization" column="orgId" class="Organization" not-null="true" />
		<!--一个用户可以有多个身份角色-->
23	    <set name="userRoleSet" inverse="true" cascade="all-delete-orphan" lazy="true">
24	        <key column="loginName"/>
25	        <one-to-many class="UserRole"/>
26	    </set>
27	</hibernate-mapping>  

（3）角色表（tbl_role）——tbl_user_role.hbm.xml

1. <pre name="code" class="html"><span style="font-family: Arial, Helvetica, sans-serif;">1    <?xml version="1.0" encoding='UTF-8'?>   </span>
2. 2   <!DOCTYPE hibernate-mapping PUBLIC
3. 3                               "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
4. 4                               "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd" >
5. 5   <hibernate-mapping package="com.cotel.netvote.dao.model">
6. <!--表名——主键-->
7. 6       <class name="UserRole" table="tbl_user_role">
8. 7           <id name="urid" column="urId" type="java.lang.Integer">
9. 8               <generator class="native"/>
10. 9           </id>
11. <!--表间关系，多个角色身份对应一个用户-->
12. 10          <many-to-one name="role" column="roleId" class="Role" not-null="true" />
13. 11          <many-to-one name="user" column="loginName" class="User" not-null="true" />
14. 12      </class>
15. 13  </hibernate-mapping>

<pre name="code" class="html"><span style="font-family: Arial, Helvetica, sans-serif;">1	<?xml version="1.0" encoding='UTF-8'?>   </span>
2	<!DOCTYPE hibernate-mapping PUBLIC
3	                            "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
4	                            "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd" >
5	<hibernate-mapping package="com.cotel.netvote.dao.model">
		<!--表名——主键-->
6	    <class name="UserRole" table="tbl_user_role">
7	        <id name="urid" column="urId" type="java.lang.Integer">
8	            <generator class="native"/>
9	        </id>
	<!--表间关系，多个角色身份对应一个用户-->
10	        <many-to-one name="role" column="roleId" class="Role" not-null="true" />
11	        <many-to-one name="user" column="loginName" class="User" not-null="true" />
12	    </class>
13	</hibernate-mapping>

（4）组织表（tbl_organization）——tbl_ role.hbm.xml

1. <?xml version="1.0" encoding='UTF-8'?>
2. 2   <!DOCTYPE hibernate-mapping PUBLIC
3. 3                               "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
4. 4                               "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd" >
5. 5   <hibernate-mapping package="com.cotel.netvote.dao.model">
6. 6        <!--表名Role，主键roleid-->
7. <class name="Role" table="tbl_role">
8. 7           <id name="roleid" column="roleId" type="java.lang.Integer">
9. 8               <generator class="native"/>
10. 9           </id>
11. <!--普通属性-->
12. 10          <property name="rolename" column="roleName" type="java.lang.String" not-null="true" />
13. 11          <property name="createdate" column="createDate" type="java.util.Date" not-null="true" />
14. 12          <property name="description" column="description" type="java.lang.String" />
15. <!--一个组织对应多个用户-->
16. 13          <set name="userRoleSet" inverse="true" lazy="true" cascade="all">
17. 14              <key column="roleId"/>
18. 15              <one-to-many class="UserRole"/>
19. 16          </set>
20. 17      </class>
21. 18  </hibernate-mapping>
22. 19