Hibernate文檔筆記共分為三個部分，此處是第三部分，重點講述了可選配置項，它包括Hibernate配置項、Hibernate JDBC和連接的屬性、Hibernate Cache 屬性、Hibernate事務屬性和Miscellaneous properties 各種混合的屬性。

九、可選配置項

下面介紹的Hibernate屬性，有一些是系統級別的。系統級別的屬性只能通過-Dproperty=value來設置或在hibernate.properties文件中設置，不能使用上面的方式設置。

1.Hibernate配置項

（1）hibernate.dialect指定方言后，Hibernate可以根據低層數據庫自動產生優化過的SQL。取值為org.hibenate.dialect.Dialect的繼承類。多數情況下，Hibernate可以根據低層JDBC返回的metadata來判斷。

（2）hibernate.show_sql打印所有的SQL語句到控制臺，可以通過設置org.hibernate.SQL類的日志策略到DEBUG級，實現同樣的效果。取值true|false。

（3）hibernate.format_sql 格式化SQL語句在打印到控制臺或寫入日志文件時。取值true|false。

（4）hibernate.default_schema 在產生SQL語句時，在表名前加上映射文件給出的表空間（tablespace）或數據庫模式（schema）。取值SCHEMA_NAME。

（5）hibernate.default_catalog 在產生SQL語句時，在表名前加上映射文件給出的catalog。取值CATALOG_NAME。

（6）hibernate.session_factory_name  Hibernate創建org.hibernate.SessionFactory實例后后會自動的將這個綁定到JNDI中的名字上。取值jndi/sf。

（7）hibernate.max_fetch_depth 設置對單個表的外連接數最大深度。0是屏蔽默認的外連接設置。推薦設置為0到3之間。

（8）hibernate.default_batch_fetch_size 設置Hibernate批量聯合查詢的尺度。強烈建議。推薦設置為4、8、16。

（9）hibernate.default_entity_mode 默認的實體表現模式，通過SessionFactory打開的所有的Session。取值，dynamic-map、dom4j、pojo。

（10）hibernate.order_updates 強迫Hibernate通過被更新項的主鍵值排序SQL更新。這樣可以在高并發時，減少事務死鎖。取值true|false。

（11）hibernate.generate_statistics 如果設置為true，Hibernate將為性能調整，收集統計信息。取值true|false。

（12）hibernate.use_identifier_rollback 如果設置為true，產生的標識屬性將被重置成默認值，當對象被刪除后。取值為true|false。

（13）hibernate.use_sql_comments  如果設置為true，Hiberante將為SQL產生注釋，這樣更利于調試。默認值為false。取值為true|false。

2.Hibernate JDBC和連接的屬性

（1）hibernate.jdbc.fetch_size 指定JDBC的查詢尺度。通過調用（Statement.setFetchSize()）。

（2）hibernate.jdbc.batch_size 指定Hibernate如何使用JDBC2批量更新。取值，推薦5到30。

（3）hibernate.jdbc.batch_versioned_data 設置這個屬性為true，JDBC將返回executeBatch執行后正確的行數。打開這個參數，通常是安全的。Hibernate將自動的譯碼這些數據使用批量DML。默認為false。取值true|false。

（4）hibernate.jdbc.factory_class 選擇一個定制的org.hibernate.jdbc.Batcher。所有的應用程序不需要配置這個屬性。取值，定義工廠的類名。

（5）hibernate.jdbc.use_scrollable_resultset  Hibernate使用JDBC2的可滾動記錄集。當使用用戶提供的JDBC連接時，需要設置這個參數。否則，Hibernate使用連接MetaData。取值true|false。

（6）hibernate.jdbc.use_streams_for_binary 當讀或寫二進制數據或序列化數據從JDBC或到JDBC，使用流。系統級的數據。設置true|false。

（7）hibernate.jdbc.use_get_generated_keys 在插入后，可以使用JDBC3的PreparedStatement.getGeneratedKeys()中的值找回本地產生的鍵值。要求JDBC3+和JRE1.4+，如果使用Hibernate identifier generator后你的驅動程序有問題，請設置為false。默認情況下，設法連接MetaData來決定。取值，true|false。

（8）hibernate.connection.provider_class 實現了org.hibernate.connection.ConnectionProvider 接口的類的名稱，為Hibernate提供連接。

（9）hibernate.connection.isolation 設置JDBC事務隔離的級別。檢查java.sql.Connection的定義的常量值，但要注意大多數數據庫不支持所有的隔離級別、一些附加的和非標準的隔離級別。取值，1、2、4、8。

