Hibernate 参数设置一览表.doc

《Hibernate 参数设置一览表.doc》由会员分享，可在线阅读，更多相关《Hibernate 参数设置一览表.doc（15页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、Hibernate 参数设置一览表属性名用途hibernate.dialect一个HibernateDialect类名允许Hibernate针对特定的关系数据库生成优化的SQL.取值full.classname.of.Dialecthibernate.show_sql输出所有SQL语句到控制台. 有一个另外的选择是把org.hibernate.SQL这个log category设为debug。eg.true|falsehibernate.format_sql在log和console中打印出更漂亮的SQL。取值true|falsehibernate.default_schema在生成的SQL中,

2、 将给定的schema/tablespace附加于非全限定名的表名上.取值SCHEMA_NAMEhibernate.default_catalog在生成的SQL中, 将给定的catalog附加于非全限定名的表名上.取值CATALOG_NAMEhibernate.session_factory_nameSessionFactory创建后，将自动使用这个名字绑定到JNDI中.取值jndi/composite/namehibernate.max_fetch_depth为单向关联(一对一, 多对一)的外连接抓取（outer join fetch）树设置最大深度. 值为0意味着将关闭默认的外连接抓取.取

3、值建议在0到3之间取值hibernate.default_batch_fetch_size为Hibernate关联的批量抓取设置默认数量.取值建议的取值为4,8, 和16hibernate.default_entity_mode为由这个SessionFactory打开的所有Session指定默认的实体表现模式.取值dynamic-map,dom4j,pojohibernate.order_updates强制Hibernate按照被更新数据的主键，为SQL更新排序。这么做将减少在高并发系统中事务的死锁。取值true|falsehibernate.generate_statistics如果开启,

