hibernate.properties · JAVA

[TOC] # 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` | # 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 ?| 將JDBC屬性propertyName傳遞到DriverManager.getConnection()中去.| | hibernate.jndi. ?| ?將屬性propertyName傳遞到JNDI InitialContextFactory中去.| # 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` | ? ?能用來完全禁止使用二級緩存. 對那些在類的映射定義中指定的類，會默認開啟二級緩存. 取值 `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`| # 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上下文管理。取值 `true | false`| | `hibernate.transaction.auto_close_session` ? ?| 如果開啟, session在事務完成后將被自動關閉。現在更好的方法是使用自動session上下文管理。取值 `true | false`| # 其他屬性 | 屬性名 | 用途| | --- | --- | | `hibernate.current_session_context_class `?| ?為"當前" Session指定一個(自定義的)策略。eg. `jta | thread | 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`| # SQL方言你應當總是為你的數據庫將hibernate.dialect屬性設置成正確的 org.hibernate.dialect.Dialect子類. 如果你指定一種方言, Hibernate將為上面列出的一些屬性使用合理的默認值, 為你省去了手工指定它們的功夫. 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 ~~~ # 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相關信息做日志 (信息量較大, 但對查錯非常有幫助)| # 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| # 主鍵生成策略 1. 自動增長identity 適用于MySQL、DB2、MS SQL Server，采用數據庫生成的主鍵，用于為long、short、int類型生成唯一標識使用`SQL Server` 和 MySQL 的自增字段，這個方法不能放到 Oracle 中，Oracle 不支持自增字段，要設定sequence（MySQL 和 SQL Server 中很常用）數據庫中的語法如下： ~~~ MySQL：create table t_user(id int auto_increment primary key, name varchar(20)); SQL Server：create table t_user(id int identity(1,1) primary key, name varchar(20)); ~~~ ~~~ <id name="id" column="id" type="long"> <generator class="identity" /> </id> ~~~ 2. sequence DB2、Oracle均支持的序列，用于為long、short或int生成唯一標識數據庫中的語法如下： ~~~ Oracle：create sequence seq_name increment by 1 start with 1; ~~~ 需要主鍵值時可以調用`seq_name.nextval`或者`seq_name.curval`得到，數據庫會幫助我們維護這個sequence序列，保證每次取到的值唯一，如： ~~~ insert into tbl_name(id, name) values(seq_name.nextval, ‘Jimliu’); ~~~ ~~~ <id name="id" column="id" type="long"> <generator class="sequence"> <param name="sequence">seq_name</param> </generator> </id> ~~~ 如果我們沒有指定sequence參數，則Hibernate會訪問一個默認的sequence，是`hibernate_sequence`，我們也需要在數據庫中建立這個sequence 此外，sequence還可以有另外一個參數是paramters，可以查看Hibernate的API了解它的用法，見org.hibernate.id.SequenceGenerator 調用數據庫的sequence來生成主鍵，要設定序列名，不然hibernate無法找到： ~~~ <param name="sequence">NAME_SEQ</param>（Oracle中很常用） ~~~ 3. hilo 使用一個高/低位算法生成的long、short或int類型的標識符，給定一個表和字段作為高位值的來源，默認的表是`hibernate_unique_key`，默認的字段是`next_hi`。它將id的產生源分成兩部分，DB+內存，然后按照算法結合在一起產生id值，可以在很少的連接次數內產生多條記錄，提高效率 ~~~ MySQL：create table hi_value(next_hi integer not null); insert into hi_value(next_hi) values(1); ~~~ ~~~ <id name="id" column="id"> <generator class="hilo"> <param name="table">hi_value</param> <param name="column">next_hi</param> <param name="max_lo">100</param> </generator> </id> ~~~ 在hibernate持久化的時候，由hibernate負責生成低位值。hilo標識符生成器在生成標識符時需要從`hi_value`表中取出next_hi的當前值，然后修改該值，這個操作是在單獨的事務中完成的。最大的低值在屬性`max_lo`中配置，但在Hibernate內存中生成的低位值超過此值時，就有需要到數據庫的`hi_value`表中再次讀取高位值了使用hilo生成策略，要在數據庫中建立一張額外的表，默認表名為`hibernate_unique_key`,默認字段為integer類型，名稱是next_hi（比較少用）我們也可以自己設置自定義的表名和字段名 ~~~ <id name="id" type="integer"> <column name="id"/> <generator class="hilo"> <param name="my_unique_key"/> <param column="next_hi"/> </generator> </id> ~~~ 4. native 會根據底層數據庫的能力，從identity、sequence、hilo中選擇一個，靈活性更強，但此時，如果選擇sequence或者hilo，則所有的表的主鍵都會從Hibernate默認的sequence或者hilo表中取。并且，有的數據庫對于默認情況主鍵生成測試的支持，效率并不是很高對于 oracle 采用 Sequence 方式，對于MySQL 和 SQL Server 采用identity（自增主鍵生成機制），native就是將主鍵的生成工作交由數據庫完成，hibernate不管（很常用） ~~~ <id name="id" column="id"> <generator class="native" /> </id> ~~~ 5. seqhilo sequence和hilo的結合，hilo的高位由sequence產生，所以也需要底層數據庫的支持通過hilo算法實現，但是主鍵歷史保存在Sequence中，適用于支持 Sequence 的數據庫，如 Oracle（比較少用） ~~~ <id name="id" column="id"> <generator class="seqhilo"> <param name="sequence">seq_name</param> <param name="max_lo">100</param> </generator> </id> ~~~ 6. increment 這個是由Hibernate在內存中生成主鍵，每次增量為1，不依賴于底層的數據庫，因此所有的數據庫都可以使用，但問題也隨之而來，由于是Hibernate生成的，所以只能有一個Hibernate應用進程訪問數據庫，否則就會產生主鍵沖突，不能在集群情況下使用插入數據的時候hibernate會給主鍵添加一個自增的主鍵，但是一個hibernate實例就維護一個計數器，所以在多個實例運行的時候不能使用這個方法 ~~~ <id name="id" column="id"> <generator class="increment" /> </id> ~~~ 7. uuid.hex 使用一個128-bit的UUID算法生成字符串類型的標識符，UUID被編碼成一個32位16進制數字的字符串。UUID包含：IP地址、JVM啟動時間、系統時間（精確到1/4秒）和一個計數器值（JVM中唯一） hibernate會算出一個128位的唯一值插入 ~~~ <id name="id" column="id"> <generator class="uuid.hex" /> </id> ~~~ uuid.string hibernate會算出一個16位的值插入 8. assigned 由應用程序負責生成主鍵標識符，往往使用在數據庫中沒有代理主鍵，使用的主鍵與業務相關的情況，如： ~~~ <id name="id" column="id" type="string"> <generator class="assigned" /> </id> ~~~ 這種主鍵的生成方式不建議使用，在數據庫表設計時就應該使用代理主鍵（surrogate key），不應使用自然主鍵（natural key具有業務含義），在沒有指定`<generator>`標簽時，默認就是assigned主鍵的生成方式在插入數據的時候主鍵由用戶自己添加，hibernate也不管 9. foreign 使用外部表的字段作為主鍵 10. select 使用觸發器生成主鍵（主要用于早期的數據庫主鍵生成機制，少用） ps: 代理主鍵是指與業務無關且能唯一標識數據庫中記錄,一般是數據庫自動生成的,比如mysql可以使用`auto_increment`,Sql2000可以使用identity生成方式,oracle可以使用sequence生成方式自然主鍵指業務相關,由用戶指定,且能唯一標識數據庫中的任意一條記錄 **簡介版：** * increment：代理主鍵，適合于所有數據庫，由hibernate維護主鍵自增，和底層數據庫無關，但是不適合于2個或以上hibernate進程。 * identity：代理主鍵，適合于Mysql或ms sql server等支持自增的dbms，主鍵值不由hibernate維護。 * sequence：代理主鍵，適合于oracle等支持序列的dbms，主鍵值不由hibernate維護，由序列產生。 * native：代理主鍵，根據底層數據庫的具體特性選擇適合的主鍵生成策略，如果是mysql或sqlserver，選擇identity，如果是oracle，選擇sequence。 * hilo：代理主鍵，hibernate把特定表的字段作為hign值，生成主鍵值 * uuid.hex：代理主鍵，hibernate采用uuid 128位算法生成基于字符串的主鍵值 * assign：適合于應用程序維護的自然主鍵。