Hibernate 3.2 可選的配置屬性
有大量屬性能用來控制Hibernate在運(yùn)行期的行為. 它們都是可選的, 并擁有適當(dāng)?shù)哪J(rèn)值.
警告: 其中一些屬性是"系統(tǒng)級(system-level)的". 系統(tǒng)級屬性只能通過java -Dproperty=value或 hibernate.properties來設(shè)置, 而不能用上面描述的其他方法來設(shè)置.
表 1 Hibernate配置屬性
屬性名 | 用途 |
---|---|
hibernate.dialect | 一個Hibernate Dialect類名允許Hibernate針對特定的關(guān)系數(shù)據(jù)庫生成優(yōu)化的SQL.
取值 full.classname.of.Dialect |
hibernate.show_sql | 輸出所有SQL語句到控制臺. 有一個另外的選擇是把org.hibernate.SQL這個log
category設(shè)為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 | 為單向關(guān)聯(lián)(一對一, 多對一)的外連接抓取(outer join fetch)樹設(shè)置最大深度. 值為0意味著將關(guān)閉默認(rèn)的外連接抓取.
取值 建議在0到3之間取值 |
hibernate.default_batch_fetch_size | 為Hibernate關(guān)聯(lián)的批量抓取設(shè)置默認(rèn)數(shù)量.
取值 建議的取值為4, 8, 和16 |
hibernate.default_entity_mode | 為由這個SessionFactory打開的所有Session指定默認(rèn)的實(shí)體表現(xiàn)模式.
取值 dynamic-map, dom4j, pojo |
hibernate.order_updates | 強(qiáng)制Hibernate按照被更新數(shù)據(jù)的主鍵,為SQL更新排序。這么做將減少在高并發(fā)系統(tǒng)中事務(wù)的死鎖。
取值 true | false |
hibernate.generate_statistics | 如果開啟, Hibernate將收集有助于性能調(diào)節(jié)的統(tǒng)計數(shù)據(jù).
取值 true | false |
hibernate.use_identifer_rollback | 如果開啟, 在對象被刪除時生成的標(biāo)識屬性將被重設(shè)為默認(rèn)值.
取值 true | false |
hibernate.use_sql_comments | 如果開啟, Hibernate將在SQL中生成有助于調(diào)試的注釋信息, 默認(rèn)值為false.
取值 true | false |
表 2 Hibernate JDBC和連接(connection)屬性
屬性名 | 用途 |
---|---|
hibernate.jdbc.fetch_size | 非零值,指定JDBC抓取數(shù)量的大小 (調(diào)用Statement.setFetchSize()). |
hibernate.jdbc.batch_size | 非零值,允許Hibernate使用JDBC2的批量更新.
取值 建議取5到30之間的值 |
hibernate.jdbc.batch_versioned_data | 如果你想讓你的JDBC驅(qū)動從executeBatch()返回正確的行計數(shù) , 那么將此屬性設(shè)為true(開啟這個選項通常是安全的). 同時,Hibernate將為自動版本化的數(shù)據(jù)使用批量DML. 默認(rèn)值為false.
eg. true | false |
hibernate.jdbc.factory_class | 選擇一個自定義的Batcher. 多數(shù)應(yīng)用程序不需要這個配置屬性.
eg. classname.of.Batcher |
hibernate.jdbc.use_scrollable_resultset | 允許Hibernate使用JDBC2的可滾動結(jié)果集. 只有在使用用戶提供的JDBC連接時,這個選項才是必要的,
否則Hibernate會使用連接的元數(shù)據(jù).
取值 true | false |
hibernate.jdbc.use_streams_for_binary | 在JDBC讀寫binary (二進(jìn)制)或serializable
(可序列化) 的類型時使用流(stream)(系統(tǒng)級屬性).
取值 true | false |
hibernate.jdbc.use_get_generated_keys | 在數(shù)據(jù)插入數(shù)據(jù)庫之后,允許使用JDBC3 PreparedStatement.getGeneratedKeys()
來獲取數(shù)據(jù)庫生成的key(鍵)。需要JDBC3+驅(qū)動和JRE1.4+, 如果你的數(shù)據(jù)庫驅(qū)動在使用Hibernate的標(biāo)
識生成器時遇到問題,請將此值設(shè)為false. 默認(rèn)情況下將使用連接的元數(shù)據(jù)來判定驅(qū)動的能力.
取值 true|false |
hibernate.connection.provider_class | 自定義ConnectionProvider的類名, 此類用來向Hibernate提供JDBC連接.
取值 classname.of.ConnectionProvider |
hibernate.connection.isolation | 設(shè)置JDBC事務(wù)隔離級別. 查看java.sql.Connection來了解各個值的具體意義,
但請注意多數(shù)數(shù)據(jù)庫都不支持所有的隔離級別.
取值 1, 2, 4, 8 |
hibernate.connection.autocommit | 允許被緩存的JDBC連接開啟自動提交(autocommit) (不建議).
取值 true | false |
hibernate.connection.release_mode | 指定Hibernate在何時釋放JDBC連接. 默認(rèn)情況下,直到Session被顯式關(guān)閉或被斷開連接時,才會釋放JDBC連接.
對于應(yīng)用程序服務(wù)器的JTA數(shù)據(jù)源, 你應(yīng)當(dāng)使用after_statement,
這樣在每次JDBC調(diào)用后,都會主動的釋放連接. 對于非JTA的連接, 使用after_transaction在每個事務(wù)結(jié)束時釋放連接是合理的. auto將為JTA和CMT事務(wù)策略選擇after_statement,
為JDBC事務(wù)策略選擇after_transaction.
取值 auto (默認(rèn)) | on_close | after_transaction | after_statement 注意,這些設(shè)置僅對通過SessionFactory.openSession得到的Session起作用。對于通過SessionFactory.getCurrentSession得到的Session,所配置的CurrentSessionContext實(shí)現(xiàn)控制這些Session的連接釋放模式。請參閱“上下文相關(guān)的(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 | 以頻繁的讀操作為代價, 優(yōu)化二級緩存來最小化寫操作. 在Hibernate3中,這個設(shè)置對的集群緩存非常有用, 對集群緩存的實(shí)現(xiàn)而言,默認(rèn)是開啟的.
取值 true|false |
hibernate.cache.use_query_cache | 允許查詢緩存, 個別查詢?nèi)匀恍枰辉O(shè)置為可緩存的.
取值 true|false |
hibernate.cache.use_second_level_cache | 能用來完全禁止使用二級緩存. 對那些在類的映射定義中指定<cache>的類,會默認(rèn)開啟二級緩存.
取值 true|false |
hibernate.cache.query_cache_factory | 自定義實(shí)現(xiàn)QueryCache接口的類名, 默認(rèn)為內(nèi)建的StandardQueryCache.
取值 classname.of.QueryCache |
hibernate.cache.region_prefix | 二級緩存區(qū)域名的前綴.
取值 prefix |
hibernate.cache.use_structured_entries | 強(qiáng)制Hibernate以更人性化的格式將數(shù)據(jù)存入二級緩存.
取值 true|false |
表 4 Hibernate事務(wù)屬性
屬性名 | 用途 |
---|---|
hibernate.transaction.factory_class | 一個TransactionFactory的類名, 用于Hibernate Transaction API (默認(rèn)為JDBCTransactionFactory).
取值 classname.of.TransactionFactory |
jta.UserTransaction | 一個JNDI名字,被JTATransactionFactory用來從應(yīng)用服務(wù)器獲取JTA UserTransaction.
取值 jndi/composite/name |
hibernate.transaction.manager_lookup_class | 一個TransactionManagerLookup的類名 -
當(dāng)使用JVM級緩存,或在JTA環(huán)境中使用hilo生成器的時候需要該類.
取值 classname.of.TransactionManagerLookup |
hibernate.transaction.flush_before_completion | 如果開啟, session在事務(wù)完成后將被自動清洗(flush)。 現(xiàn)在更好的方法是使用自動session上下文管理。請參見“上下文相關(guān)的(Contextual)Session”。
取值 true | false |
hibernate.transaction.auto_close_session | 如果開啟, session在事務(wù)完成后將被自動關(guān)閉。 現(xiàn)在更好的方法是使用自動session上下文管理。請參見“上下文相關(guān)的(Contextual)Session”。
取值 true | false |
表 5 其他屬性
屬性名 | 用途 |
---|---|
hibernate.current_session_context_class | 為"當(dāng)前" Session指定一個(自定義的)策略。關(guān)于內(nèi)置策略的詳情,請參見“上下文相關(guān)的(Contextual)Session” 。
eg. jta | thread | managed | custom.Class |
hibernate.query.factory_class | 選擇HQL解析器的實(shí)現(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ù)庫結(jié)構(gòu),或者將數(shù)據(jù)庫schema的DDL導(dǎo)出到數(shù)據(jù)庫.
使用 create-drop時,在顯式關(guān)閉SessionFactory時,將drop掉數(shù)據(jù)庫schema.
取值 validate | update | create | create-drop |
hibernate.cglib.use_reflection_optimizer | 開啟CGLIB來替代運(yùn)行時反射機(jī)制(系統(tǒng)級屬性). 反射機(jī)制有時在除錯時比較有用. 注意即使關(guān)閉這個優(yōu)化, Hibernate還是需要CGLIB.
你不能在hibernate.cfg.xml中設(shè)置此屬性.
取值 true | false |
posted on 2009-10-12 09:22 vanlin 閱讀(225) 評論(0) 編輯 收藏 所屬分類: hibernate