Hibernate配置文件与映射文件详解

Hibernate是一个彻底的ORM(Object Relational Mapping,对象关系映射)开源框架。

我们先看一下官方文档所给出的，Hibernate 体系结构的高层视图：

其中PO=POJO+映射文件

根据体系结构视图可以了解到整个利用Hibernate框架实现的项目包括整个重要的配置文件：

Hibernate配置文件：实现Hibernate基础配置，是Hibernate能够友好的与DB进行交互基础；

                           开发时放置src目录下,取名为：hibernate.cfg.xml(hibernate.properties)

Hibernate映射文件：实现POJO与DB表格的映射配置；

                             为了维护方便一般将其放置和相对应的POJO同一目录下，取名为POJOName.hbm.xml。虽然一个映射文件中可以配置多个POJO与数据库表的映射关系但是还是建议一个映射文件中只配置一个POJO与数据库表的映射关系。

一、Hibernate配置文件详解

Hibernate配置文件有两种形式：XML与properties 

个人建议使用XML,因为properties中不能配置关联的映射文件，在后续的实现中会带来一些没必要的编码；

XML（hibernate.cfg.xml）文件详解：

[html] view plain copy

1. <?xml version="1.0" encoding="GBK"?>  
2. <!-- 指定Hibernate配置文件的DTD信息 -->  
3. <!DOCTYPE hibernate-configuration PUBLIC  
4.     "-//Hibernate/Hibernate Configuration DTD 3.0//EN"  
5.     "http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">  
6. <!-- hibernate- configuration是连接配置文件的根元素 -->  
7. <hibernate-configuration>  
8.     <session-factory>  
9.         <!-- 指定连接数据库所用的驱动 -->  
10.         <property name="connection.driver_class">com.mysql.jdbc.Driver</property>  
11.         <!-- 指定连接数据库的url，hibernate连接的数据库名 -->  
12.         <property name="connection.url">jdbc:mysql://localhost/数据库名</property>  
13.         <!-- 指定连接数据库的用户名 -->  
14.         <property name="connection.username">root</property>  
15.         <!-- 指定连接数据库的密码 -->  
16.         <property name="connection.password">32147</property>  
17.         <!-- 指定连接池里最大连接数 -->  
18.         <property name="hibernate.c3p0.max_size">20</property>  
19.         <!-- 指定连接池里最小连接数 -->  
20.         <property name="hibernate.c3p0.min_size">1</property>  
21.         <!-- 指定连接池里连接的超时时长 -->  
22.         <property name="hibernate.c3p0.timeout">5000</property>  
23.         <!-- 指定连接池里最大缓存多少个Statement对象 -->  
24.         <property name="hibernate.c3p0.max_statements">100</property>  
25.         <property name="hibernate.c3p0.idle_test_period">3000</property>  
26.         <property name="hibernate.c3p0.acquire_increment">2</property>  
27.         <property name="hibernate.c3p0.validate">true</property>  
28.         <!-- 指定数据库方言 -->  
29.         <property name="dialect">org.hibernate.dialect.MySQLInnoDBDialect</property>  
30.         <!-- 根据需要自动创建数据表 -->  
31.         <property name="hbm2ddl.auto">update</property>  
32.         <!-- 显示Hibernate持久化操作所生成的SQL -->  
33.         <property name="show_sql">true</property>  
34.         <!-- 将SQL脚本进行格式化后再输出 -->  
35.         <property name="hibernate.format_sql">true</property>  
36.         <!-- 罗列所有的映射文件 -->  
37.         <mapping resource="映射文件路径/News.hbm.xml"/>  
38.     </session-factory>  
39. </hibernate-configuration>  

properties（hibernate.properties）文件详解

[html] view plain copy

