Hibernate---實體類注釋簡介


1.類級別注解

@Entity:映射實體類

@Entity(name="tableName") - 必須,注解將一個類聲明為一個實體bean。

屬性:

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

@Table:映射數句庫表

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

屬性:

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

catalog - 可選,表示Catalog名稱,默認為 Catalog("").

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

2.屬性級別注解

@Id:映射生成主鍵

@Version:定義樂觀鎖

@Column:映射表的列

@Transient:定義暫態屬性 

2.1 與主鍵相關注解

@Id - 必須,定義了映射到數據庫表的主鍵的屬性,一個實體只能有一個屬性被映射為主鍵。

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

屬性:

Strategy - 表示主鍵生成策略,取值有:

GenerationType.AUTO - 根據底層數據庫自動選擇(默認),若數據庫支持自動              增                                       長類型,則為自動增長。

GenerationType.INDENTITY - 根據數據庫的Identity字段生成,支持DB2、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 類型映射到特定數據庫的 BLOBTEXT字段類型,該屬性非常有用。

示例 :

@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.Clobjava.sql.Blob,則作為@Lob並映射到適當的LobType.

3.映射繼承關系

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

4.映射實體bean的關聯關系

4.1關聯映射的一些定義

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

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

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

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

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

單向一對一:數據唯一,數據庫數據也是一對一。艦船--->水手

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

單向:關系寫哪邊,就由誰管理。

雙向:一般由多方管理。

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

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

@OneToOne@OneToMany@ManyToOneManyToMany的共有屬性:

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="主表外鍵")   //這里指定的是數據庫中的外鍵字段。
   public B getB(){

    return b;

    }

從表:無

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

    return b;

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

    return 主表對象

   }
  注意:@JoinColumn是可選的。默認值是從表變量名+"_"+從表的主鍵(注意,這里加的是主鍵。而不是主鍵對應的變量)。

4.4 多對一關聯

@ManyToOne - 表示一個多對一的映射,該注解標注的屬性通常是數據庫表的外鍵。

1.單向多對一:多方有一方的引用,一方沒有多方的引用。

在多方

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

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

2.雙向多對一:配置方式同雙向一對多。

示例 :

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

    // 在 Order 類中定義

    @ManyToOne()

    @JoinColumn(name="USER")

    public User getUser() {

       return user;

    }

4.5 一對多關聯

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

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

@OneToMany  默認會使用連接表做一對多關聯

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

2.雙向一對多

1)在多方

@ManyToOne

@JoinColumn(name="自己的數據庫外鍵列名")

2)在一方

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

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

4.6 多對多關聯

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

屬性:

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

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

1.單向多對多關聯:

    在主控方加入@ManyToMany注解即可。

2.雙向多對多關聯:

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

以下為使用注解的實例:

我們以產品類型ProductType類和產品Product類為例,一個產品類型對應多個產品,刪除產品類型將該類型下的所有產品同時刪除。首先需要@OneToMany和@ManyToOne標簽來設置外鍵約束。

在一對多的關系中,一是關系維護端(owner side),多是關系被維護端(inverse side)。

@OneToMany有5個屬性:targetEntity,fetch,mappedBy,orphanRemoval,cascade

# targetEntity   (Class targetEntity() default void.class;)  屬性表示默認關聯的實體類型,默認為當前標注的實體類;
因為一對多的實體集合時保存在集合類中,因此必須指明集合類中保存的具體類型:
1)指定集合泛型的具體類型;如:public List<Product> getProducts() {...}
2)指定targetEntity屬性類型;如:@OneToMany(targetEntity=Product.class,...)

# fetch  (FetchType fetch() default LAZY;)  屬性是該實體的加載方式,FetchType是枚舉類型,值有兩種:LAZY和EAGER。一對多,一的一方,FetchType默認是LAZY, 多的一方FetchType默認是EAGER。如果在字段中聲明為Eager,那么在取得當前Bean時,同時會抓取Bean中的關聯Bean值。即數據庫查詢多次。反之Lazy則在之后抓取提交查詢。具體實驗講解:[Hibernate] - EAGER and LAZY

# mappedBy  (String mappedBy() default "";)  屬性用於雙向關聯實體時使用,用在關系的維護端指定關系的被維護端,在hibernate4中與外鍵標簽@JoinColumn沖突,同時使用會報錯;如:@OneToMany(targetEntity=Product.class,mappedBy="productType",...)。

#orphanRemoval  (boolean orphanRemoval() default false;)  屬性作用是刪除孤立記錄,即外鍵為空的類型,默認為false。該屬性為true時會根據外鍵執行級聯刪除,因為當你刪除productType的記錄時,會使product表的記錄外鍵被刪除變為孤立記錄,該屬性進而將孤立記錄刪除掉。但hibernate實際執行的語句是先刪除product表中的記錄,后刪除productType表中的記錄。

CascadeType[] cascade() default {};)  級聯屬性,默認為空。該屬性其實是一個值為枚舉類型CascadeType的數組,在jpa的CascadeType枚舉類型里面,有PERSIST(級聯保存操作),MERGE(合並(merge=save+update)),REMOVE(級聯刪除操作),REFRESH(級聯刷新操作),DETACH(級聯分離操作),ALL(所有級聯操作)等6個枚舉變量,其中DETACH是jpa2.0新加入的變量。這些變量的作用和他們的名字一樣,可以很清楚的辨別出。這里我現在僅僅用過級聯刪除操作,其他的操作都僅僅是從名字和注釋上猜測的,留待以后測試。

上面是jpa的級聯操作,但在網上很多教程中往往寫到用CascadeType.DELETE_ORPHAN,該操作屬於hibernate自身的級聯操作,在hibernate4中已聲明過時,並推薦使用orphanRemoval屬性來級聯刪除記錄。

在級聯刪除記錄時,要先用hibernate.load()方法加載持久化對象,然后才能根據外鍵進行級聯刪除。至於load()方法和get()方法有什么不同,這里有一篇博文講的不錯:hibernate session的常用方法解析

注意:改變model類的時候可能需要重新建表,如果級聯刪除不成功可以試一下。

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM