【Hibernate】Hibernate.cfg.xml配置文件详解

浏览数：27 / 时间：2015年06月09日

Hibernate配置文件主要用于配置数据库连接和Hibernate运行时所需的各种属性，这个配置文件应该位于应用程序或Web程序的类文件夹 classes中。Hibernate配置文件支持两种形式，一种是xml格式的配置文件，另一种是Java属性文件格式的配置文件，采用“键=值”的形式。建议采用xml格式的配置文件。xml配置文件可以直接对映射文件进行配置，并由Hibernate自动加载，而properties文件则必须在程序中通过编码加载映射文件。

注意：hibernate的前缀可以省略，即：hibernate.dialect等同于dialect

Hibernate的配置属性：

属性名	属性含义及作用
hibernate.dialect	配置hibernate数据库方言，hibernate可针对特殊的数据库进行优化
hibernate.show_sql	是否输出hibernate运行是的sql语句，true为输出，false为不输出。一般在开发测试中设置为true，项目部署成功后设置为false，加快程序运行。
hibernate.format_sql	优化控制台输出的sql语句，true为是，false为否。
hibernate.default_schema	默认数据库。
hibernate.session_factory_name	当SessionFactory创建以后，自动在JNDI中绑定这个名字
hibernate.max_fetch_depth	对一对一，一对多的外连接设置抓取最大深度，推荐值0-3，如果为0则关闭外连接抓取
hibernate.default_batch_fetch_size	设置hibernate关联的默认批量抓取数量,建议取值为4、8或16
hibenate.default_entity_mode	为由SessionFactory打开的所有Session指定默认的实体表现模式。取值dynamic-map，dom4j，pojo
hibernate.order_updates	强制hibernate按照被更新数据库的主键，为SQL更新排序。这样做将减少高并发系统中事务的锁死。值为true或false
hibernate.generate_statistics	Hibernate将收集有助于性能调节的统计数据。值为true或false
hibernate.use_identifer_rollback	如果开启，在对象删除时生成的标识属性将被重新设置为默认值。
hibernate.use_sql_comments	如果开启，Hibernate将在SQL中生成有助于调试的注释信息。true或false

Hibernate JDBC和连接（Connection）属性

注意：红色标注属性，为开发时经常用到是属性

属性名	属性含义及作用
hibernate.jdbc.fetch_size	非零值，指定JDBC抓取数量的大小（调用Statement.setFetchSize()）
hibernate.jdbc.batch_size	非零值，允许Hibernate使用JDBC2的批量更新，取值建议5-30之间
hibernate.jdbc_batch_versioned_data	设置为true，当调用executeBatch()时，JDBC能返回正确的行数。Hibernate将为自动版本化的数据使用批量DML。默认为false
hibernate.jdbc.fatory_class	设置一个自定制的Batcher。大多数程序不用设置此属性
hibernate.jdbc.use_scrollable_resultset	允许hibernate使用jdbc2的可滚动结果集，只有在使用用户提供的jdbc连接时，这个选项才是必要的，否则hibernate会使用连接的元数据。ture或者false
hibernate.jdbc.use_streams_for_binary	这个是系统级属性。当从JDBC读写二进制或可序列化的数据类型时，使用Stream。可选值：true,false
hibernate.jdbc.use_get_generated_keys	设置为true，当插入数据到表中后，利用JDBC3的PreparedStatement.getGeneratedkeys()来检索插入后生成的键值。需要JDBC3以上的驱动程序和JRE1.4以上的版本。如果Hibernate在生成标识符时出问题，设置此项为false。默认情况下，利用连接的元数据判断数据库驱动程序是否具有此能力
hibernate.connection.provider_class	提供给Hibernate的用户自定义ConnectionProvider类，这个类用来想Hibernate提供JDBC连接
hibernate.connection.isolation	设置JDBC事务隔离级别，查看java.sql.Connection来了解各个值的具体意义，但大多数数据库都不支持所有的隔离级别。PS：在多用户并发访问量大的情况下，这个选项的设置尤为重要。取值1、2、4、8
hibernate.connection.autocommit	允许被缓存的JDBC连接开启自动提交（qutocommit）,不推荐开启。取值：true、false
hibernate.connection.release_mode	指定Hibernate何时释放JDBC连接，默认情况下jdbc保持连接直到session现实关闭或断开。对于应用服务器JTA数据源，应该调用after_statement,以便每次JDBC调用后积极的释放连接；对非JTA连接，使用after_transaction,可在事务结束释放连接。如果设置为auto，将为JTA和CMT事务策略选择after_statement,为JDBC事务策略选择after_transaction。取值auto(默认)\|no_close\|after_statement\|after_transaction。注意，这些设置仅对通过SessionFactory.openSession得到的Session起作用。对于通过SessionFactory.getCurrentSession得到的Session，所配置的CurrentSessionContext实现这些session的连接释放模式。
hibernate.connection.<propertyName>	将JDBC属性propertyName传递到DriverManager.getConnection()
hibernate.jndi.<propertyName>	降属性propertyName传递到JBDI InitialContextFactory中去

