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註解來定義所選擇的策略. 這個註解須要在每一個類層次結構(class hierarchy) 最頂端的實體類上使用  
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="主表外鍵")   //這裏指定的是數據庫中的外鍵字段。    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的集合屬性名稱。