Hibernate註解方法使用總結

1.類級別註解

@Entity 映射實體類

@Table 映射數句庫表

 

@Entity(name="tableName")-必須，註解將一個類聲明爲一個實體bean。

屬性：

name -可選，對應數據庫中的一個表。若表名與實體類名相同，則能夠省略。

 

@Table(name="",catalog="",schema="") -可選，一般和@Entity配合使用，只能標註在實 體的class定義處，表示實體對應的數據庫表的信息。

屬性：

name-可選，表示表的名稱，默認地，表名和實體名稱一致，只有在不一致的狀況下才需 要指定表名

catalog-可選，表示Catalog名稱，默認爲Catalog("").

schema-可選,表示Schema名稱,默認爲Schema("").

2.屬性級別註解

@Id 映射生成主鍵

@Version 定義樂觀鎖

@Column 映射表的列

@Transient 定義暫態屬性

 

2.1與主鍵相關注解

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

 

@GeneratedValue(strategy=GenerationType,generator="")-可選，用於定義主鍵生成策略。

屬性：

Strategy-表示主鍵生成策略，取值有：

GenerationType.AUTO -根據底層數據庫自動選擇（默認），若數據庫支持自動 增 長類型，則爲自動增加。

GenerationType.INDENTITY -根據數據庫的Identity字段生成，支持DB二、MySQL、 MS、SQL Server、SyBase與HyperanoicSQL數據庫的Identity 類型主鍵。

GenerationType.SEQUENCE-使用Sequence來決定主鍵的取值，適合Oracle、DB2等 支持Sequence的數據庫，通常結合@SequenceGenerator使用。

(Oracle沒有自動增加類型，只能用Sequence)

GenerationType.TABLE -使用指定表來決定主鍵取值，結合@TableGenerator使用。

如：

@Id

@TableGenerator(name="tab_cat_gen",allocationSize=1)

@GeneratedValue(Strategy=GenerationType.Table)

Generator-表示主鍵生成器的名稱，這個屬性一般和ORM框架相關,例如：

Hibernate能夠指定uuid等主鍵生成方式

 

@SequenceGenerator—註解聲明瞭一個數據庫序列。

屬性：
name -表示該表主鍵生成策略名稱，它被引用在@GeneratedValue中設置的「gernerator」值中。
sequenceName -表示生成策略用到的數據庫序列名稱。
initialValue -表示主鍵初始值，默認爲0.
allocationSize -每次主鍵值增長的大小，例如設置成1，則表示每次建立新記錄後自動加1，默認爲50.

示例:

@Id

@GeneratedValues(strategy=StrategyType.SEQUENCE)

public int getPk() {

return pk;

}

 

Hibernate的訪問類型爲field時，在字段上進行註解聲；

訪問類型爲property時，在getter方法上進行註釋聲明。

 

2.2與非主鍵相關注解

@Version-能夠在實體bean中使用@Version註解,經過這種方式可添加對樂觀鎖定的支持

 

@Basic -用於聲明屬性的存取策略：

@Basic(fetch=FetchType.EAGER) 即時獲取（默認的存取策略）

@Basic(fetch=FetchType.LAZY) 延遲獲取

 

@Temporal-用於定義映射到數據庫的時間精度：

@Temporal(TemporalType=DATE) 日期

@Temporal(TemporalType=TIME) 時間

@Temporal(TemporalType=TIMESTAMP)二者兼具

 

@Column-可將屬性映射到列，使用該註解來覆蓋默認值，@Column描述了數據庫表中 該字段的詳細定義，這對於根據JPA註解生成數據庫表結構的工具很是有做用。

屬性：

name-可選，表示數據庫表中該字段的名稱，默認情形屬性名稱一致

nullable-可選，表示該字段是否容許爲null，默認爲true

unique-可選，表示該字段是不是惟一標識，默認爲false

length-可選，表示該字段的大小，僅對String類型的字段有效，默認值255.

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 -可選，表示該屬性並不是一個到數據庫表的字段的映射，ORM框架將忽略該屬性，若是一個屬性並不是數據庫表的字段映射，就務必將其標示爲@Transient，不然ORM框架默認其註解爲@Basic

示例:

//根據birth計算出age屬性

@Transient

public int getAge() {

return getYear(new Date()) - getYear(birth);

}

2.3無註解屬性的默認值

若是屬性爲單一類型,則映射爲@Basic，

不然,若是屬性對應的類型定義了@Embeddable註解,則映射爲@Embedded，

不然,若是屬性對應的類型實現了Serializable,則屬性被映射爲@Basic並在一個列中保存該對象的serialized版本，

不然,若是該屬性的類型爲java.sql.Clob或java.sql.Blob,則做爲@Lob並映射到適當的LobType.。

 

3.映射繼承關係

@Inheritance註解來定義所選擇的策略.這個註解須要在每一個類層次結構(classhierarchy)最頂端的實體類上使用

4.映射實體bean的關聯關係4.1關聯映射的一些定義