Hibernate 缓存属性

属性名	属性含义及作用
hibernate.cache.provider_class	自定义的CacheProvider的类名，取值classname.of.CacheProvider
hibernate.cache.use_minimal_puts	以频繁的读操作为代价，优化二级缓存来最小化写操作，在Hibernate3中，这个设置对集群缓存非常有用，对集群缓存而言，默认开启。取值：true\|false
hibernate.cache.use_query_cache	允许查询缓存，个别查询仍然需要被设置为可缓存的。取值：true\|false
hibernate.cache.use_second_level_cache	能用来完全禁止使用二级缓存，对那些在类的映射定义中制定<cache>的类，会默认开启二级缓存。取值：true\|fasle
hibernate.cache.query_cache_factory	自定义实现QueryCache接口的类名，默认为内建的StandardQueryCache.取值classname.of.QueryCache
hibernate.cache.region_prefix	二级缓存区域名的前缀，取值prefix
hibernate.cache.use_structured_entries	强制Hibernate以更人性化的格式将数据存入二级缓存。取值：true\|false

Hibernate 事务属性：

属性名	属性含义及作用
hibernate.transaction.factory_class	一个TransactionFactory的类名，用于Hibernate Transaction API(默认JDBCTranscactionFactory)。取值classname.of.TransactionFactory
hibernate.transaction.manager_lookup_class	一个TransactionManagerLookup的类名，当使用JVM级缓存，或在JTA环境中使用hilo生成器的时候需要该类。取值：classname.of.TransactionManagerLookup
hibernate.transaction.flush_before_completion	如果开启，session在事务完成后将被自动清洗（flush）。现在更好的办法是使用自动session上下文管理。取值 true\|false
hibernate.transaction.auto_close_session	如果开启，session将在事务完成后被自动关闭。现在更好的办法是使用自动session上下文管理。取值 true\|false

其他属性：

属性名	属性含义及作用
hibernate.current_session_context_class	为当前session指定一个策略。如：thread\|managed\|jta\|custom.Class
hibernate.query.factory_class	选择HQL解析器的实现。取值 org.hibernate.hql.ast.ASTQueryTranslatorFactory org.hibernate.hql.classic.ClassicQueryTranslatorFactory
hibernate.query.substitutions	将Hibernate查询中的符号映射到SQL查询中的符号 (符号可能是函数名或常量名字). 取值 hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNC
hibernate.hbm2ddl.auto	在SessionFactory创建时，自动检查数据库结构，或者将数据库schema的DDL导出到数据库. 使用 create-drop时,在显式关闭SessionFactory时，将drop掉数据库schema. 取值 validate \| update \| create \| create-drop
hibernate.cglib.use_reflection_optimizer	开启CGLIB来替代运行时反射机制(系统级属性). 反射机制有时在除错时比较有用. 注意即使关闭这个优化, Hibernate还是需要CGLIB. 你不能在hibernate.cfg.xml中设置此属性.取值 true \| false