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字段生成,支持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 類型映射到特定數據庫的 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;
    }從表:主鍵加上如下內容:(表示主鍵的值從user對象得到
@GenericGenerator(name ="fkuid",strategy="foreign" ,
parameters={@Parameter(name="property",value="user")})
@GeneratedValue(generator="fkuid")
 
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的集合屬性名稱。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章