JPA注解

1.Entity

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

name指定實(shí)體Bean的名稱(chēng),默認(rèn)值為 bean class 的非限定類(lèi)名,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:指定表的名稱(chēng)

catalog:指定數(shù)據(jù)庫(kù)名稱(chēng)

schema:指定數(shù)據(jù)庫(kù)的用戶(hù)名

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

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

3.Id

@javax.persistence.Id()

映射到數(shù)據(jù)庫(kù)表的主鍵的屬性,一個(gè)實(shí)體只能有一個(gè)屬性被映射為主鍵.

4.GeneratedValue

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

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

分別表示讓ORM框架自動(dòng)選擇,根據(jù)數(shù)據(jù)庫(kù)的Identity字段生成,根據(jù)數(shù)據(jù)庫(kù)表的Sequence字段生成,以有根據(jù)一個(gè)額外的表生成主鍵,默認(rèn)為AUTO

generator:表示主鍵生成器的名稱(chēng),這個(gè)屬性通常和ORM框架相關(guān),例如,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:抓取策略,延時(shí)加載與立即加載

optional:指定在生成數(shù)據(jù)庫(kù)結(jié)構(gòu)時(shí)字段是否允許為 null

6.Column

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

@Column注解指定字段的詳細(xì)定義

name:字段的名稱(chēng),默認(rèn)與屬性名稱(chēng)一致

nullable:是否允許為null,默認(rèn)為true

unique:是否唯一,默認(rèn)為false

length:字段的長(zhǎng)度,僅對(duì)String類(lèi)型的字段有效

columnDefinition:表示該字段在數(shù)據(jù)庫(kù)中的實(shí)際類(lèi)型

通常ORM框架可以根據(jù)屬性類(lèi)型自動(dòng)判斷數(shù)據(jù)庫(kù)中字段的類(lèi)型,

但是對(duì)于Date類(lèi)型仍無(wú)法確定數(shù)據(jù)庫(kù)中字段類(lèi)型究竟是DATE,TIME還是TIMESTAMP,

此外,String的默認(rèn)映射類(lèi)型為VARCHAR,如果要將String類(lèi)型映射到特定數(shù)據(jù)庫(kù)的BLOB或TEXT字段類(lèi)型,該屬性非常有用

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

insertable:默認(rèn)情況下,JPA持續(xù)性提供程序假設(shè)所有列始終包含在 SQL INSERT 語(yǔ)句中。

如果該列不應(yīng)包含在這些語(yǔ)句中，請(qǐng)將 insertable 設(shè)置為 false

updatable：列始終包含在 SQL UPDATE 語(yǔ)句中。如果該列不應(yīng)包含在這些語(yǔ)句中，請(qǐng)將 updatable 設(shè)置為 false

table:實(shí)體的所有持久字段都存儲(chǔ)到一個(gè)其名稱(chēng)為實(shí)體名稱(chēng)的數(shù)據(jù)庫(kù)表中,如果該列與 @SecondaryTable表關(guān)聯(lián)

需將 name 設(shè)置為相應(yīng)輔助表名稱(chēng)的String名稱(chēng)

7.Temporal

@javax.persistence.Temporal(TemporalType.DATE)

value:TemporalType.DATE,TemporalType.TIME,TemporalType.TIMESTAMP時(shí)間類(lèi)型格式

8.Enumerated

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

枚舉類(lèi)型成員屬性映射,EnumType.STRING指定屬性映射為字符串,EnumType.ORDINAL指定屬性映射為數(shù)據(jù)序

9.Lob

@javax.persistence.Lob

用于標(biāo)注字段類(lèi)型為Clob和Blob類(lèi)型

Clob(Character Large Ojects)類(lèi)型是長(zhǎng)字符串類(lèi)型,實(shí)體的類(lèi)型可為char[]、Character[]、或者String類(lèi)型

Blob(Binary Large Objects)類(lèi)型是字節(jié)類(lèi)型,實(shí)體的類(lèi)型可為byte[]、Byte[]、或者實(shí)現(xiàn)了Serializable接口的類(lèi)。

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

10.Transient

@javax.persistence.Transient

@Transient表示該屬性并非一個(gè)到數(shù)據(jù)庫(kù)表的字段的映射,ORM框架將忽略該屬性

11.SecondaryTable

@javax.persistence.SecondaryTable

將一個(gè)實(shí)體映射到多個(gè)數(shù)據(jù)庫(kù)表中

如：

@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屬性的值指定字段存儲(chǔ)的表名稱(chēng)

沒(méi)有用 @Column 注解改變屬性默認(rèn)的字段將會(huì)存在于 Forum 表

12.@Embeddable

@javax.persistence.Embeddable

嵌套映射,在被嵌套的類(lèi)中使用Embeddable注解,說(shuō)明這個(gè)就是一個(gè)可被嵌套的類(lèi),使用 @Embedded

當(dāng)同一個(gè)類(lèi)被不同的注解方式的類(lèi)嵌套時(shí)，可能會(huì)出現(xiàn)一些錯(cuò)誤，使用 @Access(AccessType. FIELD)設(shè)定被嵌套類(lèi)的注解方式