| 屬性名 | 用途 |
|---|---|
| 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. 取值 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 | 以頻繁的讀操作爲代價, 優化二級緩存來最小化寫操作. 在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用來從應用服務器獲取JTAUserTransaction. 取值 jndi/composite/name |
| hibernate.transaction.manager_lookup_class | 一個TransactionManagerLookup的類名 - 當使用JVM級緩存，或在JTA環境中使用hilo生成器的時候需要該類. 取值 classname.of.TransactionManagerLookup |
| hibernate.transaction.flush_before_completion | 如果開啓, session在事務完成後將被自動清洗(flush)。 現在更好的方法是使用自動session上下文管理。取值 true | false |
| hibernate.transaction.auto_close_session | 如果開啓, session在事務完成後將被自動關閉。 現在更好的方法是使用自動session上下文管理。取值 true | false |
表 3.7. 其他屬性
| 屬性名 | 用途 |
|---|---|
| hibernate.current_session_context_class | 爲"當前" Session指定一個(自定義的)策略。eg. jta | thread | custom.Class |
| hibernate.query.factory_class | 選擇HQL解析器的實現. 取值 org.hibernate.hql.ast.ASTQueryTranslatorFactory ororg.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 |
你應當總是爲你的數據庫將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語句被執行時爲它們記錄日誌 |
| org.hibernate.type | 爲所有JDBC參數記錄日誌 |
| org.hibernate.tool.hbm2ddl | 在所有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相關信息做日誌 (信息量較大, 但對查錯非常有幫助) |
表 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 |