hibernate annotation

經常使用的hibernate annotation標籤以下: （轉http://www.cnblogs.com/tankaixiong/archive/2013/04/25/3041825.html）

@Entity --註釋聲明該類爲持久類。將一個Javabean類聲明爲一 個實體的數據庫表映射類,最好實現序列化.此時,默認狀況下,全部的類屬性都爲映射到數據表的持久性字段.若在類中,添加另外屬性,而非映射來數據庫的, 要用下面的Transient來註解. 

@Table (name="promotion_info") --持久性映射的表(表名="promotion_info).@Table是類一級的註解,定義在@Entity下,爲實體bean映射表,目錄和schema的名字,默認爲實體bean的類名,不帶包名. 

@Id--註釋能夠代表哪一種屬性是該類中的獨特標識符(即至關於數據表的主鍵)。 
@GeneratedValue --定義自動增加的主鍵的生成策略. 

@Transient --將忽略這些字段和屬性,不用持久化到數據庫.適用於,在當前的持久類中,某些屬性不是用於映射到數據表,而是用於其它的業務邏輯須要,這時,須將這些屬性進行transient的註解.不然系統會因映射不到數據表相應字段而出錯. 

@Temporal(TemporalType.TIMESTAMP)--聲明時間格式 
@Enumerated --聲明枚舉 
@Version --聲明添加對樂觀鎖定的支持 
@OneToOne --能夠創建實體bean之間的一對一的關聯 
@OneToMany --能夠創建實體bean之間的一對多的關聯 
@ManyToOne --能夠創建實體bean之間的多對一的關聯 
@ManyToMany --能夠創建實體bean之間的多對多的關聯 
@Formula --一個SQL表達式這種屬性是隻讀的,不在數據庫生成屬性(可使用sum、average、max等) 
@OrderBy --Many端某個字段排序(List) Hibernate註解詳細說

Hibernate註解詳細說明 

1、@Entity(name="EntityName") 
必須
name爲可選,對應數據庫中一的個表 

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

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

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

generator = "uuid" :由Hibernate基於128 位惟一值產生算法生成16 進制數值（編碼後以長度32 的字符串表示）做爲主鍵。

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

@Id 
@GeneratedValue(strategy=GenerationType.SEQUENCE, generator="S_Teacher") @SequenceGenerator(name="S_Teacher",allocationSize=1,initialValue=1, sequenceName="S_Teacher") 

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

(1)、FetchType.LAZY：懶加載，加載一個實體時，定義懶加載的屬性不會立刻從數據庫中加載。
(2)、FetchType.EAGER：急加載，加載一個實體時，定義急加載的屬性會當即從數據庫中加載。
(3)、比方User類有兩個屬性，name跟address，就像百度知道，登陸後用戶名是須要顯示出來的，此屬性用到的概率極大，要立刻到數據庫查，用急加載；而用戶地址大多數狀況下不須要顯示出來，只有在查看用戶資料是才須要顯示，須要用了才查數據庫，用懶加載就行了。因此，並非一登陸就把用戶的全部資料都加載到對象中，因而有了這兩種加載模式。 optional:表示該屬性是否容許爲null,默認爲true

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

六、@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; } 

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

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

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

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

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

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

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

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

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

十二、@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表,用於實現多對多關聯 

1三、@MappedSuperclass 
可選 
@MappedSuperclass能夠將超類的JPA註解傳遞給子類,使子類可以繼承超類的JPA註解 

示例: 
@MappedSuperclass 
public class Employee() { .... } 
@Entity 
public class Engineer extends Employee { ..... } 
@Entity public class Manager extends Employee { ..... } 

1四、@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() { .......... } }