1. ## MySQL  
2. #方言  
3. hibernate.dialect org.hibernate.dialect.MySQLDialect  
4. hibernate.dialect org.hibernate.dialect.MySQLInnoDBDialect  
5. hibernate.dialect org.hibernate.dialect.MySQLMyISAMDialect  
6. #驱动  
7. hibernate.connection.driver_class com.mysql.jdbc.Driver  
8. #数据库地址  
9. hibernate.connection.url jdbc:mysql://127.0.0.1/datdabseName  
10. #用户名  
11. hibernate.connection.username root  
12. #密码  
13. hibernate.connection.password 12345  
14. #是否在控制台输出sql语句  
15. hibernate.show_sql true/false  
16. #设置当创建sessionfactory时，是否根据映射文件自动建立数据库表。 create-drop:表示关闭sessionFactory时，将drop刚建的数据库表。该属性可以是update/create-drop/create  
17. hibernate.hbm2ddl.auto update/create-drop/create  
18.   
19. ###########################  
20. ### C3P0 Connection Pool C3P0连接池###  
21. ###########################  
22. #连接池最大链接数  
23. hibernate.c3p0.max_size 2  
24. #连接池最小连接数  
25. hibernate.c3p0.min_size 2  
26. #连接池连接的超时时长  
27. hibernate.c3p0.timeout 5000  
28. #缓存statements 的数量  
29. hibernate.c3p0.max_statements 100  
30. hibernate.c3p0.idle_test_period 3000  
31. hibernate.c3p0.acquire_increment 2  
32. hibernate.c3p0.validate true/false  
33.   
34.   
35. ############  
36. ### JNDI (java naming directory interface)Java命名目录接口###  
37. ###当无需hibernate自己管理数据源而是直接访问容器管理数据源 使用JNDI  
38. ############  
39. #指定数据源JNDI名字  
40. hibernate.connection.datasource dddd  
41. #文件系统下  
42. hibernate.jndi.class com.sun.jndi.fscontext.RefFSContextFactory  
43. hibernate.jndi.url file:/  
44.   
45. #网络  
46. #指定JND InitialContextFactory 的实现类，该属性也是可选的。如果JNDI与Hibernate持久化访问的代码处于同一个应用，无需指定该属性  
47. hibernate.jndi.class com.ibm.websphere.naming.WsnInitialContextFactory  
48. #指定JNDI提供者的URL，该属性可选 如果JNDI与Hibernate持久化访问的代码处于同一个应用，无需指定该属性  
49. hibernate.jndi.url iiop://localhost:900/  
50.   
51. #指定链接数据库用户名  
52. hibernate.connection.username  root  
53. #指定密码  
54. hibernate.connection.password  1111  
55. #指定方言  
56. hibernate.dialect org.hibernate.dialect.MySQLDialect  
57.   
58. #######################  
59. ### Transaction API   事务属性说明###  
60. #######################  
61.   
62. #指定是否在事务结束后自动关闭session   
63. hibernate.transaction.auto_close_session true/false  
64. #指定session是否在事务完成后自动将数据刷新到底层数据库  
65. hibernate.transaction.flush_before_completion true/false  
66.   
67. ## 指定hibernate所有的事务工厂的类型，该属性必须是TransactionFactory的直接或间接子类  
68.   
69. hibernate.transaction.factory_class org.hibernate.transaction.JTATransactionFactory  
70. hibernate.transaction.factory_class org.hibernate.transaction.JDBCTransactionFactory  
71.   
72. ## 该属性值是一个JNDI名，hibernate将使用JTATTransactionFactory从应用服务器中取出JTAYserTransaction  
73.   
74. jta.UserTransaction jta/usertransaction  
75. jta.UserTransaction javax.transaction.UserTransaction  
76. jta.UserTransaction UserTransaction  
77.   
78. ## 该属性值为一个transactionManagerLookup类名，当使用JVM级别的缓存时，或在JTA环境中使用hilo生成器策略时，需要该类  
79.   
80. hibernate.transaction.manager_lookup_class org.hibernate.transaction.JBossTransactionManagerLookup  
81. hibernate.transaction.manager_lookup_class org.hibernate.transaction.WeblogicTransactionManagerLookup  
82. hibernate.transaction.manager_lookup_class org.hibernate.transaction.WebSphereTransactionManagerLookup  
83. hibernate.transaction.manager_lookup_class org.hibernate.transaction.OrionTransactionManagerLookup  
84. hibernate.transaction.manager_lookup_class org.hibernate.transaction.ResinTransactionManagerLookup  

二、映射文件详解

由于篇幅，这里值详细对最基础配置进行说明

[html] view plain copy

