本文详细介绍了Hibernate的核心配置文件hibernate.cfg.xml，包括加载流程、配置作用以及各种property属性参数，如dialect、show_sql、format_sql等，涵盖了数据库连接、事务、缓存、JDBC和连接池等方面的设置，旨在帮助开发者更好地理解和使用Hibernate框架。
一、Hibernate配置文件加载流程
(1) 通过Configuration config = new Configuration().configure();加载默认配置文件
(2)Configuration的configure()方法
注意：hibernate默认加载的文件hibernate.cfg.xml
(3)调用StandardServiceRegistryBuilder的configure(String resource)方法
通过Hibernate的org.hibernate.boot.cfgxml.internal.ConfigLoader加载XML配置文件
二、hibernate.cfg.xml
该文件也是Hibernate框架自动加载的默认配置文件，主要用于配置数据库连接信息，以及持久类的映射文件。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-configuration PUBLIC
"-//Hibernate/Hibernate Configuration DTD 3.0//EN"
"http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">
<hibernate-configuration>
<session-factory>
<!-- 配置关于数据库连接的四个项 driverClass url username password -->
<property name="hibernate.connection.driver_class">com.mysql.jdbc.Driver</property>
<property name="hibernate.connection.url">jdbc:mysql://localhost:3306/hibernateTest</property>
<property name="hibernate.connection.username">root</property>
<property name="hibernate.connection.password">root</property>
<!-- 设置连接提供者 -->
<!-- <property name="hibernate.connection.provider_class">
org.hibernate.connection.C3P0ConnectionProvider
</property> -->
<!-- c3p0连接池的配置 -->
<!-- <property name="hibernate.c3p0.max_size">20</property> --> <!-- 最大连接池 -->
<!-- <property name="hibernate.c3p0.min_size">5</property> --> <!-- 最小连接数 -->
<!-- <property name="hibernate.c3p0.timeout">120</property> --> <!-- 超时 -->
<!-- <property name="hibernate.c3p0.idle_test_period">3000</property> --> <!-- 空闲连接 -->
<!-- 可以将向数据库发送的sql显示出来 -->
<property name="hibernate.show_sql">true</property>
<!-- 格式化sql -->
<property name="hibernate.format_sql">true</property>
<!-- hibernate的方言 -->
<property name="hibernate.dialect">org.hibernate.dialect.MySQLDialect</property>
<!-- 自动创建表 -->
<property name="hibernate.hbm2ddl.auto">update</property>
<!-- 用于设置事务提交方式 -->
<property name="hibernate.connection.autocommit">false</property>
<!-- 配置hibernate的映射文件所在位置 -->
<mapping resource="com/hibernate/domain/Customer.hbm.xml" />
</session-factory>
</hibernate-configuration> 三、property属性参数详解
3.1 杂项设置
3.1.1 hibernate.dialect
一个Hibernate Dialect类名允许Hibernate针对特定的关系数据库生成优化的SQL. 取值 full.classname.of.Dialect
3.1.2 hibernate.show_sql
输出所有SQL语句到控制台. 有一个另外的选择是把org.hibernate.SQL这个log category设为debug。 取值 true | false
3.1.3 hibernate.format_sql
在log和console中打印出更漂亮的SQL。 取值 true | false
3.1.4 hibernate.default_schema
默认的数据库。例如：如果设置为pubs，则生成SQL语句时，所有的数据库表前都会出现pubs字样，可能生成如下的SQL语句：select id,name,sex form pubs.UserInfo(其中UserInfo是数据库pubs的表，id、name、sex是表UserInfo中的3个字段)
3.1.5 hibernate.default_catalog
在生成的SQL中, 将给定的catalog附加于非全限定名的表名上. 取值 CATALOG_NAME
3.1.6 hibernate.session_factory_name
SessionFactory创建后，将自动使用这个名字绑定到JNDI中. 取值 jndi/composite/name
3.1.7 hibernate.max_fetch_depth
为单向关联(一对一, 多对一)的外连接抓取（outer join fetch）树设置最大深度. 值为0意味着将关闭默认的外连接抓取. 取值 建议在0到3之间取值
3.1.8 hibernate.default_batch_fetch_size
为Hibernate关联的批量抓取设置默认数量. 取值 建议的取值为4, 8, 和16
3.1.9 hibernate.default_entity_mode
为由这个SessionFactory打开的所有Session指定默认的实体表现模式. 取值 dynamic-map, dom4j, pojo
3.1.10 hibernate.order_updates
强制Hibernate按照被更新数据的主键，为SQL更新排序。这么做将减少在高并发系统中事务的死锁。 取值 true | false
3.1.11 hibernate.generate_statistics
如果开启, Hibernate将收集有助于性能调节的统计数据. 取值 true | false
3.1.12 hibernate.use_identifer_rollback
如果开启, 在对象被删除时生成的标识属性将被重设为默认值. 取值 true | false
3.1.13 hibernate.use_sql_comments
如果开启, Hibernate将在SQL中生成有助于调试的注释信息, 默认值为false. 取值 true | false
3.2 Hibernate JDBC和连接(connection)属性
3.2.1 hibernate.jdbc.fetch_size
非零值，指定JDBC抓取数量的大小 (调用Statement.setFetchSize()).
3.2.2 hibernate.jdbc.batch_size
非零值，允许Hibernate使用JDBC2的批量更新. 取值 建议取5到30之间的值
3.2.3 hibernate.jdbc.batch_versioned_data
如果你想让你的JDBC驱动从executeBatch()返回正确的行计数 , 那么将此属性设为true(开启这个选项通常是安全的). 同时，Hibernate将为自动版本化的数据使用批量DML. 默认值为false. 取值 true | false
3.2.4 hibernate.jdbc.factory_class
选择一个自定义的Batcher. 多数应用程序不需要这个配置属性. eg. classname.of.Batcher
3.2.5 hibernate.jdbc.use_scrollable_resultset
允许Hibernate使用JDBC2的可滚动结果集. 只有在使用用户提供的JDBC连接时，这个选项才是必要的, 否则Hibernate会使用连接的元数据. 取值 true | false
3.2.6 hibernate.jdbc.use_streams_for_binary
在JDBC读写binary (二进制)或serializable (可序列化) 的类型时使用流(stream)(系统级属性). 取值 true | false
3.2.7 hibernate.jdbc.use_get_generated_keys
在数据插入数据库之后，允许使用JDBC3 PreparedStatement.getGeneratedKeys() 来获取数据库生成的key(键)。需要JDBC3+驱动和JRE1.4+, 如果你的数据库驱动在使用Hibernate的标 识生成器时遇到问题，请将此值设为false. 默认情况下将使用连接的元数据来判定驱动的能力. 取值 true|false
3.2.8 hibernate.connection.provider_class
自定义ConnectionProvider的类名, 此类用来向Hibernate提供JDBC连接. 取值 classname.of.ConnectionProvider
3.2.9 hibernate.connection.isolation
设置JDBC事务隔离级别. 查看java.sql.Connection来了解各个值的具体意义, 但请注意多数数据库都不支持所有的隔离级别，取值 1, 2, 4, 8。取值对应的事务隔离级别：
1 : READ_UNCOMMITED 读取未提交，它引发所有的隔离问题
2 : READ_COMMITTED 读取已提交，阻止脏读，可能发生不可重复读与虚读
4 : REPEATABLE_READ 重复读，阻止脏读，不可重复读，可能发生虚读
8 : SERIALIZABLE 串行化，解决所有问题，不允许两个事务，同时操作一个目标数据。(效率低)
ORACLE 默认的事务隔离级别是READ_COMMITTED
MYSQL 默认的事务隔离级别是REPEATABLE_READ
3.2.10 hibernate.connection.autocommit
允许被缓存的JDBC连接开启自动提交(autocommit) (不建议). 取值 true | false
3.2.11 hibernate.connection.release_mode
指定Hibernate在何时释放JDBC连接. 默认情况下,直到Session被显式关闭或被断开连接时,才会释放JDBC连接. 对于应用程序服务器的JTA数据源, 你应当使用after_statement, 这样在每次JDBC调用后，都会主动的释放连接. 对于非JTA的连接, 使用after_transaction在每个事务结束时释放连接是合理的. auto将为JTA和CMT事务策略选择after_statement, 为JDBC事务策略选择after_transaction. 取值 on_close | after_transaction | after_statement | auto
3.2.12 hibernate.connection.<propertyName>
将JDBC属性propertyName传递到DriverManager.getConnection()中去.
3.2.13 hibernate.jndi.<propertyName>
将属性propertyName传递到JNDI InitialContextFactory中去.
3.3 Hibernate缓存属性
3.3.1 hibernate.cache.provider_class
自定义的CacheProvider的类名. 取值 classname.of.CacheProvider
3.3.2 hibernate.cache.use_minimal_puts
以频繁的读操作为代价, 优化二级缓存来最小化写操作. 在Hibernate3中，这个设置对的集群缓存非常有用, 对集群缓存的实现而言，默认是开启的. 取值 true|false
3.3.3 hibernate.cache.use_query_cache
允许查询缓存, 个别查询仍然需要被设置为可缓存的. 取值 true|false
3.3.4 hibernate.cache.use_second_level_cache
能用来完全禁止使用二级缓存. 对那些在类的映射定义中指定<cache>的类，会默认开启二级缓存. 取值 true|false
3.3.5 hibernate.cache.query_cache_factory
自定义实现QueryCache接口的类名, 默认为内建的StandardQueryCache. 取值 classname.of.QueryCache
3.3.6 hibernate.cache.region_prefix
二级缓存区域名的前缀. 取值 prefix
3.3.7 hibernate.cache.use_structured_entries
强制Hibernate以更人性化的格式将数据存入二级缓存. 取值 true|false
3.4 Hibernate事务属性
3.4.1 hibernate.transaction.factory_class
一个TransactionFactory的类名, 用于Hibernate Transaction API (默认为JDBCTransactionFactory). 取值 classname.of.TransactionFactory
3.4.2 jta.UserTransaction
一个JNDI名字，被JTATransactionFactory用来从应用服务器获取JTA UserTransaction. 取值 jndi/composite/name
3.4.3 hibernate.transaction.manager_lookup_class
一个TransactionManagerLookup的类名 - 当使用JVM级缓存，或在JTA环境中使用hilo生成器的时候需要该类. 取值 classname.of.TransactionManagerLookup
3.4.4 hibernate.transaction.flush_before_completion
如果开启, session在事务完成后将被自动清洗(flush)。 现在更好的方法是使用自动session上下文管理。取值 true | false
3.4.5 hibernate.transaction.auto_close_session
如果开启, session在事务完成后将被自动关闭。 现在更好的方法是使用自动session上下文管理。取值 true | false
3.5 其他属性
3.5.1 hibernate.current_session_context_class
Hibernate提供了三种管理session的方式：
- Session对象的生命周期与本地线程绑定(ThreadLocal)
- Session对象的生命周期与JTA事务绑定(分布式事务管理)
- Hibernate委托程序来管理Session的生命周期
为"当前" Session指定一个(自定义的)策略。eg. jta | thread | custom.Class
在获取Session时不要使用openSession()方法，而是使用getCurrentSession()方法。
3.5.2 hibernate.query.factory_class
选择HQL解析器的实现. 取值 org.hibernate.hql.ast.ASTQueryTranslatorFactory or org.hibernate.hql.classic.ClassicQueryTranslatorFactory
3.5.3 hibernate.query.substitutions
将Hibernate查询中的符号映射到SQL查询中的符号 (符号可能是函数名或常量名字). 取值 hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNC
3.5.4 hibernate.hbm2ddl.auto
该属性可帮助程序员实现正向工程, 即由 java 代码生成数据库脚本, 进而生成具体的表结构。
取值 create | update | create-drop | validate
- create : 会根据 .hbm.xml 文件来生成数据表, 但是每次运行都会删除上一次的表 ,重新生成表, 哪怕二次没有任何改变
- create-drop : 会根据 .hbm.xml 文件生成表,但是SessionFactory一关闭, 表就自动删除
- update : 最常用的属性值，也会根据 .hbm.xml 文件生成表, 但若 .hbm.xml 文件和数据库中对应的数据表的表结构不同, Hiberante 将更新数据表结构，但不会删除已有的行和列
- validate : 会和数据库中的表进行比较, 若 .hbm.xml 文件中的列在数据表中不存在，则抛出异常
3.5.5 hibernate.cglib.use_reflection_optimizer
开启CGLIB来替代运行时反射机制(系统级属性). 反射机制有时在除错时比较有用. 注意即使关闭这个优化, Hibernate还是需要CGLIB. 你不能在hibernate.cfg.xml中设置此属性. 取值 true | false
3.6 数据库基本连接属性
3.6.1 hibernate.connection.driver_class
数据库连接驱动
3.6.2 hibernate.connection.url
数据库连接地址
3.6.3 hibernate.connection.username
数据库连接用户名
3.6.4 hibernate.connection.password
数据库连接密码
3.7 C3P0连接池属性
3.7.1 hibernate.c3p0.max_size
连接池最大连接数
3.7.2 hibernate.c3p0.min_size
连接池最小连接数
3.7.3 hibernate.c3p0.timeout
获得连接的超时时间,如果超过这个时间,会抛出异常，单位毫秒
3.7.4 hibernate.c3p0.max_statements
最大的PreparedStatement的数量
3.7.5 hibernate.c3p0.idle_test_period
每隔120秒检查连接池里的空闲连接 ，单位是秒
3.7.6 hibernate.c3p0.acquire_increment
当连接池里面的连接用完的时候，C3P0一下获取的新的连接数
3.7.7 hibernate.c3p0.validate
每次都验证连接是否可用，取值是 true | false
扫一扫
180
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
