1、@Entity(name="EntityName")必須,name為可選,對(duì)應(yīng)數(shù)據(jù)庫中一的個(gè)表
2、@Table(name="",catalog="",schema="")可選,通常和@Entity配合使用,只能標(biāo)注在實(shí)體的class定義處,表示實(shí)體對(duì)應(yīng)的數(shù)據(jù)庫表的信息name:可選,表示表的名稱.默認(rèn)地,表名和實(shí)體名稱一致,只有在不一致的情況下才需要指定表名catalog:可選,表示Catalog名稱,默認(rèn)為Catalog("").schema:可選,表示Schema名稱,默認(rèn)為Schema("").
3、@id必須@id定義了映射到數(shù)據(jù)庫表的主鍵的屬性,一個(gè)實(shí)體只能有一個(gè)屬性被映射為主鍵.置于getXxxx()前.
4、@GeneratedValue(strategy=GenerationType,generator="")可選
strategy:表示主鍵生成策略,有AUTO,INDENTITY,SEQUENCE 和 TABLE 4種,分別表示讓ORM框架自動(dòng)選擇,
根據(jù)數(shù)據(jù)庫的Identity字段生成,根據(jù)數(shù)據(jù)庫表的Sequence字段生成,以有根據(jù)一個(gè)額外的表生成主鍵,默認(rèn)為AUTO
generator:表示主鍵生成器的名稱,這個(gè)屬性通常和ORM框架相關(guān),例如,Hibernate可以指定uuid等主鍵生成方式.
示例:
@Id
@GeneratedValues(strategy=StrategyType.SEQUENCE)
public int getPk() {
return pk;
}
5、@Basic(fetch=FetchType,optional=true)
可選
@Basic表示一個(gè)簡單的屬性到數(shù)據(jù)庫表的字段的映射,對(duì)于沒有任何標(biāo)注的getXxxx()方法,默認(rèn)即為@Basic
fetch: 表示該屬性的讀取策略,有EAGER和LAZY兩種,分別表示主支抓取和延遲加載,默認(rèn)為EAGER.
optional:表示該屬性是否允許為null,默認(rèn)為true
示例:
@Basic(optional=false)
public String getAddress() {
return address;
}
6、@Column
可選
@Column描述了數(shù)據(jù)庫表中該字段的詳細(xì)定義,這對(duì)于根據(jù)JPA注解生成數(shù)據(jù)庫表結(jié)構(gòu)的工具非常有作用.
name:表示數(shù)據(jù)庫表中該字段的名稱,默認(rèn)情形屬性名稱一致
nullable:表示該字段是否允許為null,默認(rèn)為true
unique:表示該字段是否是標(biāo)識(shí),默認(rèn)為false
length:表示該字段的大小,僅對(duì)String類型的字段有效
insertable:表示在ORM框架執(zhí)行插入操作時(shí),該字段是否應(yīng)出現(xiàn)INSETRT語句中,默認(rèn)為true
updateable:表示在ORM框架執(zhí)行更新操作時(shí),該字段是否應(yīng)該出現(xiàn)在UPDATE語句中,默認(rèn)為true.對(duì)于一經(jīng)創(chuàng)建不可以更改的字段,該屬性非常有用,如對(duì)于birthday字段.
columnDefinition:表示該字段在數(shù)據(jù)庫中的實(shí)際類型.通常ORM框架可以根據(jù)屬性類型自動(dòng)判斷數(shù)據(jù)庫中字段的類型,但是對(duì)于Date類型仍無法確定數(shù)據(jù)庫中字段類型究竟是DATE,TIME還是TIMESTAMP.此外,String的默認(rèn)映射類型為VARCHAR,如果要將String類型映射到特定數(shù)據(jù)庫的BLOB或TEXT字段類型,該屬性非常有用.
示例:
@Column(name="BIRTH",nullable="false",columnDefinition="DATE")
public String getBithday() {
return birthday;
}
7、@Transient
可選
@Transient表示該屬性并非一個(gè)到數(shù)據(jù)庫表的字段的映射,ORM框架將忽略該屬性.
如果一個(gè)屬性并非數(shù)據(jù)庫表的字段映射,務(wù)必將其標(biāo)示為@Transient,否則,ORM框架默認(rèn)其注解為@Basic
示例:
//根據(jù)birth計(jì)算出age屬性
@Transient
public int getAge() {
return getYear(new Date()) - getYear(birth);
}
8、@ManyToOne(fetch=FetchType,cascade=CascadeType)
可選
@ManyToOne表示一個(gè)多對(duì)一的映射,該注解標(biāo)注的屬性通常是數(shù)據(jù)庫表的外鍵
optional:是否允許該字段為null,該屬性應(yīng)該根據(jù)數(shù)據(jù)庫表的外鍵約束來確定,默認(rèn)為true
fetch:表示抓取策略,默認(rèn)為FetchType.EAGER
cascade:表示默認(rèn)的級(jí)聯(lián)操作策略,可以指定為ALL,PERSIST,MERGE,REFRESH和REMOVE中的若干組合,默認(rèn)為無級(jí)聯(lián)操作
targetEntity:表示該屬性關(guān)聯(lián)的實(shí)體類型.該屬性通常不必指定,ORM框架根據(jù)屬性類型自動(dòng)判斷targetEntity.
示例:
//訂單Order和用戶User是一個(gè)ManyToOne的關(guān)系
//在Order類中定義
@ManyToOne()
@JoinColumn(name="USER")
public User getUser() {
return user;
}
9、@JoinColumn
可選
@JoinColumn和@Column類似,介量描述的不是一個(gè)簡單字段,而一一個(gè)關(guān)聯(lián)字段,例如.描述一個(gè)@ManyToOne的字段.
name:該字段的名稱.由于@JoinColumn描述的是一個(gè)關(guān)聯(lián)字段,如ManyToOne,則默認(rèn)的名稱由其關(guān)聯(lián)的實(shí)體決定.
例如,實(shí)體Order有一個(gè)user屬性來關(guān)聯(lián)實(shí)體User,則Order的user屬性為一個(gè)外鍵,
其默認(rèn)的名稱為實(shí)體User的名稱+下劃線+實(shí)體User的主鍵名稱
示例:
見@ManyToOne