Key Generator主鍵產生器
<generator>元素用來設定標識產生器。Hibernate提供了標識符產生器介面: org.hibernate.id.IdentifierGenerator介面;並且提供了多種內建的實現。例如: org.hibernate.id.IdentityGenerator; org.hibernate.id.IncrementGenerator;它們的縮寫名分別為:identity和increment。在設定<generator>子項目的class屬性時,既可以提供完整的標識符產生器的類名,也可以給定縮寫名
標識符產生器 |
說 明 |
increment |
適用於代理主鍵。由Hibernate自動以遞增的方式產生標識符,每次增加1。 優點:由於它的機制不依賴於底層資料庫系統,因此它適合於所有的資料庫系統。 缺點:只適合有單個Hibernate應用進程訪問同一個資料庫,在叢集環境下不推薦使用它。 另外,OID必須為long,int,short類型,如果為byte類型,則會有異常。 |
identity |
適用於代理主鍵。由底層資料庫產生標識符。前提條件是底層資料庫支援自動成長欄位類型。(Oracle資料庫不能用它) |
sequence |
適用於代理主鍵。Hibernate根據底層資料庫的序列來產生標識符。前提條件是底層資料庫支援序列。(oracle資料庫能用它) |
hilo |
適用於代理主鍵。Hibernate根據high/low演算法來產生標識符。Hibernate把特定表的欄位作為"high"值.在預設情況下選用hibernate_unique_key表的next_hi欄位。它的機制不依賴於底層資料庫系統,因此它適合於所有的資料庫系統。high/low演算法產生的標識符只能在一個資料庫中保證唯一。 |
native |
適用於代理主鍵。根據底層資料庫對自動產生標識符的支援能力,來選擇identity, sequence, hilo。很適合於跨平台開發,即同一個Hibernate應用需要串連多種資料庫系統。 |
uuid.hex |
適用於代理主鍵。Hibernate採用128位的UUID演算法來產生標識符。UUID演算法能夠在網路環境中產生唯一的字串標識符。這種標識符建置原則並不流行,因為字串類型的主鍵比整數類型的主鍵佔用更多的資料庫空間。 |
assigned |
適用於自然主鍵。由Java應用程式負責產生標識符,為了能讓Java應用程式設定OID,不能把setID()方法聲明為private類型,應該盡量避免使用自然主鍵。 |
可選項說明:
1) assigned
主鍵由外部程式負責產生,無需Hibernate參與。
hilo
通過hi/lo 演算法實現的主鍵產生機制,需要額外的資料庫表儲存主鍵產生曆史狀態。
seqhilo
與hilo 類似,通過hi/lo 演算法實現的主鍵產生機制,只是主鍵曆史狀態儲存在Sequence中,適用於支援Sequence的資料庫,如Oracle。
increment
主鍵按數值順序遞增。此方式的實現機製為在當前應用執行個體中維持一個變數,以儲存著當前的最大值,之後每次需要產生主鍵的時候將此值加1作為主鍵。這種方式可能產生的問題是:如果當前有多個執行個體訪問同一個資料庫,那麼由於各個執行個體各自維護主鍵狀態,不同執行個體可能產生同樣的主鍵,從而造成主鍵重複異常。因此,如果同一資料庫有多個執行個體訪問,此方式必須避免使用。
identity
採用資料庫提供的主鍵產生機制。如DB2、SQL Server、MySQL中的主鍵產生機制。
sequence
採用資料庫提供的sequence 機制產生主鍵。如Oralce 中的Sequence。
native
由Hibernate根據底層資料庫自行判斷採用identity、hilo、sequence其中一種作為主鍵產生方式。
8)
uuid.hex
由Hibernate基於128 位唯一值產生演算法產生16 進位數值(編碼後以長度32 的字串表示)作為主鍵。
uuid.string
與uuid.hex 類似,只是產生的主鍵未進行編碼(長度16)。在某些資料庫中可能出現問題(如PostgreSQL)。
foreign
使用外部表格的欄位作為主鍵。
一般而言,利用uuid.hex方式產生主鍵將提供最好的效能和資料庫平台適應性。
另外由於常用的資料庫,如Oracle、DB2、SQLServer、MySql 等,都提供了易用的主鍵產生機制(Auto-Increase 欄位或者Sequence)。我們可以在資料庫提供的主鍵產生機制上,採用generator-class=native的主鍵產生方式。
不過值得注意的是,一些資料庫提供的主鍵產生機制在效率上未必最佳,大量並發insert資料時可能會引起表之間的互鎖。資料庫提供的主鍵產生機制,往往是通過在一個內部表中儲存當前主鍵狀態(如對於自增型主鍵而言,此內部表中就維護著當前的最大值和遞增量),之後每次插入資料會讀取這個最大值,然後加上遞增量作為新記錄的主鍵,之後再把這個新的最大值更新回內部表中,這樣,一次Insert操作可能導致資料庫內部多次表讀寫操作,同時伴隨的還有資料的加鎖解鎖操作,這對效能產生了較大影響。因此,對於並發Insert要求較高的系統,推薦採用uuid.hex 作為主鍵產生機制。
increment:產生long, short或者int類型的主鍵,不能在cluster環境下使用。適用於所有資料庫
identity:產生long, short或者int類型的主鍵。適用於DB2, MySQL, MS SQL Server, Sybase and HypersonicSQL
sequence :產生long, short或者int類型的主鍵。適用於DB2, PostgreSQL, Oracle, SAP DB, McKoi,Interbase.
hilo:產生long, short或者int類型的主鍵。需要提供一個資料庫的表來存放產生的主鍵資訊。當採用應用伺服器的JTA提供的資料庫連接或者使用者自訂的資料庫連接的時候,不要使用這種主鍵產生方式。適用於所有資料庫
seqhilo:採用給定的資料庫的sequence來產生long, short或者int類型的主鍵。適用於DB2, PostgreSQL, Oracle, SAP DB, McKoi,Interbase.
uuid.hex:採用128位的演算法來產生一個32位字串。最通用的一種方式。適用於所有資料庫
uuid.string:同樣採用128位的UUID演算法。將產生的字元編碼位16位。適用於除PostgreSQL.以外的資料庫
native:根據具體串連的資料庫從identity, sequence或者hilo選擇一種來產生主鍵。適用的資料庫根據選擇的產生方式確定。
assigned: 交給應用自己給主鍵賦值。要注意的是賦值必須在調用save()方法之前完成。適用的資料庫根據選擇的產生方式確定。