標籤：
常用的hibernate annotation標籤如下:
@Entity --注釋聲明該類為持久類。將一個Javabean類聲明為一 個實體的資料庫表映射類,最好實現序列化.此時,預設情況下,所有的類屬性都為映射到資料表的持久性欄位.若在類中,添加另外屬性,而非映射來資料庫的, 要用下面的Transient來註解.
@Table (name="promotion_info") --持久性映射的表(表名="promotion_info)[email protected]是類一級的註解,定義在@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為可選,對應資料庫中一的個表
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等主鍵產生方式.
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")
5、@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; }
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中的若 幹組合,預設為無級聯操作
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自動產生實體類註解（轉）
