天天看點

了解JPA注解@GeneratedValue

一、JPA通用政策生成器

通過annotation來映射hibernate實體的,基于annotation的hibernate主鍵辨別為@Id,

其生成規則由@GeneratedValue設定的.這裡的@id和@GeneratedValue都是JPA的标準用法,

JPA提供四種标準用法,由@GeneratedValue的源代碼可以明顯看出.

Target({METHOD,FIELD})    
    @Retention(RUNTIME)    
    public @interface GeneratedValue{    
        GenerationType strategy() default AUTO;    
        String generator() default "";    
    }   

           

其中GenerationType:

public enum GenerationType{    
    TABLE,    
    SEQUENCE,    
    IDENTITY,    
    AUTO   
}  
           

JPA提供的四種标準用法為TABLE,SEQUENCE,IDENTITY,AUTO.

  • TABLE:使用一個特定的資料庫表格來儲存主鍵。
  • SEQUENCE:根據底層資料庫的序列來生成主鍵,條件是資料庫支援序列。
  • IDENTITY:主鍵由資料庫自動生成(主要是自動增長型)
  • AUTO:主鍵由程式控制。

    TABLE比較複雜,這裡不講解。分别介紹其他三個:

1.SEQUENCE

實體類中的注解

@Id  
@GeneratedValue(strategy =GenerationType.SEQUENCE,generator="aaa")  
@SequenceGenerator(name="aaa", sequenceName="seq_payment")  
           

@SequenceGenerator定義

@Target({TYPE, METHOD, FIELD})   
@Retention(RUNTIME)  
public @interface SequenceGenerator {  
 String name();  
 String sequenceName() default "";  
 int initialValue() default 0;  
 int allocationSize() default 50;  
}  
           
  • name屬性表示該表主鍵生成政策的名稱,它被引用在@GeneratedValue中設定的“generator”值中。
  • sequenceName屬性表示生成政策用到的資料庫序列名稱。
  • initialValue表示主鍵初識值,預設為0。
  • allocationSize表示每次主鍵值增加的大小,例如設定成1,則表示每次建立新記錄後自動加1,預設為50。

2.IDENTITY

主鍵則由資料庫自動維護,使用起來很簡單

@Id  
@GeneratedValue(strategy = GenerationType.IDENTITY)  
           

3、AUTO

預設的配置。如果不指定主鍵生成政策,預設為AUTO。

@Id  
@GeneratedValue(strategy = GenerationType.AUTO)  
           

二、hibernate主鍵政策生成器

hibernate提供多種主鍵生成政策,有點是類似于JPA,有的是hibernate特有,下面列出幾個Hibernate比較常用的生成政策:

  • native: 對于 oracle 采用 Sequence 方式,對于MySQL 和 SQL Server 采用identity(自增主鍵生成機制),native就是将主鍵的生成工作交由資料庫完成,hibernate不管
  • uuid: 采用128位的uuid算法生成主鍵,uuid被編碼為一個32位16進制數字的字元串。占用空間大(字元串類型)。
  • assigned: 在插入資料的時候主鍵由程式處理(即程式員手動指定),這是

    <generator>

    元素沒有指定時的預設生成政策。等同于JPA中的AUTO。
  • identity: 使用SQL Server 和 MySQL 的自增字段,這個方法不能放到 Oracle 中,Oracle 不支援自增字段,要設定sequence(MySQL 和 SQL Server 中很常用)。 等同于JPA中的INDENTITY。
  • increment: 插入資料的時候hibernate會給主鍵添加一個自增的主鍵,但是一個hibernate執行個體就維護一個計數器,是以在多個執行個體運作的時候不能使用這個方法。

hibernate提供了多種生成器供選擇,基于Annotation的方式通過@GenericGenerator實作.

hibernate每種主鍵生成政策提供接口org.hibernate.id.IdentifierGenerator的實作類,如果要實作自定義的主鍵生成政策也必須實作此接口.

public interface IdentifierGenerator {  
    /** 
     * The configuration parameter holding the entity name 
     */  
    public static final String ENTITY_NAME = "entity_name";  

  /** 
   * Generate a new identifier. 
   * @param session 
   * @param object the entity or toplevel collection for which the id is being generated 
   * 
   * @return a new identifier 
   * @throws HibernateException 
   */  
  public Serializable generate(SessionImplementor session, Object object)   
    throws HibernateException;  
}  
           

IdentifierGenerator提供一generate方法,generate方法傳回産生的主鍵.

三、@GenericGenerator

自定義主鍵生成政策,由@GenericGenerator實作。

hibernate在JPA的基礎上進行了擴充,可以用一下方式引入hibernate獨有的主鍵生成政策,就是通過@GenericGenerator加入的。

比如說,JPA标準用法

@Id  
@GeneratedValue(GenerationType.AUTO)  
           

就可以用hibernate特有以下用法來代替:

@Id
@GeneratedValue(generator = "paymentableGenerator")    
@GenericGenerator(name = "paymentableGenerator", strategy = "assigned")  
           

@GenericGenerator的定義:

@Target({PACKAGE, TYPE, METHOD, FIELD})  
@Retention(RUNTIME)  
           

源代碼如下:

public @interface GenericGenerator {  
 /** 
  * unique generator name 
  */  
 String name();  
 /** 
  * Generator strategy either a predefined Hibernate 
  * strategy or a fully qualified class name. 
  */  
 String strategy();  
 /** 
  * Optional generator parameters 
  */  
 Parameter[] parameters() default {};  
}  
           
  • name屬性指定生成器名稱。
  • strategy屬性指定具體生成器的類名。
  • parameters得到strategy指定的具體生成器所用到的參數。

對于這些hibernate主鍵生成政策和各自的具體生成器之間的關系,在org.hibernate.id.IdentifierGeneratorFactory中指定了,

static {  
  GENERATORS.put("uuid", UUIDHexGenerator.class);  
  GENERATORS.put("hilo", TableHiLoGenerator.class);  
  GENERATORS.put("assigned", Assigned.class);  
  GENERATORS.put("identity", IdentityGenerator.class);  
  GENERATORS.put("select", SelectGenerator.class);  
  GENERATORS.put("sequence", SequenceGenerator.class);  
  GENERATORS.put("seqhilo", SequenceHiLoGenerator.class);  
  GENERATORS.put("increment", IncrementGenerator.class);  
  GENERATORS.put("foreign", ForeignGenerator.class);  
  GENERATORS.put("guid", GUIDGenerator.class);  
  GENERATORS.put("uuid.hex", UUIDHexGenerator.class); //uuid.hex is deprecated  
  GENERATORS.put("sequence-identity", SequenceIdentityGenerator.class);  
}  
           

上面十二種政策,加上native,hibernate一共預設支援十三種生成政策。使用hibernate注解示例如下:

@Id
@GeneratedValue(generator = "IDGenerator")
@GenericGenerator(name = "IDGenerator", strategy = "identity")
           

這種完全類似于:

@Id
@GeneratedValue(strategy=GenerationType.IDENTITY)