天天看點

程式員的量化交易之路(16)--Hibernate注解總結_轉發的(4) 2.屬性級别注解 3.映射繼承關系 4.映射實體bean的關聯關系

因為cointrader中用到非常多的hibernate來做持久化,orm。是以不得不知道其注解知識。這裡我拷貝一篇我個人覺得很好的文章。

出處:http://blog.sina.com.cn/s/blog_935ebb670101dnre.html

1.類級别注解

@entity     映射實體類

@table    映射數句庫表

@entity(name="tablename") - 必須,注解将一個類聲明為一個實體bean。

屬性:

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

@table(name="",catalog="",schema="")  - 可選,通常和@entity 配合使用,隻能标注在實  體的 class 定義處,表示實體對應的資料庫表的資訊。

name - 可選,表示表的名稱,預設地,表名和實體名稱一緻,隻有在不一緻的情況下才需            要指定表名

catalog - 可選,表示catalog名稱,預設為 catalog("").

schema - 可選 , 表示 schema 名稱 , 預設為schema("").

@id     映射生成主鍵

@version    定義樂觀鎖

@column     映射表的列

@transient     定義暫态屬性  

@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方法上進行注釋聲明。

@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);

如果屬性為單一類型,則映射為@basic,

否則,如果屬性對應的類型定義了@embeddable注解,則映射為@embedded,

否則,如果屬性對應的類型實作了serializable, 則屬性被映射為@basic并在一個列中儲存該對象的serialized版本,

否則,如果該屬性的類型為java.sql.clob 或 java.sql.blob,則作為@lob并映射到适當的lobtype.。

@inheritance注解來定義所選擇的政策. 這個注解需要在每個類層次結構(class

hierarchy) 最頂端的實體類上使用

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

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

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

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

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

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

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

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

雙向:一般由多方管理。

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

@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的主鍵名稱

@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(mappedby = "主表類中的從表屬性")

   public 主表類 get主表類(){

return 主表對象

      }

  注意:@joincolumn是可選的。預設值是從表變量名+"_"+從表的主鍵(注意,這裡加的是主鍵。而不是主鍵對應的變量)。

@manytoone - 表示一個多對一的映射,該注解标注的屬性通常是資料庫表的外鍵。

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

           在多方

@manytoone(targetentity=xxxx.class)   //指定關聯對象

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

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

    // 訂單 order 和使用者 user 是一個 manytoone 的關系

    // 在 order 類中定義

    @manytoone()

    @joincolumn(name="user")

    public user getuser() {

       return user;

}

@onetomany - 描述一個一對多的關聯,該屬性應該為集合類型,在資料庫中并沒有實際字段。

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

@onetomany  預設會使用連接配接表做一對多關聯

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

2.雙向一對多

1)在多方

@manytoone

@joincolumn(name="自己的資料庫外鍵列名")

2)在一方

@onetomany(mappedby="多端的關聯屬性名")

@joincolumn(name="對方的資料庫外鍵列名")

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

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

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

1.單向多對多關聯:

    在主要方加入@manytomany注解即可。

2.雙向多對多關聯:

    兩個實體間互相關聯的屬性必須标記為@manytomany,并互相指定targetentity屬性。有且隻有一個實體的@manytomany注解需要指定mappedby屬性,指向targetentity的集合屬性名稱。