（10）hibernate.connection.autocommit  JDBC共享連接的自動提交。（不推薦）取值，true|false。

（11）hibernate.connection.release_mode 指定什么時候，Hibernate應該釋放JDBC連接。默認情況下，JDBC是一直存在，只到Session是被明確關閉或斷開連接時。對于應用的服務器JTA數據源，你應該使用after_statement強制釋放JDBC連接在每個JDBC請求結束后。對于非JTA數據源，通常是在每個事務結束后釋放JDBC連接是有意義的。將該值設為auto時，JTA和CMT事務策略時，是選擇after_statement方式。JDBC事務策略時，是選擇after_transaction。取值，auto(default)，on_close，after_statment，after_transaction。

注意：這個設置只影響通過SessionFactory.openSession打開的session。對于通過SessionFactory.getCurrentSession獲取的session，CurrentSessionContext實現類的配置是用來控制這些session的連接釋放模式。

（12）hibernate.connection. 傳遞這些屬性到DriverManager.getConnection中。

（13）hibernate.jndi. 傳遞這些屬性到JNDI InitialContextFactory。

3.Hibernate Cache 屬性

（1）hibernate.cache.provider_class 定制的CacheProvider的類名。

（2）hibernate.cache.use_minimal_puts 花費更多的讀操作，來優化二級緩存的最少寫操作。這個操作對于集群緩存是非常有用的。在Hibernate3中，對于集群緩存是默認開啟該功能的。取值，true|false。

（3）hibernate.cache.use_query_cache 開啟查詢緩存，個別查詢肯定應該開啟查詢緩存。取值，true|false。

（4）hibernate.cache.use_second_level_cache 也許過去習慣于完全屏蔽掉二級緩存，默認是開啟，對于指定CacheProvider實現類的情況。取值，true|false。

（5）hibernate.cache.query_cache_factory  實現QueryCache接口的類名，默認是內置的StandardQueryCache。

（6）hibernate.cache.region_prefix 對于使用二級緩存區域名的前綴。

（7）hibernate.cache.use_structured_entries 強迫Hibernate在存儲數據到二級緩存時，使用更人性化的格式。取值，true|false。

4.Hibernate事務屬性

（1）hibernate.transaction.transaction_class  使用Hibernate事務APIs的TransactionFactory的類名。默認是JDBCTransactionFactory。

（2）jta.UserTransaction  JTATransactionFactory使用JNDI名字從應用服務器中獲取JTA UserTransaction。取值，jndi/ut。

（3）hibernate.transaction.manager_lookup_class 是一個TransactionManagerLookup實現類的類名。當JVM級別的緩存開啟時或在JTA環境中使用hilo generator時，要求指定該值。

（4）hibernate.transaction.flush_before_completion 如果設為true，session將在事務完成階段之前，自動將緩存區的值推入到數據庫中。內置和自動session上下文管理是被優先選用的。取值，true|false。

（5）hibernate.transaction.auto_close_session 如果設為true，session將在事務完成之后，自動的關閉session。內置和自動session上下文管理是被優先選用的。取值，true|false。

5.Miscellaneous properties 各種混合的屬性

（1）hibernate.current_session_context_class 提供一個對于當前session生命周期的策略。取值，jta、thread、managed、定制類名。

（2）hibernate.query.factory_class 選擇HSQL的解析實現類。取值，org.hibernate.hsql.ast.ASTQueryTranslatorFactory和org.hibernate.hsql.classic.ClassicQueryTranslatorFactory。

（3）hibernate.query.subsitutions Hibernate中標記符到SQL中標記符的映射。舉例說，可以是函數名或普通字符串名。取值，如hsqLiteral=SQL_LITERAL，hqlFunction=SQLFUN。

（4）hibernate.hbm2ddl.auto 當SessionFactory被創建時，自動的驗證或輸出模式DDL（也就建表語句）到數據庫中。也就是說，自動的驗證數據庫表結構或先刪除再重新建立，或在原表結構上更新數據表結構。當將值置為create-drop時，在SessionFactory被清除時，將刪除數據庫中表結構。取值，validate、create、update、create-drop。

（5）hibernate.cglib.use_reflection_optimizer 用CGLIB代替運行期的reflection（系統級屬性）。在有故障時，反射是非常有用的，注意Hibernate總是需要CGLIB，甚至在你關閉優化后。你不可以設置這個屬性在hibernate.cfg.xml文件中。