[hibernate]注解的說明
/**
*
* @author liuguangyi
* @content ejb3注解的API定義在javax.persistence.*包里面。
*
* 注釋說明:
* @Entity —— 將一個(gè)類聲明為一個(gè)實(shí)體bean(即一個(gè)持久化POJO類)
* @Id —— 注解聲明了該實(shí)體bean的標(biāo)識(shí)屬性(對(duì)應(yīng)表中的主鍵)。
* @Table —— 注解聲明了該實(shí)體bean映射指定的表(table),目錄(catalog)和schema的名字
* @Column —— 注解聲明了屬性到列的映射。該注解有如下的屬性
* name 可選,列名(默認(rèn)值是屬性名)
* unique 可選,是否在該列上設(shè)置唯一約束(默認(rèn)值false)
* nullable 可選,是否設(shè)置該列的值可以為空(默認(rèn)值false)
* insertable 可選,該列是否作為生成的insert語句中的一個(gè)列(默認(rèn)值true)
* updatable 可選,該列是否作為生成的update語句中的一個(gè)列(默認(rèn)值true)
* columnDefinition 可選,為這個(gè)特定列覆蓋sql ddl片段(這可能導(dǎo)致無法在不同數(shù)據(jù)庫間移植)
* table 可選,定義對(duì)應(yīng)的表(默認(rèn)為主表)
* length 可選,列長(zhǎng)度(默認(rèn)值255)
* precision 可選,列十進(jìn)制精度(decimal precision)(默認(rèn)值0)
* scale 可選,如果列十進(jìn)制數(shù)值范圍(decimal scale)可用,在此設(shè)置(默認(rèn)值0)
* @GeneratedValue —— 注解聲明了主鍵的生成策略。該注解有如下屬性
* strategy 指定生成的策略(JPA定義的),這是一個(gè)GenerationType。默認(rèn)是GenerationType. AUTO
* GenerationType.AUTO 主鍵由程序控制
* GenerationType.TABLE 使用一個(gè)特定的數(shù)據(jù)庫表格來保存主鍵
* GenerationType.IDENTITY 主鍵由數(shù)據(jù)庫自動(dòng)生成(主要是自動(dòng)增長(zhǎng)類型)
* GenerationType.SEQUENCE 根據(jù)底層數(shù)據(jù)庫的序列來生成主鍵,條件是數(shù)據(jù)庫支持序列。(這個(gè)值要與generator一起使用)
* generator 指定生成主鍵使用的生成器(可能是orcale中的序列)。
* @SequenceGenerator —— 注解聲明了一個(gè)數(shù)據(jù)庫序列。該注解有如下屬性
* name 表示該表主鍵生成策略名稱,它被引用在@GeneratedValue中設(shè)置的“gernerator”值中
* sequenceName 表示生成策略用到的數(shù)據(jù)庫序列名稱。
* initialValue 表示主鍵初始值,默認(rèn)為0.
* allocationSize 每次主鍵值增加的大小,例如設(shè)置成1,則表示每次創(chuàng)建新記錄后自動(dòng)加1,默認(rèn)為50.
* @GenericGenerator —— 注解聲明了一個(gè)hibernate的主鍵生成策略。支持十三種策略。該注解有如下屬性
* name 指定生成器名稱
* strategy 指定具體生成器的類名(指定生成策略)。
* parameters 得到strategy指定的具體生成器所用到的參數(shù)。
* 其十三種策略(strategy屬性的值)如下:
* 1.native 對(duì)于orcale采用Sequence方式,對(duì)于MySQL和SQL Server采用identity(處境主鍵生成機(jī)制),
* native就是將主鍵的生成工作將由數(shù)據(jù)庫完成,hibernate不管(很常用)
* 例:@GeneratedValue(generator = "paymentableGenerator")
* @GenericGenerator(name = "paymentableGenerator", strategy = "native")
* 2.uuid 采用128位的uuid算法生成主鍵,uuid被編碼為一個(gè)32位16進(jìn)制數(shù)字的字符串。占用空間大(字符串類型)。
* 例:@GeneratedValue(generator = "paymentableGenerator")
* @GenericGenerator(name = "paymentableGenerator", strategy = "uuid")
* 3.hilo 要在數(shù)據(jù)庫中建立一張額外的表,默認(rèn)表名為hibernate_unque_key,默認(rèn)字段為integer類型,名稱是next_hi(比較少用)
* 例:@GeneratedValue(generator = "paymentableGenerator")
* @GenericGenerator(name = "paymentableGenerator", strategy = "hilo")
* 4.assigned 在插入數(shù)據(jù)的時(shí)候主鍵由程序處理(很常用),這是<generator>元素沒有指定時(shí)的默認(rèn)生成策略。等同于JPA中的AUTO。
* 例:@GeneratedValue(generator = "paymentableGenerator")
* @GenericGenerator(name = "paymentableGenerator", strategy = "assigned")
* 5.identity 使用SQL Server和MySQL的自增字段,這個(gè)方法不能放到Oracle中,Oracle不支持自增字段,要設(shè)定sequence(MySQL和SQL Server中很常用)。等同于JPA中的IDENTITY
* 例:@GeneratedValue(generator = "paymentableGenerator")
* @GenericGenerator(name = "paymentableGenerator", strategy = "identity")
* 6.select 使用觸發(fā)器生成主鍵(主要用于早期的數(shù)據(jù)庫主鍵生成機(jī)制,少用)
* 例:@GeneratedValue(generator = "paymentableGenerator")
* @GenericGenerator(name = "paymentableGenerator", strategy = "select")
* 7.sequence 調(diào)用謹(jǐn)慎數(shù)據(jù)庫的序列來生成主鍵,要設(shè)定序列名,不然hibernate無法找到。
* 例:@GeneratedValue(generator = "paymentableGenerator")
* @GenericGenerator(name = "paymentableGenerator", strategy = "sequence",
* parameters = { @Parameter(name = "sequence", value = "seq_payablemoney") })
* 8.seqhilo 通過hilo算法實(shí)現(xiàn),但是主鍵歷史保存在Sequence中,適用于支持Sequence的數(shù)據(jù)庫,如Orcale(比較少用)
* 例:@GeneratedValue(generator = "paymentableGenerator")
* @GenericGenerator(name = "paymentableGenerator", strategy = "seqhilo",
* parameters = { @Parameter(name = "max_lo", value = "5") })
* 9.increnment 插入數(shù)據(jù)的時(shí)候hibernate會(huì)給主鍵添加一個(gè)自增的主鍵,但是一個(gè)hibernate實(shí)例就維護(hù)一個(gè)計(jì)數(shù)器,所以在多個(gè)實(shí)例運(yùn)行的時(shí)候不能使用這個(gè)方法。
* 例:@GeneratedValue(generator = "paymentableGenerator")
* @GenericGenerator(name = "paymentableGenerator", strategy = "increnment")
* 10.foreign 使用另一個(gè)相關(guān)的對(duì)象的主鍵。通常和<one-to-one>聯(lián)合起來使用。
* 例:@Id
* @GeneratedValue(generator = "idGenerator")
* @GenericGenerator(name = "idGenerator", strategy = "foreign",
* parameters = { @Parameter(name = "property", value = "info") })
* Integer id;
* @OneToOne
* EmployeeInfo info;
* 11.guid 采用數(shù)據(jù)庫底層的guid算法機(jī)制,對(duì)應(yīng)MySQL的uuid()函數(shù),SQL Server的newid()函數(shù),ORCALE的rawtohex(sys_guid())函數(shù)等
* 例:@GeneratedValue(generator = "paymentableGenerator")
* @GenericGenerator(name = "paymentableGenerator", strategy = "guid")
* 12.uuid.hex 看uudi,建議用uuid替換
* 例:@GeneratedValue(generator = "paymentableGenerator")
* @GenericGenerator(name = "paymentableGenerator", strategy = "uuid.hex")
* 13.sequence-identity sequence策略的擴(kuò)展,采用立即檢索策略來獲取sequence值,需要JDBC3.0和JDK4以上(含1.4)版本
* 例:@GeneratedValue(generator = "paymentableGenerator")
* @GenericGenerator(name = "paymentableGenerator", strategy = "sequence-identity",
* parameters = { @Parameter(name = "sequence", value = "seq_payablemoney") })
*
* @OneToOne 設(shè)置一對(duì)一個(gè)關(guān)聯(lián)。cascade屬性有五個(gè)值(只有CascadeType.ALL好用?很奇怪),分別是CascadeType.PERSIST(級(jí)聯(lián)新建),CascadeType.REMOVE(級(jí)聯(lián)刪除),CascadeType.REFRESH(級(jí)聯(lián)刷新),CascadeType.MERGE(級(jí)聯(lián)更新),CascadeType.ALL(全部四項(xiàng))
* 方法一
* 主表: ?@OneToOne(cascade = CascadeType.ALL)
* @PrimaryKeyJoinColumn
* public 從表類 get從表類(){return 從表對(duì)象}
* 從表:沒有主表類。
* 注意:這種方法要求主表與從表的主鍵值想對(duì)應(yīng)。
* 方法二
* 主表:?@OneToOne(cascade = CascadeType.ALL)
* @JoinColumn(name="主表外鍵") //這里指定的是數(shù)據(jù)庫中的外鍵字段。
* public 從表類 get從表類(){return 從表類}
* 從表:@OneToOne(mappedBy = "主表類中的從表屬性")//例主表User中有一個(gè)從表屬性是Heart類型的heart,這里就填heart
* public 主表類 get主表類(){return 主表對(duì)象}
* 注意:@JoinColumn是可選的。默認(rèn)值是從表變量名+"_"+從表的主鍵(注意,這里加的是主鍵。而不是主鍵對(duì)應(yīng)的變量)。
* 方法三
* 主表:@OneToOne(cascade=CascadeType.ALL)
* @JoinTable( name="關(guān)聯(lián)表名",
* joinColumns = @JoinColumn(name="主表外鍵"),
* inverseJoinColumns = @JoinColumns(name="從表外鍵")
* )
* 從表:@OneToOne(mappedBy = "主表類中的從表屬性")//例主表User中有一個(gè)從表屬性是Heart類型的heart,這里就填heart
* public 主表類 get主表類(){return 主表對(duì)象}
* @ManyToOne 設(shè)置多對(duì)一關(guān)聯(lián)
* 方法一
* @ManyToOne(cascade={CasCadeType.PERSIST,CascadeType.MERGE})
* @JoinColumn(name="外鍵")
* public 主表類 get主表類(){return 主表對(duì)象}
* 方法二
* @ManyToOne(cascade={CascadeType.PERSIST,CascadeType.MERGE})
* @JoinTable(name="關(guān)聯(lián)表名",
* joinColumns = @JoinColumn(name="主表外鍵"),
* inverseJoinColumns = @JoinColumns(name="從表外鍵")
* )
* @OneToMany 設(shè)置一對(duì)多關(guān)聯(lián)。cascade屬性指定關(guān)聯(lián)級(jí)別,參考@OneToOne中的說明。fetch指定是否延遲加載,值為FetchType.LAZY表示延遲,為FetchType.EAGER表示立即加載
* 方法一 使用這種配置,在為“一端”添加“多端”時(shí),不會(huì)修改“多端”的外鍵。在“一端”加載時(shí),不會(huì)得到“多端”。如果使用延遲加載,在讀“多端”列表時(shí)會(huì)出異常,立即加載在得到多端時(shí),是一個(gè)空集合(集合元素為0)。
* “一端”配置
* @OneToMany(mappedBy="“多端”的屬性")
* public List<“多端”類> get“多端”列表(){return “多端”列表}
* “多端”配置參考@ManyToOne.
* 方法二
* “一端”配置
* @OneToMany(mappedBy="“多端”的屬性")
* @MapKey(name="“多端”做為Key的屬性")
* public Map<“多端”做為Key的屬性的類,主表類> get“多端”列表(){return “多端”列表}
* “多端”配置參考@ManyToOne.
* 方法三 使用這種配置,在為“一端”添加“多端”時(shí),可以修改“多端”的外鍵。
* “一端”配置
* @OneToMany
* @JoinColumn(name="“多端”外鍵")
* public List<“多端”類> get“多端”列表(){return “多端”列表}
* “多端”配置參考@ManyToOne.
*
*
*/
*
* @author liuguangyi
* @content ejb3注解的API定義在javax.persistence.*包里面。
*
* 注釋說明:
* @Entity —— 將一個(gè)類聲明為一個(gè)實(shí)體bean(即一個(gè)持久化POJO類)
* @Id —— 注解聲明了該實(shí)體bean的標(biāo)識(shí)屬性(對(duì)應(yīng)表中的主鍵)。
* @Table —— 注解聲明了該實(shí)體bean映射指定的表(table),目錄(catalog)和schema的名字
* @Column —— 注解聲明了屬性到列的映射。該注解有如下的屬性
* name 可選,列名(默認(rèn)值是屬性名)
* unique 可選,是否在該列上設(shè)置唯一約束(默認(rèn)值false)
* nullable 可選,是否設(shè)置該列的值可以為空(默認(rèn)值false)
* insertable 可選,該列是否作為生成的insert語句中的一個(gè)列(默認(rèn)值true)
* updatable 可選,該列是否作為生成的update語句中的一個(gè)列(默認(rèn)值true)
* columnDefinition 可選,為這個(gè)特定列覆蓋sql ddl片段(這可能導(dǎo)致無法在不同數(shù)據(jù)庫間移植)
* table 可選,定義對(duì)應(yīng)的表(默認(rèn)為主表)
* length 可選,列長(zhǎng)度(默認(rèn)值255)
* precision 可選,列十進(jìn)制精度(decimal precision)(默認(rèn)值0)
* scale 可選,如果列十進(jìn)制數(shù)值范圍(decimal scale)可用,在此設(shè)置(默認(rèn)值0)
* @GeneratedValue —— 注解聲明了主鍵的生成策略。該注解有如下屬性
* strategy 指定生成的策略(JPA定義的),這是一個(gè)GenerationType。默認(rèn)是GenerationType. AUTO
* GenerationType.AUTO 主鍵由程序控制
* GenerationType.TABLE 使用一個(gè)特定的數(shù)據(jù)庫表格來保存主鍵
* GenerationType.IDENTITY 主鍵由數(shù)據(jù)庫自動(dòng)生成(主要是自動(dòng)增長(zhǎng)類型)
* GenerationType.SEQUENCE 根據(jù)底層數(shù)據(jù)庫的序列來生成主鍵,條件是數(shù)據(jù)庫支持序列。(這個(gè)值要與generator一起使用)
* generator 指定生成主鍵使用的生成器(可能是orcale中的序列)。
* @SequenceGenerator —— 注解聲明了一個(gè)數(shù)據(jù)庫序列。該注解有如下屬性
* name 表示該表主鍵生成策略名稱,它被引用在@GeneratedValue中設(shè)置的“gernerator”值中
* sequenceName 表示生成策略用到的數(shù)據(jù)庫序列名稱。
* initialValue 表示主鍵初始值,默認(rèn)為0.
* allocationSize 每次主鍵值增加的大小,例如設(shè)置成1,則表示每次創(chuàng)建新記錄后自動(dòng)加1,默認(rèn)為50.
* @GenericGenerator —— 注解聲明了一個(gè)hibernate的主鍵生成策略。支持十三種策略。該注解有如下屬性
* name 指定生成器名稱
* strategy 指定具體生成器的類名(指定生成策略)。
* parameters 得到strategy指定的具體生成器所用到的參數(shù)。
* 其十三種策略(strategy屬性的值)如下:
* 1.native 對(duì)于orcale采用Sequence方式,對(duì)于MySQL和SQL Server采用identity(處境主鍵生成機(jī)制),
* native就是將主鍵的生成工作將由數(shù)據(jù)庫完成,hibernate不管(很常用)
* 例:@GeneratedValue(generator = "paymentableGenerator")
* @GenericGenerator(name = "paymentableGenerator", strategy = "native")
* 2.uuid 采用128位的uuid算法生成主鍵,uuid被編碼為一個(gè)32位16進(jìn)制數(shù)字的字符串。占用空間大(字符串類型)。
* 例:@GeneratedValue(generator = "paymentableGenerator")
* @GenericGenerator(name = "paymentableGenerator", strategy = "uuid")
* 3.hilo 要在數(shù)據(jù)庫中建立一張額外的表,默認(rèn)表名為hibernate_unque_key,默認(rèn)字段為integer類型,名稱是next_hi(比較少用)
* 例:@GeneratedValue(generator = "paymentableGenerator")
* @GenericGenerator(name = "paymentableGenerator", strategy = "hilo")
* 4.assigned 在插入數(shù)據(jù)的時(shí)候主鍵由程序處理(很常用),這是<generator>元素沒有指定時(shí)的默認(rèn)生成策略。等同于JPA中的AUTO。
* 例:@GeneratedValue(generator = "paymentableGenerator")
* @GenericGenerator(name = "paymentableGenerator", strategy = "assigned")
* 5.identity 使用SQL Server和MySQL的自增字段,這個(gè)方法不能放到Oracle中,Oracle不支持自增字段,要設(shè)定sequence(MySQL和SQL Server中很常用)。等同于JPA中的IDENTITY
* 例:@GeneratedValue(generator = "paymentableGenerator")
* @GenericGenerator(name = "paymentableGenerator", strategy = "identity")
* 6.select 使用觸發(fā)器生成主鍵(主要用于早期的數(shù)據(jù)庫主鍵生成機(jī)制,少用)
* 例:@GeneratedValue(generator = "paymentableGenerator")
* @GenericGenerator(name = "paymentableGenerator", strategy = "select")
* 7.sequence 調(diào)用謹(jǐn)慎數(shù)據(jù)庫的序列來生成主鍵,要設(shè)定序列名,不然hibernate無法找到。
* 例:@GeneratedValue(generator = "paymentableGenerator")
* @GenericGenerator(name = "paymentableGenerator", strategy = "sequence",
* parameters = { @Parameter(name = "sequence", value = "seq_payablemoney") })
* 8.seqhilo 通過hilo算法實(shí)現(xiàn),但是主鍵歷史保存在Sequence中,適用于支持Sequence的數(shù)據(jù)庫,如Orcale(比較少用)
* 例:@GeneratedValue(generator = "paymentableGenerator")
* @GenericGenerator(name = "paymentableGenerator", strategy = "seqhilo",
* parameters = { @Parameter(name = "max_lo", value = "5") })
* 9.increnment 插入數(shù)據(jù)的時(shí)候hibernate會(huì)給主鍵添加一個(gè)自增的主鍵,但是一個(gè)hibernate實(shí)例就維護(hù)一個(gè)計(jì)數(shù)器,所以在多個(gè)實(shí)例運(yùn)行的時(shí)候不能使用這個(gè)方法。
* 例:@GeneratedValue(generator = "paymentableGenerator")
* @GenericGenerator(name = "paymentableGenerator", strategy = "increnment")
* 10.foreign 使用另一個(gè)相關(guān)的對(duì)象的主鍵。通常和<on
* 例:@Id
* @GeneratedValue(generator = "idGenerator")
* @GenericGenerator(name = "idGenerator", strategy = "foreign",
* parameters = { @Parameter(name = "property", value = "info") })
* Integer id;
* @On
* EmployeeInfo info;
* 11.guid 采用數(shù)據(jù)庫底層的guid算法機(jī)制,對(duì)應(yīng)MySQL的uuid()函數(shù),SQL Server的newid()函數(shù),ORCALE的rawtohex(sys_guid())函數(shù)等
* 例:@GeneratedValue(generator = "paymentableGenerator")
* @GenericGenerator(name = "paymentableGenerator", strategy = "guid")
* 12.uuid.hex 看uudi,建議用uuid替換
* 例:@GeneratedValue(generator = "paymentableGenerator")
* @GenericGenerator(name = "paymentableGenerator", strategy = "uuid.hex")
* 13.sequence-identity sequence策略的擴(kuò)展,采用立即檢索策略來獲取sequence值,需要JDBC3.0和JDK4以上(含1.4)版本
* 例:@GeneratedValue(generator = "paymentableGenerator")
* @GenericGenerator(name = "paymentableGenerator", strategy = "sequence-identity",
* parameters = { @Parameter(name = "sequence", value = "seq_payablemoney") })
*
* @On
* 方法一
* 主表: ?@On
* @PrimaryKeyJoinColumn
* public 從表類 get從表類(){return 從表對(duì)象}
* 從表:沒有主表類。
* 注意:這種方法要求主表與從表的主鍵值想對(duì)應(yīng)。
* 方法二
* 主表:?@On
* @JoinColumn(name="主表外鍵") //這里指定的是數(shù)據(jù)庫中的外鍵字段。
* public 從表類 get從表類(){return 從表類}
* 從表:@On
* public 主表類 get主表類(){return 主表對(duì)象}
* 注意:@JoinColumn是可選的。默認(rèn)值是從表變量名+"_"+從表的主鍵(注意,這里加的是主鍵。而不是主鍵對(duì)應(yīng)的變量)。
* 方法三
* 主表:@On
* @JoinTable( name="關(guān)聯(lián)表名",
* joinColumns = @JoinColumn(name="主表外鍵"),
* inverseJoinColumns = @JoinColumns(name="從表外鍵")
* )
* 從表:@On
* public 主表類 get主表類(){return 主表對(duì)象}
* @ManyToOne 設(shè)置多對(duì)一關(guān)聯(lián)
* 方法一
* @ManyToOne(cascade={CasCadeType.PERSIST,CascadeType.MERGE})
* @JoinColumn(name="外鍵")
* public 主表類 get主表類(){return 主表對(duì)象}
* 方法二
* @ManyToOne(cascade={CascadeType.PERSIST,CascadeType.MERGE})
* @JoinTable(name="關(guān)聯(lián)表名",
* joinColumns = @JoinColumn(name="主表外鍵"),
* inverseJoinColumns = @JoinColumns(name="從表外鍵")
* )
* @On
* 方法一 使用這種配置,在為“一端”添加“多端”時(shí),不會(huì)修改“多端”的外鍵。在“一端”加載時(shí),不會(huì)得到“多端”。如果使用延遲加載,在讀“多端”列表時(shí)會(huì)出異常,立即加載在得到多端時(shí),是一個(gè)空集合(集合元素為0)。
* “一端”配置
* @On
* public List<“多端”類> get“多端”列表(){return “多端”列表}
* “多端”配置參考@ManyToOne.
* 方法二
* “一端”配置
* @On
* @MapKey(name="“多端”做為Key的屬性")
* public Map<“多端”做為Key的屬性的類,主表類> get“多端”列表(){return “多端”列表}
* “多端”配置參考@ManyToOne.
* 方法三 使用這種配置,在為“一端”添加“多端”時(shí),可以修改“多端”的外鍵。
* “一端”配置
* @On
* @JoinColumn(name="“多端”外鍵")
* public List<“多端”類> get“多端”列表(){return “多端”列表}
* “多端”配置參考@ManyToOne.
*
*
*/
posted on 2010-12-14 15:31 Eric Gu 閱讀(3107) 評(píng)論(0) 編輯 收藏