Hibernate 参数设置一览表
属性名用途
hibernate.dialect一个HibernateDialect类名允许Hibernate针对特定的关系数据库生成优化的SQL.取值full.classname.of.Dialect
hibernate.show_sql输出所有SQL语句到控制台.有一个另外的选择是把org.hibernate.SQL这个logcategory设为debug。eg.true|false
hibernate.format_sql在log和console中打印出更漂亮的SQL。取值true|false
hibernate.default_schema在生成的SQL中,将给定的schema/tablespace附加于非全限定名的表名上.取值SCHEMA_NAME
hibernate.default_catalog在生成的SQL中,将给定的catalog附加于非全限定名的表名上.取值CATALOG_NAME
hibernate.session_factory_nameSessionFactory创建后,将自动使用这个名字绑定到JNDI中.取值jndi/composite/name
hibernate.max_fetch_depth为单向关联(一对一,多对一)的外连接抓取(outerjoinfetch)树设置最大深度.值为0意味着将关闭默认的
外连接抓取.取值建议在0到3之间取值
hibernate.default_batch_fetch_size为Hibernate关联的批量抓取设置默认数量.取值建议的取值为4,8,和16
hibernate.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如果开启,在对象被删除时生成的标识属性将被重设为默认值.取值true|false
hibernate.use_sql_comments如果开启,Hibernate将在SQL中生成有助于调试的注释信息,默认值为false.取值true|false
HibernateJDBC和连接(connection)属性
属性名用途
hibernate.jdbc.fetch_size非零值,指定JDBC抓取数量的大小(调用Statement.setFetchSize()).
hibernate.jdbc.batch_size非零值,允许Hibernate使用JDBC2的批量更新.取值建议取5到30之间的值
hibernate.jdbc.batch_versioned_data如果你想让你的JDBC驱动从executeBatch()返回正确的行计数,那么将此属性设为true(开启这个选项通常是安全的).同时,Hibernate将为自动版本化的数据使用批量DML.默认值为false.eg.true|false
hibernate.jdbc.factory_class选择一个自定义的Batcher.多数应用程序不需要这个配置属性.eg.classname.of.Batcher
hibernate.jdbc.use_scrollable_resultset允许Hibernate使用JDBC2的可滚动结果集.只有在使用用户提供的JDBC连接时,这个选项才是必要的,否则Hibernate会使用连接的元数据.取值true|false
hibernate.jdbc.use_streams_for_binary在JDBC读写binary(二进制)或serializable(可序列化)的类型时使用流(stream)(系统级属性).取值true|false
hibernate.jdbc.use_get_generated_keys在数据插入数据库之后,允许使用JDBC3PreparedStatement.getGeneratedKeys()来获取数据库生成的key(键)。需要JDBC3+驱动和JRE1.4+,如果你的数据库驱动在使用Hibernate的标识生成器时遇到问题,请将此值设为false.默认情况下将使用连接的元数据来判定驱动的能力.取值true|false
hibernate.connection.provider_class自定义ConnectionProvider的类名,此类用来向Hibernate提供JDBC连接.取值classname.of.ConnectionProvider
hibernate.connection.isolation设置JDBC事务隔离级别.查看java.sql.Connection来了解各个值的具体意义,但请注意多数数据库都不支持所有的隔离级别.取值1,2,4,8
hibernate.connection.autocommit允许被缓存的JDBC连接开启自动提交(autocommit)(不建议).取值true|false
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
hibernate.connection.<propertyName>将JDBC属性propertyName传递到DriverManager.getConnection()中去.
hibernate.jndi.<propertyName>将属性propertyName传递到JNDIInitialContextFactory中去.
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|false
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的类名,用于HibernateTransactionAPI(默认为JDBCTransactionFactory).取值classname.of.TransactionFactory
jta.UserTransaction一个JNDI名字,被JTATransactionFactory用来从应用服务器获取JTAUserTransaction.取值jndi/composite/name
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指定一个(自定义的)策略。eg.jta|thread|custom.Class
hibernate.query.factory_class选择HQL解析器的实现.取值org.hibernate.hql.ast.ASTQueryTranslatorFactoryorhibernate.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
SQL方言你应当总是为你的数据库将hibernate.dialect属性设置成正确的org.hibernate.dialect.Dialect子类.如果你指定一种方言,Hibernate将为上面列出的一些属性使用合理的默认值,为你省去了手工指定它们的功夫.
HibernateSQL方言(hibernate.dialect)
RDBMS方言
DB2org.hibernate.dialect.DB2Dialect
DB2AS/400org.hibernate.dialect.DB2400Dialect
DB2OS390org.hibernate.dialect.DB2390Dialect
PostgreSQLorg.hibernate.dialect.PostgreSQLDialect
MySQLorg.hibernate.dialect.MySQLDialect
MySQLwithInnoDBorg.hibernate.dialect.MySQLInnoDBDialect
MySQLwithMyISAMorg.hibernate.dialect.MySQLMyISAMDialect
Oracle(anyversion)org.hibernate.dialect.OracleDialect
Oracle9i/10gorg.hibernate.dialect.Oracle9Dialect
Sybaseorg.hibernate.dialect.SybaseDialect
SybaseAnywhereorg.hibernate.dialect.SybaseAnywhereDialect
MicrosoftSQLServerorg.hibernate.dialect.SQLServerDialect
SAPDBorg.hibernate.dialect.SAPDBDialect
Informixorg.hibernate.dialect.InformixDialect
HypersonicSQLorg.hibernate.dialect.HSQLDialect
Ingresorg.hibernate.dialect.IngresDialect
Progressorg.hibernate.dialect.ProgressDialect
MckoiSQLorg.hibernate.dialect.MckoiDialect
Interbaseorg.hibernate.dialect.InterbaseDialect
Pointbaseorg.hibernate.dialect.PointbaseDialect
FrontBaseorg.hibernate.dialect.FrontbaseDialect
Firebirdorg.hibernate.dialect.FirebirdDialect
Hibernate日志类别
类别功能
org.hibernate.SQL在所有SQLDML语句被执行时为它们记录日志
org.hibernate.type为所有JDBC参数记录日志
org.hibernate.tool.hbm2ddl在所有SQLDDL语句执行时为它们记录日志
org.hibernate.pretty在session清洗(flush)时,为所有与其关联的实体(最多20个)的状态记录日志
org.hibernate.cache为所有二级缓存的活动记录日志
org.hibernate.transaction为事务相关的活动记录日志
org.hibernate.jdbc为所有JDBC资源的获取记录日志
org.hibernate.hql.AST在解析查询的时候,记录HQL和SQL的AST分析日志
org.hibernate.secure为JAAS认证请求做日志
org.hibernate为任何Hibernate相关信息做日志(信息量较大,但对查错非常有帮助)
JTATransactionManagers
Transaction工厂类应用程序服务器
org.hibernate.transaction.JBossTransactionManagerLookupJBoss
org.hibernate.transaction.WeblogicTransactionManagerLookupWeblogic
org.hibernate.transaction.WebSphereTransactionManagerLookupWebSphere
org.hibernate.transaction.WebSphereExtendedJTATransactionLookupWebSphere6
org.hibernate.transaction.OrionTransactionManagerLookupOrion
org.hibernate.transaction.ResinTransactionManagerLookupResin
org.hibernate.transaction.JOTMTransactionManagerLookupJOTM
org.hibernate.transaction.JOnASTransactionManagerLookupJOnAS
org.hibernate.transaction.JRun4TransactionManagerLookupJRun4
org.hibernate.transaction.BESTransactionManagerLookupBorlandES