屬性名 |
用途 |
hibernate.dialect |
一個Hibernate Dialect類名允許Hibernate針對特定的關系數(shù)據(jù)庫生成優(yōu)化的SQL. 取值 full.classname.of.Dialect |
hibernate.show_sql |
輸出所有SQL語句到控制臺. 有一個另外的選擇是把org.hibernate.SQL這個log category設為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_name |
SessionFactory創(chuàng)建后,將自動使用這個名字綁定到JNDI中. 取值 jndi/composite/name |
hibernate.max_fetch_depth |
為單向關聯(lián)(一對一, 多對一)的外連接抓取(outer join fetch)樹設置最大深度. 值為0意味著將關閉默認的外連接抓取. 取值 建議在0到3之間取值 |
hibernate.default_batch_fetch_size |
為Hibernate關聯(lián)的批量抓取設置默認數(shù)量. 取值 建議的取值為4, 8, 和16 |
hibernate.default_entity_mode |
為由這個SessionFactory打開的所有Session指定默認的實體表現(xiàn)模式. 取值 dynamic-map, dom4j, pojo |
hibernate.order_updates |
強制Hibernate按照被更新數(shù)據(jù)的主鍵,為SQL更新排序。這么做將減少在高并發(fā)系統(tǒng)中事務的死鎖。 取值 true | false |
hibernate.generate_statistics |
如果開啟, Hibernate將收集有助于性能調節(jié)的統(tǒng)計數(shù)據(jù). 取值 true | false |
hibernate.use_identifer_rollback |
如果開啟, 在對象被刪除時生成的標識屬性將被重設為默認值. 取值 true | false |
hibernate.use_sql_comments |
如果開啟, Hibernate將在SQL中生成有助于調試的注釋信息, 默認值為false. 取值 true | false |
表 3.4. Hibernate JDBC和連接(connection)屬性
屬性名 |
用途 |
hibernate.jdbc.fetch_size |
非零值,指定JDBC抓取數(shù)量的大小 (調用Statement.setFetchSize()). |
hibernate.jdbc.batch_size |
非零值,允許Hibernate使用JDBC2的批量更新. 取值 建議取5到30之間的值 |
hibernate.jdbc.batch_versioned_data |
如果你想讓你的JDBC驅動從executeBatch()返回正確的行計數(shù) , 那么將此屬性設為true(開啟這個選項通常是安全的). 同時,Hibernate將為自動版本化的數(shù)據(jù)使用批量DML. 默認值為false. eg. true | false |
hibernate.jdbc.factory_class |
選擇一個自定義的Batcher. 多數(shù)應用程序不需要這個配置屬性. eg. classname.of.Batcher |
hibernate.jdbc.use_scrollable_resultset |
允許Hibernate使用JDBC2的可滾動結果集. 只有在使用用戶提供的JDBC連接時,這個選項才是必要的, 否則Hibernate會使用連接的元數(shù)據(jù). 取值 true | false |
hibernate.jdbc.use_streams_for_binary |
在JDBC讀寫binary (二進制)或serializable (可序列化) 的類型時使用流(stream)(系統(tǒng)級屬性). 取值 true | false |
hibernate.jdbc.use_get_generated_keys |
在數(shù)據(jù)插入數(shù)據(jù)庫之后,允許使用JDBC3 PreparedStatement.getGeneratedKeys() 來獲取數(shù)據(jù)庫生成的key(鍵)。需要JDBC3+驅動和JRE1.4+, 如果你的數(shù)據(jù)庫驅動在使用Hibernate的標 識生成器時遇到問題,請將此值設為false. 默認情況下將使用連接的元數(shù)據(jù)來判定驅動的能力. 取值 true|false |
hibernate.connection.provider_class |
自定義ConnectionProvider的類名, 此類用來向Hibernate提供JDBC連接. 取值 classname.of.ConnectionProvider |
hibernate.connection.isolation |
設置JDBC事務隔離級別. 查看java.sql.Connection來了解各個值的具體意義, 但請注意多數(shù)數(shù)據(jù)庫都不支持所有的隔離級別. 取值 1, 2, 4, 8 |
hibernate.connection.autocommit |
允許被緩存的JDBC連接開啟自動提交(autocommit) (不建議). 取值 true | false |
hibernate.connection.release_mode |
指定Hibernate在何時釋放JDBC連接. 默認情況下,直到Session被顯式關閉或被斷開連接時,才會釋放JDBC連接. 對于應用程序服務器的JTA數(shù)據(jù)源, 你應當使用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傳遞到JNDI InitialContextFactory中去. |
表 3.5. Hibernate緩存屬性
屬性名 |
用途 |
hibernate.cache.provider_class |
自定義的CacheProvider的類名. 取值 classname.of.CacheProvider |
hibernate.cache.use_minimal_puts |
以頻繁的讀操作為代價, 優(yōu)化二級緩存來最小化寫操作. 在Hibernate3中,這個設置對的集群緩存非常有用, 對集群緩存的實現(xiàn)而言,默認是開啟的. 取值 true|false |
hibernate.cache.use_query_cache |
允許查詢緩存, 個別查詢仍然需要被設置為可緩存的. 取值 true|false |
hibernate.cache.use_second_level_cache |
能用來完全禁止使用二級緩存. 對那些在類的映射定義中指定<cache>的類,會默認開啟二級緩存. 取值 true|false |
hibernate.cache.query_cache_factory |
自定義實現(xiàn)QueryCache接口的類名, 默認為內建的StandardQueryCache. 取值 classname.of.QueryCache |
hibernate.cache.region_prefix |
二級緩存區(qū)域名的前綴. 取值 prefix |
hibernate.cache.use_structured_entries |
強制Hibernate以更人性化的格式將數(shù)據(jù)存入二級緩存. 取值 true|false |
表 3.6. Hibernate事務屬性
屬性名 |
用途 |
hibernate.transaction.factory_class |
一個TransactionFactory的類名, 用于Hibernate Transaction API (默認為JDBCTransactionFactory). 取值 classname.of.TransactionFactory |
jta.UserTransaction |
一個JNDI名字,被JTATransactionFactory用來從應用服務器獲取JTA UserTransaction. 取值 jndi/composite/name |
hibernate.transaction.manager_lookup_class |
一個TransactionManagerLookup的類名 - 當使用JVM級緩存,或在JTA環(huán)境中使用hilo生成器的時候需要該類. 取值 classname.of.TransactionManagerLookup |
hibernate.transaction.flush_before_completion |
如果開啟, session在事務完成后將被自動清洗(flush)。 現(xiàn)在更好的方法是使用自動session上下文管理。取值 true | false |
hibernate.transaction.auto_close_session |
如果開啟, session在事務完成后將被自動關閉。 現(xiàn)在更好的方法是使用自動session上下文管理。取值 true | false |
表 3.7. 其他屬性
屬性名 |
用途 |
hibernate.current_session_context_class |
為"當前" Session指定一個(自定義的)策略。eg. jta | thread | custom.Class |
hibernate.query.factory_class |
選擇HQL解析器的實現(xiàn). 取值 org.hibernate.hql.ast.ASTQueryTranslatorFactory or org.hibernate.hql.classic.ClassicQueryTranslatorFactory |
hibernate.query.substitutions |
將Hibernate查詢中的符號映射到SQL查詢中的符號 (符號可能是函數(shù)名或常量名字). 取值 hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNC |
hibernate.hbm2ddl.auto |
在SessionFactory創(chuàng)建時,自動檢查數(shù)據(jù)庫結構,或者將數(shù)據(jù)庫schema的DDL導出到數(shù)據(jù)庫. 使用 create-drop時,在顯式關閉SessionFactory時,將drop掉數(shù)據(jù)庫schema. 取值 validate | update | create | create-drop |
hibernate.cglib.use_reflection_optimizer |
開啟CGLIB來替代運行時反射機制(系統(tǒng)級屬性). 反射機制有時在除錯時比較有用. 注意即使關閉這個優(yōu)化, Hibernate還是需要CGLIB. 你不能在hibernate.cfg.xml中設置此屬性. 取值 true | false |
你應當總是為你的數(shù)據(jù)庫將hibernate.dialect屬性設置成正確的 org.hibernate.dialect.Dialect子類. 如果你指定一種方言, Hibernate將為上面列出的一些屬性使用合理的默認值, 為你省去了手工指定它們的功夫.
表 3.8. Hibernate SQL方言 (hibernate.dialect)
RDBMS |
方言 |
DB2 |
org.hibernate.dialect.DB2Dialect |
DB2 AS/400 |
org.hibernate.dialect.DB2400Dialect |
DB2 OS390 |
org.hibernate.dialect.DB2390Dialect |
PostgreSQL |
org.hibernate.dialect.PostgreSQLDialect |
MySQL |
org.hibernate.dialect.MySQLDialect |
MySQL with InnoDB |
org.hibernate.dialect.MySQLInnoDBDialect |
MySQL with MyISAM |
org.hibernate.dialect.MySQLMyISAMDialect |
Oracle (any version) |
org.hibernate.dialect.OracleDialect |
Oracle 9i/10g |
org.hibernate.dialect.Oracle9Dialect |
Sybase |
org.hibernate.dialect.SybaseDialect |
Sybase Anywhere |
org.hibernate.dialect.SybaseAnywhereDialect |
Microsoft SQL Server |
org.hibernate.dialect.SQLServerDialect |
SAP DB |
org.hibernate.dialect.SAPDBDialect |
Informix |
org.hibernate.dialect.InformixDialect |
HypersonicSQL |
org.hibernate.dialect.HSQLDialect |
Ingres |
org.hibernate.dialect.IngresDialect |
Progress |
org.hibernate.dialect.ProgressDialect |
Mckoi SQL |
org.hibernate.dialect.MckoiDialect |
Interbase |
org.hibernate.dialect.InterbaseDialect |
Pointbase |
org.hibernate.dialect.PointbaseDialect |
FrontBase |
org.hibernate.dialect.FrontbaseDialect |
Firebird |
org.hibernate.dialect.FirebirdDialect |
表 3.9. Hibernate日志類別
類別 |
功能 |
org.hibernate.SQL |
在所有SQL DML語句被執(zhí)行時為它們記錄日志 |
org.hibernate.type |
為所有JDBC參數(shù)記錄日志 |
org.hibernate.tool.hbm2ddl |
在所有SQL DDL語句執(zhí)行時為它們記錄日志 |
org.hibernate.pretty |
在session清洗(flush)時,為所有與其關聯(lián)的實體(最多20個)的狀態(tài)記錄日志 |
org.hibernate.cache |
為所有二級緩存的活動記錄日志 |
org.hibernate.transaction |
為事務相關的活動記錄日志 |
org.hibernate.jdbc |
為所有JDBC資源的獲取記錄日志 |
org.hibernate.hql.AST |
在解析查詢的時候,記錄HQL和SQL的AST分析日志 |
org.hibernate.secure |
為JAAS認證請求做日志 |
org.hibernate |
為任何Hibernate相關信息做日志 (信息量較大, 但對查錯非常有幫助) |
表 3.10. JTA TransactionManagers
Transaction工廠類 |
應用程序服務器 |
org.hibernate.transaction.JBossTransactionManagerLookup |
JBoss |
org.hibernate.transaction.WeblogicTransactionManagerLookup |
Weblogic |
org.hibernate.transaction.WebSphereTransactionManagerLookup |
WebSphere |
org.hibernate.transaction.WebSphereExtendedJTATransactionLookup |
WebSphere 6 |
org.hibernate.transaction.OrionTransactionManagerLookup |
Orion |
org.hibernate.transaction.ResinTransactionManagerLookup |
Resin |
org.hibernate.transaction.JOTMTransactionManagerLookup |
JOTM |
org.hibernate.transaction.JOnASTransactionManagerLookup |
JOnAS |
org.hibernate.transaction.JRun4TransactionManagerLookup |
JRun4 |
org.hibernate.transaction.BESTransactionManagerLookup |
Borland ES |
|