1. <?xml version="1.0"?>  
2. <!DOCTYPE hibernate-mapping PUBLIC   
3.     "-//Hibernate/Hibernate Mapping DTD 3.0//EN"  
4.     "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">      
5. <!--   
6.     <hibernate-mapping>一般不去配置，采用默认即可。  
7.     schema:指定映射数据库的schema(模式/数据库)，如果指定该属性，则表名会自动添加该schema前缀  
8.     package:指定包前缀 指定持久化类所在的包名 这样之后calss子元素中就不必使用全限定性的类名  
9.     default-cascade="none"：默认的级联风格，表与表联动。  
10.     default-lazy="true"：默认延迟加载  
11.  -->  
12. <hibernate-mapping>  
13.     <!--   
14.         <class>：使用class元素定义一个持久化类。  
15.         name="cn.javass.user.vo.UserModel"：持久化类的java全限定名；  
16.         table="tbl_user"：对应数据库表名，默认持久化类名作为表名；  
17.         proxy:指定一个接口，在延迟装载时作为代理使用，也可在这里指定该类自己的名字。  
18.         mutable="true"：默认为true，设置为false时则不可以被应用程序更新或删除，等价于所有<property>元素的update属性为false，表示整个实例不能被更新。  
19.         dynamic-insert="false"：默认为false，动态修改那些有改变过的字段，而不用修改所有字段；  
20.         dynamic-update="false"：默认为false，动态插入非空值字段；  
21.         select-before-update="false"：默认为false，在修改之前先做一次查询，与用户的值进行对比，有变化都会真正更新；  
22.         optimistic-lock="version"：默认为version(检查version/timestamp字段)，取值：all(检查全部字段)、dirty(只检查修改过的字段)；  
23.                                    none(不使用乐观锁定)，此参数主要用来处理并发，每条值都有固定且唯一的版本，版本为最新时才能执行操作；  
24.         如果需要采用继承映射，则class元素下还会增加<subclass.../>元素等用于定义子类。  
25.      -->  
26.     <class name="cn.javass.user.vo.UserModel" table="tbl_user" >  
27.           
28.         <!--   
29.             <id>：定义了该属性到数据库表主键字段的映射。  
30.             type  指定该标识属性的数据类型，该类型可以是Hibernate的内建类型，也可以是java类型，如果是java类型则需要使用全限定类名（带包名）。该属性可选，如果没有指定类型， 则hibernate自行判断该标识属性数据类型。通常建议设定。  
31.             name="userId"：标识属性的名字；  
32.             column="userId"：表主键字段的名字，如果不填写与name一样；  
33.               
34.          -->  
35.         <id name="userId">  
36.             <!-- <generator>：指定主键由什么生成，推荐使用uuid，assigned指用户手工填入。设定标识符生成器  
37.             适应代理主键的有：  
38.                 increment：有Hibernat自动以递增的方式生成标识符，每次增量1；  
39.                 identity：由底层数据库生成标识符，前提条件是底层数据库支持自动增长字段类型。（DB2,MYSQL）  
40.                 uuid:用128位的UUID算法生成字符串类型标识符。  
41.             适应自然主键：  
42.                 assigned:由java程序负责生成标识符，为了能让java应用程序设置OID,不能把setId（）方法设置成private类型。  
43.                 让应用程序在save()之前为对象分配一个标识符。相当于不指定<generator.../>元素时所采用的默认策略。  
44.                 应当尽量避免自然主键  
45.             -->  
46.             <generator class="uuid"/>  
47.         </id>  
48.           
49.         <!--   
50.             <version/>：使用版本控制来处理并发，要开启optimistic-lock="version"和dynamic-update="true"。  
51.             name="version"：持久化类的属性名，column="version"：指定持有版本号的字段名；  
52.          -->  
53.         <version name="version" column="version"/>  
54.           
55.         <!--   
56.             <property>：为类定义一个持久化的javaBean风格的属性。  
57.             name="name"：标识属性的名字，以小写字母开头；  
58.             column="name"：表主键字段的名字，如果不填写与name一样；  
59.             update="true"/insert="true"：默认为true，表示可以被更新或插入；  
60.             access="property/field"：指定Hibernate访问持久化类属性的方式。默认property。property表示使用setter/getter方式。field表示运用java反射机制直接访问类的属性。  
61.             formula="{select。。。。。}"：该属性指定一个SLQ表达式，指定该属性的值将根据表达式类计算，计算属性没有和它对应的数据列。  
62.             formula属性允许包含表达式：sum,average,max函数求值的结果。  
63.             例如：formula="(select avg(p.price) from Product P)"  
64.          -->  
65.         <property name="name" column="name" />  
66.         <property name="sex" column="sex"/>  
67.         <property name="age" column="age"/>  
68.           
69.         <!--   
70.             组件映射：把多个属性打包在一起当一个属性使用，用来把类的粒度变小。  
71.             <component name="属性，这里指对象">  
72.                 <property name="name1"></property>  
73.                 <property name="name2"></property>  
74.             </component>  
75.          -->  
76.            
77.          <!--   
78.             <join>:一个对象映射多个表，该元素必须放在所有<property>之后。  
79.             <join table="tbl_test：子表名">  
80.                 <key column="uuid：子表主键"></key>  
81.             <property name="name1：对象属性" column="name：子表字段"></property>  
82.          </join>  
83.           -->  
84.            
85.     </class>    
86. </hibernate-mapping>