Hibernate 3.2 可選的配置屬性
有大量屬性能用來控制Hibernate在運行期的行為. 它們都是可選的, 并擁有適當的默認值.
警告: 其中一些屬性是"系統級(system-level)的". 系統級屬性只能通過java -Dproperty=value或 hibernate.properties來設置, 而不能用上面描述的其他方法來設置.
表 1 Hibernate配置屬性
屬性名 | 用途 |
---|---|
hibernate.dialect | 一個Hibernate Dialect類名允許Hibernate針對特定的關系數據庫生成優化的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創建后,將自動使用這個名字綁定到JNDI中.
取值 jndi/composite/name |
hibernate.max_fetch_depth | 為單向關聯(一對一, 多對一)的外連接抓取(outer join fetch)樹設置最大深度. 值為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 |
表 2 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將為自動版本化的數據使用批量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 | 在數據插入數據庫之后,允許使用JDBC3 PreparedStatement.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.
取值 auto (默認) | on_close | after_transaction | after_statement 注意,這些設置僅對通過SessionFactory.openSession得到的Session起作用。對于通過SessionFactory.getCurrentSession得到的Session,所配置的CurrentSessionContext實現控制這些Session的連接釋放模式。請參閱“上下文相關的(Contextual)Session”。 |
hibernate.connection.<propertyName> | 將JDBC屬性propertyName傳遞到DriverManager.getConnection()中去. |
hibernate.jndi.<propertyName> | 將屬性propertyName傳遞到JNDI InitialContextFactory中去. |
表 3 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 |
表 4 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環境中使用hilo生成器的時候需要該類.
取值 classname.of.TransactionManagerLookup |
hibernate.transaction.flush_before_completion | 如果開啟, session在事務完成后將被自動清洗(flush)。 現在更好的方法是使用自動session上下文管理。請參見“上下文相關的(Contextual)Session”。
取值 true | false |
hibernate.transaction.auto_close_session | 如果開啟, session在事務完成后將被自動關閉。 現在更好的方法是使用自動session上下文管理。請參見“上下文相關的(Contextual)Session”。
取值 true | false |
表 5 其他屬性
屬性名 | 用途 |
---|---|
hibernate.current_session_context_class | 為"當前" Session指定一個(自定義的)策略。關于內置策略的詳情,請參見“上下文相關的(Contextual)Session” 。
eg. jta | thread | managed | custom.Class |
hibernate.query.factory_class | 選擇HQL解析器的實現.
取值 org.hibernate.hql.ast.ASTQueryTranslatorFactory or 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 |
posted on 2009-10-12 09:22 vanlin 閱讀(223) 評論(0) 編輯 收藏 所屬分類: hibernate