1、@Entity(name="EntityName")
必須,name為可選,對應(yīng)數(shù)據(jù)庫中一的個表
2、@Table(name="",catalog="",schema="")
可選,通常和@Entity配合使用,只能標注在實體的class定義處,表示實體對應(yīng)的數(shù)據(jù)庫表的信息
name:可選,表示表的名稱.默認地,表名和實體名稱一致,只有在不一致的情況下才需要指定表名
catalog:可選,表示Catalog名稱,默認為Catalog("").
schema:可選,表示Schema名稱,默認為Schema("").
3、@id
必須
@id定義了映射到數(shù)據(jù)庫表的主鍵的屬性,一個實體只能有一個屬性被映射為主鍵.置于getXxxx()前.
4、@GeneratedValue(strategy=GenerationType,generator="")
可選
strategy:表示主鍵生成策略,有AUTO,INDENTITY,SEQUENCE 和 TABLE 4種,分別表示讓ORM框架自動選擇,
根據(jù)數(shù)據(jù)庫的Identity字段生成,根據(jù)數(shù)據(jù)庫表的Sequence字段生成,以有根據(jù)一個額外的表生成主鍵,默認為AUTO
generator:表示主鍵生成器的名稱,這個屬性通常和ORM框架相關(guān),例如,Hibernate可以指定uuid等主鍵生成方式.
示例:
@Id
@GeneratedValues(strategy=StrategyType.SEQUENCE)
public int getPk() {
return pk;
}
5、@Basic(fetch=FetchType,optional=true)
可選
@Basic表示一個簡單的屬性到數(shù)據(jù)庫表的字段的映射,對于沒有任何標注的getXxxx()方法,默認即為@Basic
fetch: 表示該屬性的讀取策略,有EAGER和LAZY兩種,分別表示主支抓取和延遲加載,默認為EAGER.
optional:表示該屬性是否允許為null,默認為true
示例:
@Basic(optional=false)
public String getAddress() {
return address;
}
6、@Column
可選
@Column描述了數(shù)據(jù)庫表中該字段的詳細定義,這對于根據(jù)JPA注解生成數(shù)據(jù)庫表結(jié)構(gòu)的工具非常有作用.
name:表示數(shù)據(jù)庫表中該字段的名稱,默認情形屬性名稱一致
nullable:表示該字段是否允許為null,默認為true
unique:表示該字段是否是唯一標識,默認為false
length:表示該字段的大小,僅對String類型的字段有效
insertable:表示在ORM框架執(zhí)行插入操作時,該字段是否應(yīng)出現(xiàn)INSETRT語句中,默認為true
updateable:表示在ORM框架執(zhí)行更新操作時,該字段是否應(yīng)該出現(xiàn)在UPDATE語句中,默認為true.對于一經(jīng)創(chuàng)建就不可以更改的字段,該屬性非常有用,如對于birthday字段.
columnDefinition:表示該字段在數(shù)據(jù)庫中的實際類型.通常ORM框架可以根據(jù)屬性類型自動判斷數(shù)據(jù)庫中字段的類型,但是對于Date類型仍無法確定數(shù)據(jù)庫中字段類型究竟是DATE,TIME還是TIMESTAMP.此外,String的默認映射類型為VARCHAR,如果要將String類型映射到特定數(shù)據(jù)庫的BLOB或TEXT字段類型,該屬性非常有用.
示例:
@Column(name="BIRTH",nullable="false",columnDefinition="DATE")
public String getBithday() {
return birthday;
}
7、@Transient
可選
@Transient表示該屬性并非一個到數(shù)據(jù)庫表的字段的映射,ORM框架將忽略該屬性.
如果一個屬性并非數(shù)據(jù)庫表的字段映射,就務(wù)必將其標示為@Transient,否則,ORM框架默認其注解為@Basic
示例:
//根據(jù)birth計算出age屬性
@Transient
public int getAge() {
return getYear(new Date()) - getYear(birth);
}
8、@ManyToOne(fetch=FetchType,cascade=CascadeType)
可選
@ManyToOne表示一個多對一的映射,該注解標注的屬性通常是數(shù)據(jù)庫表的外鍵
optional:是否允許該字段為null,該屬性應(yīng)該根據(jù)數(shù)據(jù)庫表的外鍵約束來確定,默認為true
fetch:表示抓取策略,默認為FetchType.EAGER
cascade:表示默認的級聯(lián)操作策略,可以指定為ALL,PERSIST,MERGE,REFRESH和REMOVE中的若干組合,默認為無級聯(lián)操作
targetEntity:表示該屬性關(guān)聯(lián)的實體類型.該屬性通常不必指定,ORM框架根據(jù)屬性類型自動判斷targetEntity.
示例:
//訂單Order和用戶User是一個ManyToOne的關(guān)系
//在Order類中定義
@ManyToOne()
@JoinColumn(name="USER")
public User getUser() {
return user;
}
9、@JoinColumn
可選
@JoinColumn和@Column類似,介量描述的不是一個簡單字段,而一一個關(guān)聯(lián)字段,例如.描述一個@ManyToOne的字段.
name:該字段的名稱.由于@JoinColumn描述的是一個關(guān)聯(lián)字段,如ManyToOne,則默認的名稱由其關(guān)聯(lián)的實體決定.
例如,實體Order有一個user屬性來關(guān)聯(lián)實體User,則Order的user屬性為一個外鍵,
其默認的名稱為實體User的名稱+下劃線+實體User的主鍵名稱
示例:
見@ManyToOne
10、@OneToMany(fetch=FetchType,cascade=CascadeType)
可選
@OneToMany描述一個一對多的關(guān)聯(lián),該屬性應(yīng)該為集體類型,在數(shù)據(jù)庫中并沒有實際字段.
fetch:表示抓取策略,默認為FetchType.LAZY,因為關(guān)聯(lián)的多個對象通常不必從數(shù)據(jù)庫預(yù)先讀取到內(nèi)存
cascade:表示級聯(lián)操作策略,對于OneToMany類型的關(guān)聯(lián)非常重要,通常該實體更新或刪除時,其關(guān)聯(lián)的實體也應(yīng)當被更新或刪除
例如:實體User和Order是OneToMany的關(guān)系,則實體User被刪除時,其關(guān)聯(lián)的實體Order也應(yīng)該被全部刪除
示例:
@OneTyMany(cascade=ALL)
public List getOrders() {
return orders;
}
11、@OneToOne(fetch=FetchType,cascade=CascadeType)
可選
@OneToOne描述一個一對一的關(guān)聯(lián)
fetch:表示抓取策略,默認為FetchType.LAZY
cascade:表示級聯(lián)操作策略
示例:
@OneToOne(fetch=FetchType.LAZY)
public Blog getBlog() {
return blog;
}
12、@ManyToMany
可選
@ManyToMany 描述一個多對多的關(guān)聯(lián).多對多關(guān)聯(lián)上是兩個一對多關(guān)聯(lián),但是在ManyToMany描述中,中間表是由ORM框架自動處理
targetEntity:表示多對多關(guān)聯(lián)的另一個實體類的全名,例如:package.Book.class
mappedBy:表示多對多關(guān)聯(lián)的另一個實體類的對應(yīng)集合屬性名稱
示例:
User實體表示用戶,Book實體表示書籍,為了描述用戶收藏的書籍,可以在User和Book之間建立ManyToMany關(guān)聯(lián)
@Entity
public class User {
private List books;
@ManyToMany(targetEntity=package.Book.class)
public List getBooks() {
return books;
}
public void setBooks(List books) {
this.books=books;
}
}
@Entity
public class Book {
private List users;
@ManyToMany(targetEntity=package.Users.class, mappedBy="books")
public List getUsers() {
return users;
}
public void setUsers(List users) {
this.users=users;
}
}
兩個實體間相互關(guān)聯(lián)的屬性必須標記為@ManyToMany,并相互指定targetEntity屬性,
需要注意的是,有且只有一個實體的@ManyToMany注解需要指定mappedBy屬性,指向targetEntity的集合屬性名稱
利用ORM工具自動生成的表除了User和Book表外,還自動生成了一個User_Book表,用于實現(xiàn)多對多關(guān)聯(lián)
13、@MappedSuperclass
可選
@MappedSuperclass可以將超類的JPA注解傳遞給子類,使子類能夠繼承超類的JPA注解
示例:
@MappedSuperclass
public class Employee() {
....
}
@Entity
public class Engineer extends Employee {
.....
}
@Entity
public class Manager extends Employee {
.....
}
14、@Embedded
可選
@Embedded將幾個字段組合成一個類,并作為整個Entity的一個屬性.
例如User包括id,name,city,street,zip屬性.
我們希望city,street,zip屬性映射為Address對象.這樣,User對象將具有id,name和address這三個屬性.
Address對象必須定義為@Embededable
示例:
@Embeddable
public class Address {city,street,zip}
@Entity
public class User {
@Embedded
public Address getAddress() {
..........
}
}
Hibernate驗證注解
注解
適用類型
說明
示例
@Pattern
String
通過正則表達式來驗證字符串
@attern(regex=”[a-z]{6}”)
@Length
String
驗證字符串的長度
@length(min=3,max=20)
@Email
String
驗證一個Email地址是否有效
@email
@Range
Long
驗證一個整型是否在有效的范圍內(nèi)
@Range(min=0,max=100)
@Min
Long
驗證一個整型必須不小于指定值
@Min(value=10)
@Max
Long
驗證一個整型必須不大于指定值
@Max(value=20)
@Size
集合或數(shù)組
集合或數(shù)組的大小是否在指定范圍內(nèi)
@Size(min=1,max=255)
以上每個注解都可能性有一個message屬性，用于在驗證失敗后向用戶返回的消息，還可以三個屬性上使用多個注解