[轉]實體類註解

@Entity
//繼承策略。另外一個類繼承本類，那麼本類裏的屬性應用到另外一個類中
@Inheritance(strategy = InheritanceType.JOINED ) 
@Table(name="INFOM_TESTRESULT")
public class TestResult extends IdEntity{}

1

@Entity(name="EntityName")

必須

name爲可選,對應數據庫中一的個表

2

@Table(name="",catalog="",schema="")

可選,一般和@Entity配合使用,只能標註在實體的class定義處,表示實體對應的數據庫表的信息
name:可選,表示表的名稱.默認地,表名和實體名稱一致,只有在不一致的狀況下才須要指定表名
catalog:可選,表示Catalog名稱,默認爲Catalog("").
schema:可選,表示Schema名稱,默認爲Schema("").

3

@id

必須
@id定義了映射到數據庫表的主鍵的屬性,一個實體只能有一個屬性被映射爲主鍵.置於getXxxx()前.

4

@GeneratedValue(strategy=GenerationType,generator="")

可選
strategy:表示主鍵生成策略,有AUTO,INDENTITY,SEQUENCE 和 TABLE 4種,分別表示讓ORM框架自動選擇,
根據數據庫的Identity字段生成,根據數據庫表的Sequence字段生成,以有根據一個額外的表生成主鍵,默認爲AUTO
generator:表示主鍵生成器的名稱,這個屬性一般和ORM框架相關,例如,Hibernate能夠指定uuid等主鍵生成方式.
示例:

@Id
@GeneratedValues(strategy=StrategyType.SEQUENCE)
public int getPk() {
   return pk;
}

5

@Basic(fetch=FetchType,optional=true)

可選
@Basic表示一個簡單的屬性到數據庫表的字段的映射,對於沒有任何標註的getXxxx()方法,默認即爲@Basic
fetch: 表示該屬性的讀取策略,有EAGER和LAZY兩種,分別表示主支抓取和延遲加載,默認爲EAGER.
optional:表示該屬性是否容許爲null,默認爲true
示例:

@Basic(optional=false)
public String getAddress() {
  return address;
}

6

@Column

可選
@Column描述了數據庫表中該字段的詳細定義,這對於根據JPA註解生成數據庫表結構的工具很是有做用.
name:表示數據庫表中該字段的名稱,默認情形屬性名稱一致
nullable:表示該字段是否容許爲null,默認爲true
unique:表示該字段是不是惟一標識,默認爲false
length:表示該字段的大小,僅對String類型的字段有效
insertable:表示在ORM框架執行插入操做時,該字段是否應出現INSETRT語句中,默認爲true
updateable:表示在ORM框架執行更新操做時,該字段是否應該出如今UPDATE語句中,默認爲true.對於一經建立就不能夠更改的字段,該屬性很是有用,如對於birthday字段.
columnDefinition:表示該字段在數據庫中的實際類型.一般ORM框架能夠根據屬性類型自動判斷數據庫中字段的類型,可是對於Date類型仍沒法肯定數據庫中字段類型到底是DATE,TIME仍是
TIMESTAMP.此外,String的默認映射類型爲VARCHAR,若是要將String類型映射到特定數據庫的BLOB或TEXT字段類型,該屬性很是有用.
示例:

@Column(name="BIRTH",nullable="false",columnDefinition="DATE")
public String getBithday() {
  return birthday;
}

7

@Transient

可選
@Transient表示該屬性並不是一個到數據庫表的字段的映射,ORM框架將忽略該屬性.
若是一個屬性並不是數據庫表的字段映射,就務必將其標示爲@Transient,不然,ORM框架默認其註解爲@Basic
示例:

//根據birth計算出age屬性
@Transient
public int getAge() {
  return getYear(new Date()) - getYear(birth);
}

8

@ManyToOne(fetch=FetchType,cascade=CascadeType)

可選
@ManyToOne表示一個多對一的映射,該註解標註的屬性一般是數據庫表的外鍵
optional:是否容許該字段爲null,該屬性應該根據數據庫表的外鍵約束來肯定,默認爲true
fetch:表示抓取策略,默認爲FetchType.EAGER
cascade:表示默認的級聯操做策略,能夠指定爲ALL,PERSIST,MERGE,REFRESH和REMOVE中的若干組合,默認爲無級聯操做 （見最後cascade屬性取值）
targetEntity:表示該屬性關聯的實體類型.該屬性一般沒必要指定,ORM框架根據屬性類型自動判斷targetEntity.
示例:

//訂單Order和用戶User是一個ManyToOne的關係
//在Order類中定義
@ManyToOne()
@JoinColumn(name="USER")
public User getUser() {
  return user;
}

