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

<?xml version="1.0" encoding="GBK"?>  
<!-- 指定Hibernate配置文件的DTD信息 -->  
<!DOCTYPE hibernate-configuration PUBLIC  
    "-//Hibernate/Hibernate Configuration DTD 3.0//EN"  
    "http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">  
<!-- hibernate- configuration是连接配置文件的根元素 -->  
<hibernate-configuration>  
    <session-factory>  
        <!-- 指定连接数据库所用的驱动 -->  
        <property name="connection.driver_class">com.mysql.jdbc.Driver</property>  
        <!-- 指定连接数据库的url，hibernate连接的数据库名 -->  
        <property name="connection.url">jdbc:mysql://localhost/数据库名</property>  
        <!-- 指定连接数据库的用户名 -->  
        <property name="connection.username">root</property>  
        <!-- 指定连接数据库的密码 -->  
        <property name=<
4000
/span>"connection.password">32147</property>  
        <!-- 指定连接池里最大连接数 -->  
        <property name="hibernate.c3p0.max_size">20</property>  
        <!-- 指定连接池里最小连接数 -->  
        <property name="hibernate.c3p0.min_size">1</property>  
        <!-- 指定连接池里连接的超时时长 -->  
        <property name="hibernate.c3p0.timeout">5000</property>  
        <!-- 指定连接池里最大缓存多少个Statement对象 -->  
        <property name="hibernate.c3p0.max_statements">100</property>  
        <property name="hibernate.c3p0.idle_test_period">3000</property>  
        <property name="hibernate.c3p0.acquire_increment">2</property>  
        <property name="hibernate.c3p0.validate">true</property>  
        <!-- 指定数据库方言 -->  
        <property name="dialect">org.hibernate.dialect.MySQLInnoDBDialect</property>  
        <!-- 根据需要自动创建数据表 -->  
        <property name="hbm2ddl.auto">update</property>  
        <!-- 显示Hibernate持久化操作所生成的SQL -->  
        <property name="show_sql">true</property>  
        <!-- 将SQL脚本进行格式化后再输出 -->  
        <property name="hibernate.format_sql">true</property>  
        <!-- 罗列所有的映射文件 -->  
        <mapping resource="映射文件路径/News.hbm.xml"/>  
    </session-factory>  
</hibernate-configuration>  

properties（hibernate.properties）文件详解

[html]
view plain
copy

## MySQL  
#方言  
hibernate.dialect org.hibernate.dialect.MySQLDialect  
hibernate.dialect org.hibernate.dialect.MySQLInnoDBDialect  
hibernate.dialect org.hibernate.dialect.MySQLMyISAMDialect  
#驱动  
hibernate.connection.driver_class com.mysql.jdbc.Driver  
#数据库地址  
hibernate.connection.url jdbc:mysql://127.0.0.1/datdabseName  
#用户名  
hibernate.connection.username root  
#密码  
hibernate.connection.password 12345  
#是否在控制台输出sql语句  
hibernate.show_sql true/false  
#设置当创建sessionfactory时，是否根据映射文件自动建立数据库表。 create-drop:表示关闭sessionFactory时，将drop刚建的数据库表。该属性可以是update/create-drop/create  
hibernate.hbm2ddl.auto update/create-drop/create  
  
###########################  
### C3P0 Connection Pool C3P0连接池###  
###########################  
#连接池最大链接数  
hibernate.c3p0.max_size 2  
#连接池最小连接数  
hibernate.c3p0.min_size 2  
#连接池连接的超时时长  
hibernate.c3p0.timeout 5000  
#缓存statements 的数量  
hibernate.c3p0.max_statements 100  
hibernate.c3p0.idle_test_period 3000  
hibernate.c3p0.acquire_increment 2  
hibernate.c3p0.validate true/false  
  
  
############  
### JNDI (java naming directory interface)Java命名目录接口###  
###当无需hibernate自己管理数据源而是直接访问容器管理数据源 使用JNDI  
############  
#指定数据源JNDI名字  
hibernate.connection.datasource dddd  
#文件系统下  
hibernate.jndi.class com.sun.jndi.fscontext.RefFSContextFactory  
hibernate.jndi.url file:/  
  
#网络  
#指定JND InitialContextFactory 的实现类，该属性也是可选的。如果JNDI与Hibernate持久化访问的代码处于同一个应用，无需指定该属性  
hibernate.jndi.class com.ibm.websphere.naming.WsnInitialContextFactory  
#指定JNDI提供者的URL，该属性可选 如果JNDI与Hibernate持久化访问的代码处于同一个应用，无需指定该属性  
hibernate.jndi.url iiop://localhost:900/  
  
#指定链接数据库用户名  
hibernate.connection.username  root  
#指定密码  
hibernate.connection.password  1111  
#指定方言  
hibernate.dialect org.hibernate.dialect.MySQLDialect  
  
#######################  
### Transaction API   事务属性说明###  
#######################  
  
#指定是否在事务结束后自动关闭session   
hibernate.transaction.auto_close_session true/false  
#指定session是否在事务完成后自动将数据刷新到底层数据库  
hibernate.transaction.flush_before_completion true/false  
  
## 指定hibernate所有的事务工厂的类型，该属性必须是TransactionFactory的直接或间接子类  
  
hibernate.transaction.factory_class org.hibernate.transaction.JTATransactionFactory  
hibernate.transaction.factory_class org.hibernate.transaction.JDBCTransactionFactory  
  
## 该属性值是一个JNDI名，hibernate将使用JTATTransactionFactory从应用服务器中取出JTAYserTransaction  
  
jta.UserTransaction jta/usertransaction  
jta.UserTransaction javax.transaction.UserTransaction  
jta.UserTransaction UserTransaction  
  
