3.4. 可選的配置屬性 · Java 開源項目中文文檔

# 3.4\. 可選的配置屬性有大量屬性能用來控制Hibernate在運行期的行為. 它們都是可選的, 并擁有適當的默認值. _警告: 其中一些屬性是"系統級(system-level)的"._ 系統級屬性只能通過`java -Dproperty=value`或 `hibernate.properties`來設置, 而_不能_用上面描述的其他方法來設置. **表 3.3\. 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` | **表 3.4\. 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`的連接釋放模式。請參閱[第 2.5 節 “上下文相關的（Contextual）Session”](../Text/pr01_split_000.html "2.5\. 上下文相關的（Contextual）Session")。 | | `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` | 以頻繁的讀操作為代價, 優化二級緩存來最小化寫操作. 在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` | **表 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環境中使用hilo生成器的時候需要該類. **取值** `classname.of.TransactionManagerLookup` | | `hibernate.transaction.flush_before_completion` | 如果開啟, session在事務完成后將被自動清洗(flush)。現在更好的方法是使用自動session上下文管理。請參見[第 2.5 節 “上下文相關的（Contextual）Session”](../Text/pr01_split_000.html "2.5\. 上下文相關的（Contextual）Session")。 **取值** `true` | `false` | | `hibernate.transaction.auto_close_session` | 如果開啟, session在事務完成后將被自動關閉。現在更好的方法是使用自動session上下文管理。請參見[第 2.5 節 “上下文相關的（Contextual）Session”](../Text/pr01_split_000.html "2.5\. 上下文相關的（Contextual）Session")。 **取值** `true` | `false` | **表 3.7\. 其他屬性** | 屬性名 | 用途 | | --- | --- | | `hibernate.current_session_context_class` | 為"當前" `Session`指定一個(自定義的)策略。關于內置策略的詳情，請參見[第 2.5 節 “上下文相關的（Contextual）Session”](../Text/pr01_split_000.html "2.5\. 上下文相關的（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` |