4、Hibernate将收集有助于性能调节的统计数据.取值true|falsehibernate.use_identifer_rollback如果开启, 在对象被删除时生成的标识属性将被重设为默认值.取值true|falsehibernate.use_sql_comments如果开启, Hibernate将在SQL中生成有助于调试的注释信息, 默认值为false.取值true|false表3.4. Hibernate JDBC和连接(connection)属性属性名用途hibernate.jdbc.fetch_size非零值，指定JDBC抓取数量的大小 (调用Statement.setFetchS

5、ize().hibernate.jdbc.batch_size非零值，允许Hibernate使用JDBC2的批量更新.取值建议取5到30之间的值hibernate.jdbc.batch_versioned_data如果你想让你的JDBC驱动从executeBatch()返回正确的行计数 , 那么将此属性设为true(开启这个选项通常是安全的). 同时，Hibernate将为自动版本化的数据使用批量DML. 默认值为false.eg.true|falsehibernate.jdbc.factory_class选择一个自定义的Batcher. 多数应用程序不需要这个配置属性.eg.classnam

6、e.of.Batcherhibernate.jdbc.use_scrollable_resultset允许Hibernate使用JDBC2的可滚动结果集. 只有在使用用户提供的JDBC连接时，这个选项才是必要的, 否则Hibernate会使用连接的元数据.取值true|falsehibernate.jdbc.use_streams_for_binary在JDBC读写binary (二进制)或serializable (可序列化)的类型时使用流(stream)(系统级属性).取值true|falsehibernate.jdbc.use_get_generated_keys在数据插入数据库之后，允

7、许使用JDBC3PreparedStatement.getGeneratedKeys()来获取数据库生成的key(键)。需要JDBC3+驱动和JRE1.4+, 如果你的数据库驱动在使用Hibernate的标 识生成器时遇到问题，请将此值设为false. 默认情况下将使用连接的元数据来判定驱动的能力.取值true|falsehibernate.connection.provider_class自定义ConnectionProvider的类名, 此类用来向Hibernate提供JDBC连接.取值classname.of.ConnectionProviderhibernate.connection.

8、isolation设置JDBC事务隔离级别. 查看java.sql.Connection来了解各个值的具体意义, 但请注意多数数据库都不支持所有的隔离级别.取值1, 2, 4, 8hibernate.connection.autocommit允许被缓存的JDBC连接开启自动提交(autocommit) (不建议).取值true|falsehibernate.connection.release_mode指定Hibernate在何时释放JDBC连接. 默认情况下,直到Session被显式关闭或被断开连接时,才会释放JDBC连接. 对于应用程序服务器的JTA数据源, 你应当使用after_stat

9、ement, 这样在每次JDBC调用后，都会主动的释放连接. 对于非JTA的连接, 使用after_transaction在每个事务结束时释放连接是合理的.auto将为JTA和CMT事务策略选择after_statement, 为JDBC事务策略选择after_transaction.取值on_close|after_transaction|after_statement|autohibernate.connection.将JDBC属性propertyName传递到DriverManager.getConnection()中去.hibernate.jndi.将属性propertyName传递到

10、JNDIInitialContextFactory中去.表3.5. Hibernate缓存属性属性名用途hibernate.cache.provider_class自定义的CacheProvider的类名.取值classname.of.CacheProviderhibernate.cache.use_minimal_puts以频繁的读操作为代价, 优化二级缓存来最小化写操作. 在Hibernate3中，这个设置对的集群缓存非常有用, 对集群缓存的实现而言，默认是开启的.取值true|falsehibernate.cache.use_query_cache允许查询缓存, 个别查询仍然需要被设置为

11、可缓存的.取值true|falsehibernate.cache.use_second_level_cache能用来完全禁止使用二级缓存. 对那些在类的映射定义中指定的类，会默认开启二级缓存.取值true|falsehibernate.cache.query_cache_factory自定义实现QueryCache接口的类名, 默认为内建的StandardQueryCache.取值classname.of.QueryCachehibernate.cache.region_prefix二级缓存区域名的前缀.取值prefixhibernate.cache.use_structured_entrie

12、s强制Hibernate以更人性化的格式将数据存入二级缓存.取值true|false表3.6. Hibernate事务属性属性名用途hibernate.transaction.factory_class一个TransactionFactory的类名, 用于HibernateTransactionAPI (默认为JDBCTransactionFactory).取值classname.of.TransactionFactoryjta.UserTransaction一个JNDI名字，被JTATransactionFactory用来从应用服务器获取JTAUserTransaction.取值jndi/c

13、omposite/namehibernate.transaction.manager_lookup_class一个TransactionManagerLookup的类名 - 当使用JVM级缓存，或在JTA环境中使用hilo生成器的时候需要该类.取值classname.of.TransactionManagerLookuphibernate.transaction.flush_before_completion如果开启, session在事务完成后将被自动清洗(flush)。 现在更好的方法是使用自动session上下文管理。取值true|falsehibernate.transaction.a

14、uto_close_session如果开启, session在事务完成后将被自动关闭。 现在更好的方法是使用自动session上下文管理。取值true|false表3.7. 其他属性属性名用途hibernate.current_session_context_class为当前Session指定一个(自定义的)策略。eg.jta|thread|custom.Classhibernate.query.factory_class选择HQL解析器的实现.取值org.hibernate.hql.ast.ASTQueryTranslatorFactoryororg.hibernate.hql.classi

15、c.ClassicQueryTranslatorFactoryhibernate.query.substitutions将Hibernate查询中的符号映射到SQL查询中的符号 (符号可能是函数名或常量名字).取值hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNChibernate.hbm2ddl.auto在SessionFactory创建时，自动检查数据库结构，或者将数据库schema的DDL导出到数据库. 使用create-drop时,在显式关闭SessionFactory时，将drop掉数据库schema.取值validate|update|creat

16、e|create-drophibernate.cglib.use_reflection_optimizer开启CGLIB来替代运行时反射机制(系统级属性). 反射机制有时在除错时比较有用. 注意即使关闭这个优化, Hibernate还是需要CGLIB. 你不能在hibernate.cfg.xml中设置此属性.取值true|false3.4.1. SQL方言你应当总是为你的数据库将hibernate.dialect属性设置成正确的org.hibernate.dialect.Dialect子类. 如果你指定一种方言, Hibernate将为上面列出的一些属性使用合理的默认值, 为你省去了手工指定它

17、们的功夫.表3.8. Hibernate SQL方言 (hibernate.dialect)RDBMS方言DB2org.hibernate.dialect.DB2DialectDB2 AS/400org.hibernate.dialect.DB2400DialectDB2 OS390org.hibernate.dialect.DB2390DialectPostgreSQLorg.hibernate.dialect.PostgreSQLDialectMySQLorg.hibernate.dialect.MySQLDialectMySQL with InnoDBorg.hibernate.dial

18、ect.MySQLInnoDBDialectMySQL with MyISAMorg.hibernate.dialect.MySQLMyISAMDialectOracle (any version)org.hibernate.dialect.OracleDialectOracle 9i/10gorg.hibernate.dialect.Oracle9DialectSybaseorg.hibernate.dialect.SybaseDialectSybase Anywhereorg.hibernate.dialect.SybaseAnywhereDialectMicrosoft SQL Serv

19、erorg.hibernate.dialect.SQLServerDialectSAP DBorg.hibernate.dialect.SAPDBDialectInformixorg.hibernate.dialect.InformixDialectHypersonicSQLorg.hibernate.dialect.HSQLDialectIngresorg.hibernate.dialect.IngresDialectProgressorg.hibernate.dialect.ProgressDialectMckoi SQLorg.hibernate.dialect.MckoiDialect

20、Interbaseorg.hibernate.dialect.InterbaseDialectPointbaseorg.hibernate.dialect.PointbaseDialectFrontBaseorg.hibernate.dialect.FrontbaseDialectFirebirdorg.hibernate.dialect.FirebirdDialect表3.9. Hibernate日志类别类别功能org.hibernate.SQL在所有SQL DML语句被执行时为它们记录日志org.hibernate.type为所有JDBC参数记录日志org.hibernate.tool.h

21、bm2ddl在所有SQL DDL语句执行时为它们记录日志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相

22、关信息做日志 (信息量较大, 但对查错非常有帮助)表3.10.JTA TransactionManagersTransaction工厂类应用程序服务器org.hibernate.transaction.JBossTransactionManagerLookupJBossorg.hibernate.transaction.WeblogicTransactionManagerLookupWeblogicorg.hibernate.transaction.WebSphereTransactionManagerLookupWebSphereorg.hibernate.transaction.WebSp

23、hereExtendedJTATransactionLookupWebSphere 6org.hibernate.transaction.OrionTransactionManagerLookupOrionorg.hibernate.transaction.ResinTransactionManagerLookupResinorg.hibernate.transaction.JOTMTransactionManagerLookupJOTMorg.hibernate.transaction.JOnASTransactionManagerLookupJOnASorg.hibernate.trans

24、action.JRun4TransactionManagerLookupJRun4org.hibernate.transaction.BESTransactionManagerLookupBorland ESposted on 2008-04-22 18:28芦苇阅读(17302)评论(1)编辑收藏所属分类:HibernateFeedback#re: Hibernate 参数设置一览表2008-10-14 18:13芦苇SQL方言1、Hibernate JDBC属性属性名用途hibernate.connection.driver_classjdbc驱动类hibernate.connection

25、.urljdbc URLhibernate.connection.username数据库用户hibernate.connection.password数据库用户密码hibernate.connection.pool_size连接池容量上限数目注：使用C3P0的properties样例代码：hibernate.connection.driver_class=org.postgresql.Driverhibernate.connection.url=jdbc:postgresql:/localhost/mydatabasehibernate.connection.username=myuserhi

26、bernate.connection.password=secrethibernate.c3p0.min_size=5hibernate.c3p0.max_size=20hibernate.c3p0.timeout=1800hibernate.c3p0.max_statements=50hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect2、Hibernate的数据源属性属性名用途hibernate.connection.datasource数据源JNDI名字hibernate.jndi.urlJNDI提供者的URL(可选)hibe

27、rnate.jndi.classJNDIInitialContextFactory类(可选)hibernate.connection.username数据库用户(可选)hibernate.connection.password数据库用户密码(可选)注：应用程序服务器JNDI数据源的hibernate.properties样例代码：hibernate.connection.datasource=java:/comp/env/jdbc/testhibernate.transaction.factory_class=org.hibernate.transaction.JTATransactionFa

28、ctoryhibernate.transaction.manager_lookup_class=org.hibernate.transaction.JBossTransactionManagerLookuphibernate.dialect=org.hibernate.dialect.PostgreSQLDialect3、Hibernate配置属性（可选）属性名用途hibernate.dialect一个HibernateDialect类名允许Hibernate针对特定的关系数据库生成优化的SQL.取值full.classname.of.Dialecthibernate.show_sql输出所有

29、SQL语句到控制台.取值true|falsehibernate.format_sql在log和console中打印出更漂亮的sql.取值true|falsehibernate.default_schema在生成的SQL中, 将给定的schema/tablespace附加于非全限定名的表名上.取值SCHEMA_NAMEhibernate.default_catalog在生成的SQL中, 将给定的catalog附加于没全限定名的表名上.取值CATALOG_NAMEhibernate.session_factory_nameSessionFactory创建后，将自动使用这个名字绑定到JNDI中.取值

30、jndi/composite/namehibernate.max_fetch_depth为单向关联(一对一, 多对一)的外连接抓取（outer join fetch）树设置最大深度. 值为0意味着将关闭默认的外连接抓取.取值建议在0到3之间取值hibernate.default_batch_fetch_size为Hibernate关联的批量抓取设置默认数量.取值建议的取值为4,8, 和16hibernate.default_entity_mode为由这个SessionFactory打开的所有Session指定默认的实体表现模式.取值dynamic-map,dom4j,pojohibernate

31、.order_updates强制Hibernate按照被更新数据的主键，为SQL更新排序。这么做将减少在高并发系统中事务的死锁。取值true|falsehibernate.generate_statistics如果开启, Hibernate将收集有助于性能调节的统计数据.取值true|falsehibernate.use_identifer_rollback如果开启, 在对象被删除时生成的标识属性将被重设为默认值.取值true|falsehibernate.use_sql_comments如果开启, Hibernate将在SQL中生成有助于调试的注释信息, 默认值为false.取值true|f

32、alse4、Hibernate JDBC和连接(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将为自动版本化

33、的数据使用批量DML. 默认值为false.eg.true|falsehibernate.jdbc.factory_class选择一个自定义的Batcher. 多数应用程序不需要这个配置属性.eg.classname.of.Batcherhibernate.jdbc.use_scrollable_resultset允许Hibernate使用JDBC2的可滚动结果集. 只有在使用用户提供的JDBC连接时，这个选项才是必要的, 否则Hibernate会使用连接的元数据.取值true|falsehibernate.jdbc.use_streams_for_binary在JDBC读写binary (二

34、进制)或serializable (可序列化)的类型时使用流(stream)(系统级属性).取值true|falsehibernate.jdbc.use_get_generated_keys在数据插入数据库之后，允许使用JDBC3PreparedStatement.getGeneratedKeys()来获取数据库生成的key(键)。需要JDBC3+驱动和JRE1.4+, 如果你的数据库驱动在使用Hibernate的标 识生成器时遇到问题，请将此值设为false. 默认情况下将使用连接的元数据来判定驱动的能力.取值true|falsehibernate.connection.provider_c

35、lass自定义ConnectionProvider的类名, 此类用来向Hibernate提供JDBC连接.取值classname.of.ConnectionProviderhibernate.connection.isolation设置JDBC事务隔离级别. 查看java.sql.Connection来了解各个值的具体意义, 但请注意多数数据库都不支持所有的隔离级别.取值1, 2, 4, 8hibernate.connection.autocommit允许被缓存的JDBC连接开启自动提交(autocommit) (不建议).取值true|falsehibernate.connection.re

36、lease_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|autoh

37、ibernate.connection.将JDBC属性propertyName传递到DriverManager.getConnection()中去.hibernate.jndi.将属性propertyName传递到JNDIInitialContextFactory中去.5、Hibernate缓存属性属性名用途hibernate.cache.provider_class自定义的CacheProvider的类名.取值classname.of.CacheProviderhibernate.cache.use_minimal_puts以频繁的读操作为代价, 优化二级缓存来最小化写操作. 在Hibern

38、ate3中，这个设置对的集群缓存非常有用, 对集群缓存的实现而言，默认是开启的.取值true|falsehibernate.cache.use_query_cache允许查询缓存, 个别查询仍然需要被设置为可缓存的.取值true|falsehibernate.cache.use_second_level_cache能用来完全禁止使用二级缓存. 对那些在类的映射定义中指定的类，会默认开启二级缓存.取值true|falsehibernate.cache.query_cache_factory自定义的实现QueryCache接口的类名, 默认为内建的StandardQueryCache.取值clas

39、sname.of.QueryCachehibernate.cache.region_prefix二级缓存区域名的前缀.取值prefixhibernate.cache.use_structured_entries强制Hibernate以更人性化的格式将数据存入二级缓存.取值true|false6、Hibernate事务属性属性名用途hibernate.transaction.factory_class一个TransactionFactory的类名, 用于HibernateTransactionAPI (默认为JDBCTransactionFactory).取值classname.of.Trans

40、actionFactoryjta.UserTransaction一个JNDI名字，被JTATransactionFactory用来从应用服务器获取JTAUserTransaction.取值jndi/composite/namehibernate.transaction.manager_lookup_class一个TransactionManagerLookup的类名 - 当使用JVM级缓存，或在JTA环境中使用hilo生成器的时候需要该类.取值classname.of.TransactionManagerLookuphibernate.transaction.flush_before_comp

41、letion如果开启, session在事务完成后将被自动清洗(flush). (在Hibernate和CMT一起使用时很有用.)取值true|falsehibernate.transaction.auto_close_session如果开启, session在事务完成前将被自动关闭. (在Hibernate和CMT一起使用时很有用.)取值true|false7、其他属性属性名用途hibernate.query.factory_class选择HQL解析器的实现.取值org.hibernate.hql.ast.ASTQueryTranslatorFactoryororg.hibernate.hq

42、l.classic.ClassicQueryTranslatorFactoryhibernate.query.substitutions将Hibernate查询中的符号映射到SQL查询中的符号 (符号可能是函数名或常量名字).取值hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNChibernate.hbm2ddl.auto在SessionFactory创建时，自动将数据库schema的DDL导出到数据库. 使用create-drop时,在显式关闭SessionFactory时，将drop掉数据库schema.取值update|create|create-dr

43、ophibernate.cglib.use_reflection_optimizer开启CGLIB来替代运行时反射机制(系统级属性). 反射机制有时在除错时比较有用. 注意即使关闭这个优化, Hibernate还是需要CGLIB. 你不能在hibernate.cfg.xml中设置此属性.取值true|false8、SQL方言 Hibernate SQL方言 (hibernate.dialect)RDBMS方言DB2org.hibernate.dialect.DB2DialectDB2 AS/400org.hibernate.dialect.DB2400DialectDB2 OS390org.h

44、ibernate.dialect.DB2390DialectPostgreSQLorg.hibernate.dialect.PostgreSQLDialectMySQLorg.hibernate.dialect.MySQLDialectMySQL with InnoDBorg.hibernate.dialect.MySQLInnoDBDialectMySQL with MyISAMorg.hibernate.dialect.MySQLMyISAMDialectOracle (any version)org.hibernate.dialect.OracleDialectOracle 9i/10g

45、org.hibernate.dialect.Oracle9DialectSybaseorg.hibernate.dialect.SybaseDialectSybase Anywhereorg.hibernate.dialect.SybaseAnywhereDialectMicrosoft SQL Serverorg.hibernate.dialect.SQLServerDialectSAP DBorg.hibernate.dialect.SAPDBDialectInformixorg.hibernate.dialect.InformixDialectHypersonicSQLorg.hibernate.dialect.HSQLDialectIngresorg.hibernate.dialect.IngresDialectProgressorg.hibernate.dialect.ProgressDialectMckoi SQLorg.hibernate.dialect.MckoiDialectInterbaseorg.hibernate.dialect.InterbaseDialectPointbase