## 该属性值为一个transactionManagerLookup类名，当使用JVM级别的缓存时，或在JTA环境中使用hilo生成器策略时，需要该类  
  
hibernate.transaction.manager_lookup_class org.hibernate.transaction.JBossTransactionManagerLookup  
hibernate.transaction.manager_lookup_class org.hibernate.transaction.WeblogicTransactionManagerLookup  
hibernate.transaction.manager_lookup_class org.hibernate.transaction.WebSphereTransactionManagerLookup  
hibernate.transaction.manager_lookup_class org.hibernate.transaction.OrionTransactionManagerLookup  
hibernate.transaction.manager_lookup_class org.hibernate.transaction.ResinTransactionManagerLookup  

二、映射文件详解

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

[html]
view plain
copy

<?xml version="1.0"?>  
<!DOCTYPE hibernate-mapping PUBLIC   
    "-//Hibernate/Hibernate Mapping DTD 3.0//EN"  
    "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">      
<!--   
    <hibernate-mapping>一般不去配置，采用默认即可。  
    schema:指定映射数据库的schema(模式/数据库)，如果指定该属性，则表名会自动添加该schema前缀  
e2e3

    package:指定包前缀 指定持久化类所在的包名 这样之后calss子元素中就不必使用全限定性的类名  
    default-cascade="none"：默认的级联风格，表与表联动。  
    default-lazy="true"：默认延迟加载  
 -->  
<hibernate-mapping>  
    <!--   
        <class>：使用class元素定义一个持久化类。  
        name="cn.javass.user.vo.UserModel"：持久化类的java全限定名；  
        table="tbl_user"：对应数据库表名，默认持久化类名作为表名；  
        proxy:指定一个接口，在延迟装载时作为代理使用，也可在这里指定该类自己的名字。  
        mutable="true"：默认为true，设置为false时则不可以被应用程序更新或删除，等价于所有<property>元素的update属性为false，表示整个实例不能被更新。  
        dynamic-insert="false"：默认为false，动态修改那些有改变过的字段，而不用修改所有字段；  
        dynamic-update="false"：默认为false，动态插入非空值字段；  
        select-before-update="false"：默认为false，在修改之前先做一次查询，与用户的值进行对比，有变化都会真正更新；  
        optimistic-lock="version"：默认为version(检查version/timestamp字段)，取值：all(检查全部字段)、dirty(只检查修改过的字段)；  
                                   none(不使用乐观锁定)，此参数主要用来处理并发，每条值都有固定且唯一的版本，版本为最新时才能执行操作；  
        如果需要采用继承映射，则class元素下还会增加<subclass.../>元素等用于定义子类。  
     -->  
    <class name="cn.javass.user.vo.UserModel" table="tbl_user" >  
          
        <!--   
            <id>：定义了该属性到数据库表主键字段的映射。  
            type  指定该标识属性的数据类型，该类型可以是Hibernate的内建类型，也可以是java类型，如果是java类型则需要使用全限定类名（带包名）。该属性可选，如果没有指定类型， 则hibernate自行判断该标识属性数据类型。通常建议设定。  
            name="userId"：标识属性的名字；  
            column="userId"：表主键字段的名字，如果不填写与name一样；  
              
         -->  
        <id name="userId">  
            <!-- <generator>：指定主键由什么生成，推荐使用uuid，assigned指用户手工填入。设定标识符生成器  
            适应代理主键的有：  
                increment：有Hibernat自动以递增的方式生成标识符，每次增量1；  
                identity：由底层数据库生成标识符，前提条件是底层数据库支持自动增长字段类型。（DB2,MYSQL）  
                uuid:用128位的UUID算法生成字符串类型标识符。  
            适应自然主键：  
                assigned:由java程序负责生成标识符，为了能让java应用程序设置OID,不能把setId（）方法设置成private类型。  
                让应用程序在save()之前为对象分配一个标识符。相当于不指定<generator.../>元素时所采用的默认策略。  
                应当尽量避免自然主键  
            -->  
            <generator class="uuid"/>  
        </id>  
          
        <!--   
            <version/>：使用版本控制来处理并发，要开启optimistic-lock="version"和dynamic-update="true"。  
            name="version"：持久化类的属性名，column="version"：指定持有版本号的字段名；  
         -->  
        <version name="version" column="version"/>  
          
        <!--   
            <property>：为类定义一个持久化的javaBean风格的属性。  
            name="name"：标识属性的名字，以小写字母开头；  
            column="name"：表主键字段的名字，如果不填写与name一样；  
            update="true"/insert="true"：默认为true，表示可以被更新或插入；  
            access="property/field"：指定Hibernate访问持久化类属性的方式。默认property。property表示使用setter/getter方式。field表示运用java反射机制直接访问类的属性。  
            formula="{select。。。。。}"：该属性指定一个SLQ表达式，指定该属性的值将根据表达式类计算，计算属性没有和它对应的数据列。  
            formula属性允许包含表达式：sum,average,max函数求值的结果。  
            例如：formula="(select avg(p.price) from Product P)"  
         -->  
        <property name="name" column="name" />  
        <property name="sex" column="sex"/>  
        <property name="age" column="age"/>  
          
        <!--   
            组件映射：把多个属性打包在一起当一个属性使用，用来把类的粒度变小。  
            <component name="属性，这里指对象">  
                <property name="name1"></property>  
                <property name="name2"></property>  
            </component>  
         -->  
           
         <!--   
            <join>:一个对象映射多个表，该元素必须放在所有<property>之后。  
            <join table="tbl_test：子表名">  
                <key column="uuid：子表主键"></key>  
            <property name="name1：对象属性" column="name：子表字段"></property>  
         </join>  
          -->  
           
    </class>    
</hibernate-mapping>