JPA注解

1.Entity

@javax.persistence.Entity(name="xxx")

name指定實體Bean的名稱,默認值為 bean class 的非限定類名,select o from xxx o where o.id=?1

2.Table

@javax.persistence.Table(catalog="xx",name="xx",schema="xx",uniqueConstraints={ @UniqueConstraint(columnNames={"xx","xx"})})

name:指定表的名稱

catalog:指定數據庫名稱

schema:指定數據庫的用戶名

uniqueConstraints:指定唯一性字段約束,如為personid 和name 字段指定唯一性約束

uniqueConstraints={ @UniqueConstraint(columnNames={"personid", "name"})}

3.Id

@javax.persistence.Id()

映射到數據庫表的主鍵的屬性,一個實體只能有一個屬性被映射為主鍵.

4.GeneratedValue

@javax.persistence.GeneratedValue(generator="xxx",strategy=GenerationType.AUTO)

strategy:表示主鍵生成策略,有AUTO,INDENTITY,SEQUENCE 和 TABLE 4種

分別表示讓ORM框架自動選擇,根據數據庫的Identity字段生成,根據數據庫表的Sequence字段生成,以有根據一個額外的表生成主鍵,默認為AUTO

generator:表示主鍵生成器的名稱,這個屬性通常和ORM框架相關,例如,Hibernate可以指定uuid等主鍵生成方式.

Hibernate UUID
@Id @GeneratedValue(generator="system-uuid")
@GenericGenerator(name="system-uuid",strategy = "uuid")

5.Basic

@javax.persistence.Basic(fetch=FetchType.LAZY,optional=true)

fetch:抓取策略,延時加載與立即加載

optional:指定在生成數據庫結構時字段是否允許為 null

6.Column

@javax.persistence.Column(length=15,nullable=false,columnDefinition="",insertable=true,scale=10,table="",updatable=true)

@Column注解指定字段的詳細定義

name:字段的名稱,默認與屬性名稱一致

nullable:是否允許為null,默認為true

unique:是否唯一,默認為false

length:字段的長度,僅對String類型的字段有效

columnDefinition:表示該字段在數據庫中的實際類型

通常ORM框架可以根據屬性類型自動判斷數據庫中字段的類型,

但是對于Date類型仍無法確定數據庫中字段類型究竟是DATE,TIME還是TIMESTAMP,

此外,String的默認映射類型為VARCHAR,如果要將String類型映射到特定數據庫的BLOB或TEXT字段類型,該屬性非常有用

如: @Column(name="BIRTH",nullable="false",columnDefinition="DATE")

insertable:默認情況下,JPA持續性提供程序假設所有列始終包含在 SQL INSERT 語句中。

如果該列不應包含在這些語句中，請將 insertable 設置為 false

updatable：列始終包含在 SQL UPDATE 語句中。如果該列不應包含在這些語句中，請將 updatable 設置為 false

table:實體的所有持久字段都存儲到一個其名稱為實體名稱的數據庫表中,如果該列與 @SecondaryTable表關聯

需將 name 設置為相應輔助表名稱的String名稱

7.Temporal

@javax.persistence.Temporal(TemporalType.DATE)

value:TemporalType.DATE,TemporalType.TIME,TemporalType.TIMESTAMP時間類型格式

8.Enumerated

@javax.persistence.Enumerated(EnumType.STRING)
value:EnumType.STRING,EnumType.ORDINAL

枚舉類型成員屬性映射,EnumType.STRING指定屬性映射為字符串,EnumType.ORDINAL指定屬性映射為數據序

9.Lob

@javax.persistence.Lob

用于標注字段類型為Clob和Blob類型

Clob(Character Large Ojects)類型是長字符串類型,實體的類型可為char[]、Character[]、或者String類型

Blob(Binary Large Objects)類型是字節類型,實體的類型可為byte[]、Byte[]、或者實現了Serializable接口的類。

通常使用惰性加載的方式, @Basic(fetch=FetchType.LAZY)

10.Transient

@javax.persistence.Transient

@Transient表示該屬性并非一個到數據庫表的字段的映射,ORM框架將忽略該屬性

11.SecondaryTable

@javax.persistence.SecondaryTable

將一個實體映射到多個數據庫表中

如：

@Entity
@SecondaryTables({ 
@SecondaryTable(name = "Address"), 
    @SecondaryTable(name = "Comments") 
})
public class Forum implements Serializable {
@Column(table = "Address", length = 100) 
private String street; 
@Column(table = "Address", nullable = false) 
private String city; 
@Column(table = "Address") 
private String conutry; 
@Column(table = "Comments") 
private String title; 
@Column(table = "Comments") 
private String Comments; 
@Column(table = "Comments") 
}

table屬性的值指定字段存儲的表名稱

沒有用 @Column 注解改變屬性默認的字段將會存在于 Forum 表

12.@Embeddable

@javax.persistence.Embeddable

嵌套映射,在被嵌套的類中使用Embeddable注解,說明這個就是一個可被嵌套的類,使用 @Embedded

當同一個類被不同的注解方式的類嵌套時，可能會出現一些錯誤，使用 @Access(AccessType. FIELD)設定被嵌套類的注解方式