9

@JoinColumn

可選
@JoinColumn和@Column相似,介量描述的不是一個簡單字段,而一一個關聯字段,例如.描述一個@ManyToOne的字段.
name:該字段的名稱.因爲@JoinColumn描述的是一個關聯字段,如ManyToOne,則默認的名稱由其關聯的實體決定.
例如,實體Order有一個user屬性來關聯實體User,則Order的user屬性爲一個外鍵,
其默認的名稱爲實體User的名稱+下劃線+實體User的主鍵名稱
示例:
     見@ManyToOne

10

@OneToMany(fetch=FetchType,cascade=CascadeType)

可選
@OneToMany描述一個一對多的關聯,該屬性應該爲集體類型,在數據庫中並無實際字段.
fetch:表示抓取策略,默認爲FetchType.LAZY,由於關聯的多個對象一般沒必要從數據庫預先讀取到內存
cascade:表示級聯操做策略,對於OneToMany類型的關聯很是重要,一般該實體更新或刪除時,其關聯的實體也應當被更新或刪除
例如:實體User和Order是OneToMany的關係,則實體User被刪除時,其關聯的實體Order也應該被所有刪除
示例:

@OneTyMany(cascade=ALL)
public List getOrders() {
  return orders;
}

11

@OneToOne(fetch=FetchType,cascade=CascadeType)

可選
@OneToOne描述一個一對一的關聯
fetch:表示抓取策略,默認爲FetchType.LAZY
cascade:表示級聯操做策略
示例:

@OneToOne(fetch=FetchType.LAZY)
public Blog getBlog() {
  return blog;
}

12

@ManyToMany

可選
@ManyToMany 描述一個多對多的關聯.多對多關聯上是兩個一對多關聯,可是在ManyToMany描述中,中間表是由ORM框架自動處理
targetEntity:表示多對多關聯的另外一個實體類的全名,例如:package.Book.class
mappedBy:表示多對多關聯的另外一個實體類的對應集合屬性名稱
示例:

//User實體表示用戶,Book實體表示書籍,爲了描述用戶收藏的書籍,能夠在User和Book之間創建ManyToMany關聯
     @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;
       }
     }

兩個實體間相互關聯的屬性必須標記爲@ManyToMany,並相互指定targetEntity屬性,
須要注意的是,有且只有一個實體的@ManyToMany註解須要指定mappedBy屬性,指向targetEntity的集合屬性名稱
利用ORM工具自動生成的表除了User和Book表外,還自動生成了一個User_Book表,用於實現多對多關聯

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	經過正則表達式來驗證字符串	@Pattern(regex=」[a-z]{6}」)
@Length	String	驗證字符串的長度	@length(min=3,max=20)
@Email	String	驗證一個Email地址是否有效	@email
@Range	Long	驗證一個整型是否在有效的範圍內	@Range(min=0,max=100)
@Min	Long	驗證一個整型必須不小於指定值	@Min(value=10)
@Max	Long	驗證一個整型必須不大於指定值	@Max(value=20)
@Size	集合或數組	集合或數組的大小是否在指定範圍內	@Size(min=1,max=255)

以上來源網址Hibernate 實體類註解

附：cascade屬性取值

一、none：忽略其餘關聯的對象，默認值。

二、save-update：當session經過save(),update(),saveOrUpdate()方法來保存或更新對象時，級聯保存全部關聯的新建的臨時對象，而且級聯更新全部關聯的遊離對象。

三、persist：當session經過persist()方法來保存當前對象時，會級聯保存全部關聯的新建的臨時對象。

四、merge：經過Session的merge()方法來保存當前對象時，會級聯融合全部關聯的遊離對象。

五、delete：經過delete()刪除當前對象時，會級聯刪除全部關聯的對象。

六、lock：經過lock()把當前遊離對象加入session緩存時，會把全部的遊離對象也加入Session緩存中。

七、replicate:經過replicate()複製當前對象時，會級聯複製全部關聯的對象。

八、evict:經過evict()清除session緩存中對象時，會級聯清除全部關聯的對象。

九、refresh:經過refresh()刷新當前對象時，會級聯刷新全部關聯的對象。(刷新是指同步更新session緩存中數據)

十、all:save-update(),persist(),merge(),delete(),lock(),replicate(),evict()及refresh()的行爲。

十一、delete-orphan,刪除全部和當前對象時，解除關聯行爲的對象。

十二、all-delete-orphan; 經過delete()刪除當前對象時，會級聯刪除全部關聯的對象。

spring+hibernate實體類註解詳解(非原創) + cascade屬性取值