單向一對多：一方有集合屬性，包含多個多方，而多方沒有一方的引用。用戶--->電子郵件

單向多對一：多方有一方的引用，一方沒有多方的引用。論文類別--->類別

雙向一對多：兩邊都有多方的引用，方便查詢。班級--->學生

雙向多對一：兩邊都有多方的引用，方便查詢。

單向多對多：須要一箇中間表來維護兩個實體表。論壇--->文章

單向一對一：數據惟一，數據庫數據也是一對一。艦船--->水手

主鍵相同的一對一：使用同一個主鍵，省掉外鍵關聯。客戶--->地址

 

單向：關係寫哪邊，就由誰管理。

雙向：通常由多方管理。

@OneToMany(mappedBy="對方") //反向配置，對方管理。

4.2關聯映射的一些共有屬性

@OneToOne、@OneToMany、@ManyToOne、ManyToMany的共有屬性：

fetch-配置加載方式。取值有

Fetch.EAGER - 及時加載，多對一默認是Fetch.EAGER

Fetch.LAZY -延遲加載，一對多默認是Fetch.LAZY

cascade-設置級聯方式，取值有：

CascadeType.PERSIST -保存

CascadeType.REMOVE -刪除

CascadeType.MERGE -修改

CascadeType.REFRESH -刷新

CascadeType.ALL -所有

targetEntity-配置集合屬性類型，如：@OneToMany(targetEntity=Book.class)

 

@JoinColumn -可選，用於描述一個關聯的字段。

@JoinColumn和@Column相似，介量描述的不是一個簡單字段，而是一個關聯字段，例如描述一個@ManyToOne的字段。

 

屬性：

name-該字段的名稱，因爲@JoinColumn描述的是一個關聯字段，如ManyToOne,則默認的名稱由其關聯的實體決定。

例如，實體Order有一個user屬性來關聯實體User,則Order的user屬性爲一個外鍵,

其默認的名稱爲實體User的名稱+下劃線+實體User的主鍵名稱

4.3一對一關聯

@OneToOne–表示一個一對一的映射

1. 主表類A與從表類B的主鍵值相對應。
   主表：@OneToOne(cascade =CascadeType.ALL)
   @PrimaryKeyJoinColumn
   public B getB(){

Return b;

}
從表：無

 

2.主表A中有一個從表屬性是B類型的b

主表：@OneToOne(cascade =CascadeType.ALL)
@JoinColumn(name="主表外鍵") //這裏指定的是數據庫中的外鍵字段。
publicB getB(){

return b;

}

從表：無

 

3.主表A中有一個從表屬性是B類型的b，同時，從表B中有一個主表屬性是A類型的a
主表：@OneToOne(cascade = CascadeType.ALL)
@JoinColumn(name="主表外鍵") //這裏指定的是數據庫中的外鍵字段。
publicB getB(){

return b;

}
從表：@OneToOne(mappedBy = "主表類中的從表屬性")
public主表類 get主表類(){

return主表對象

}
注意：@JoinColumn是可選的。默認值是從表變量名+"_"+從表的主鍵（注意，這裏加的是主鍵。而不是主鍵對應的變量）。

4.4多對一關聯

@ManyToOne-表示一個多對一的映射，該註解標註的屬性一般是數據庫表的外鍵。

1. 單向多對一：多方有一方的引用，一方沒有多方的引用。

在多方

@ManyToOne(targetEntity=XXXX.class) //指定關聯對象

@JoinColumn(name="") //指定產生的外鍵字段名

 

1. 雙向多對一：配置方式同雙向一對多。

 

示例:

//訂單Order和用戶User是一個ManyToOne的關係

//在Order類中定義

@ManyToOne()

@JoinColumn(name="USER")

public User getUser() {

return user;

}

4.5一對多關聯

@OneToMany -描述一個一對多的關聯，該屬性應該爲集合類型，在數據庫中並無實際字段。

1. 單向一對多：一方有集合屬性，包含多個多方，而多方沒有一方的引用。

@OneToMany 默認會使用鏈接表作一對多關聯

添加@JoinColumn(name="xxx_id")後，就會使用外鍵關聯，而不使用鏈接表了。

 

1. 雙向一對多

2. 在多方

@ManyToOne

@JoinColumn(name="本身的數據庫外鍵列名")

 

1. 在一方

@OneToMany(mappedBy="多端的關聯屬性名")

@JoinColumn(name="對方的數據庫外鍵列名")

4.6多對多關聯

@ManyToMany -可選，描述一個多對多的關聯。

屬性：

targetEntity-表示多對多關聯的另外一個實體類的全名，例如：package.Book.class

mappedBy-用在雙向關聯中，把關係的維護權翻轉。

 

1. 單向多對多關聯：

在主控方加入@ManyToMany註解便可。

1. 雙向多對多關聯：

兩個實體間互相關聯的屬性必須標記爲@ManyToMany，並相互指定targetEntity屬性。有且只有一個實體的@ManyToMany註解須要指定mappedBy屬性，指向targetEntity的集合屬性名稱。