Hibernate4 注解方法说明
?
前些天發(fā)現(xiàn)了一個(gè)巨牛的人工智能學(xué)習(xí)網(wǎng)站,通俗易懂,風(fēng)趣幽默,忍不住分享一下給大家。點(diǎn)擊跳轉(zhuǎn)到教程。
1.類級(jí)別注解
?
@Entity?????映射實(shí)體類
@Table????映射數(shù)句庫(kù)表
?
@Entity(name="tableName")?-?必須,注解將一個(gè)類聲明為一個(gè)實(shí)體bean。
屬性:
name -?可選,對(duì)應(yīng)數(shù)據(jù)庫(kù)中的一個(gè)表。若表名與實(shí)體類名相同,則可以省略。
?
@Table(name="",catalog="",schema="")??-?可選,通常和@Entity?配合使用,只能標(biāo)注在實(shí)??體的?class?定義處,表示實(shí)體對(duì)應(yīng)的數(shù)據(jù)庫(kù)表的信息。
屬性:
name?-?可選,表示表的名稱,默認(rèn)地,表名和實(shí)體名稱一致,只有在不一致的情況下才需????????????要指定表名
catalog?-?可選,表示Catalog名稱,默認(rèn)為?Catalog("").
schema?-?可選?,?表示?Schema?名稱?,?默認(rèn)為Schema("").
2.屬性級(jí)別注解
@Id?????映射生成主鍵
@Version????定義樂觀鎖
@Column?????映射表的列
@Transient?????定義暫態(tài)屬性??
?
2.1?與主鍵相關(guān)注解
@Id?-?必須,定義了映射到數(shù)據(jù)庫(kù)表的主鍵的屬性,一個(gè)實(shí)體只能有一個(gè)屬性被映射為主??鍵,置于?getXxxx()?前。
?
@GeneratedValue(strategy=GenerationType,generator="")?-?可選,用于定義主鍵生成策略。
屬性:
Strategy?-?表示主鍵生成策略,取值有:
GenerationType.AUTO?-?根據(jù)底層數(shù)據(jù)庫(kù)自動(dòng)選擇(默認(rèn)),若數(shù)據(jù)庫(kù)支持自動(dòng)??????????????增???????????????????????????????????????長(zhǎng)類型,則為自動(dòng)增長(zhǎng)。
GenerationType.INDENTITY?-?根據(jù)數(shù)據(jù)庫(kù)的Identity字段生成,支持DB2、MySQL、????????????????????????????????????????MS、SQL Server、SyBase與HyperanoicSQL數(shù)據(jù)庫(kù)的Identity??????????????????????????????????????????類型主鍵。
GenerationType.SEQUENCE?-?使用Sequence來(lái)決定主鍵的取值,適合Oracle、DB2等??????????????????????????????????????支持Sequence的數(shù)據(jù)庫(kù),一般結(jié)合@SequenceGenerator使用。
(Oracle沒有自動(dòng)增長(zhǎng)類型,只能用Sequence)
GenerationType.TABLE??-?使用指定表來(lái)決定主鍵取值,結(jié)合@TableGenerator使用。
如:
@Id
@TableGenerator(name="tab_cat_gen",allocationSize=1)
@GeneratedValue(Strategy=GenerationType.Table)
Generator?-?表示主鍵生成器的名稱,這個(gè)屬性通常和ORM框架相關(guān)?,?例如:
Hibernate?可以指定?uuid?等主鍵生成方式
?
@SequenceGenerator?—?注解聲明了一個(gè)數(shù)據(jù)庫(kù)序列。
屬性:
name?-?表示該表主鍵生成策略名稱,它被引用在@GeneratedValue中設(shè)置的“gernerator”值中。
sequenceName?-?表示生成策略用到的數(shù)據(jù)庫(kù)序列名稱。
initialValue?-?表示主鍵初始值,默認(rèn)為0.
allocationSize?-?每次主鍵值增加的大小,例如設(shè)置成1,則表示每次創(chuàng)建新記錄后自動(dòng)加1,默認(rèn)為50.
?
示例?:
????@Id
????@GeneratedValues(strategy=StrategyType.SEQUENCE)
????public int getPk() {
???????return pk;??
????}?
?
Hibernate的訪問類型為field時(shí),在字段上進(jìn)行注解聲;
訪問類型為property時(shí),在getter方法上進(jìn)行注釋聲明。
?
2.2?與非主鍵相關(guān)注解
@Version?-?可以在實(shí)體bean中使用@Version注解,通過這種方式可添加對(duì)樂觀鎖定的支持
?
@Basic -?用于聲明屬性的存取策略:
@Basic(fetch=FetchType.EAGER)???即時(shí)獲取(默認(rèn)的存取策略)
@Basic(fetch=FetchType.LAZY)????延遲獲取
?
@Temporal?-?用于定義映射到數(shù)據(jù)庫(kù)的時(shí)間精度:
@Temporal(TemporalType=DATE)???????日期
@Temporal(TemporalType=TIME)???????時(shí)間
@Temporal(TemporalType=TIMESTAMP)?兩者兼具
?
@Column?-?可將屬性映射到列,使用該注解來(lái)覆蓋默認(rèn)值,@Column描述了數(shù)據(jù)庫(kù)表中???????????該字段的詳細(xì)定義,這對(duì)于根據(jù)JPA?注解生成數(shù)據(jù)庫(kù)表結(jié)構(gòu)的工具非常有作用。
屬性:
name?-?可選,表示數(shù)據(jù)庫(kù)表中該字段的名稱,默認(rèn)情形屬性名稱一致
nullable?-?可選,表示該字段是否允許為?null,默認(rèn)為?true
unique?-?可選,表示該字段是否是唯一標(biāo)識(shí),默認(rèn)為?false
length?-?可選,表示該字段的大小,僅對(duì)?String?類型的字段有效,默認(rèn)值255.
insertable?-?可選,表示在ORM框架執(zhí)行插入操作時(shí),該字段是否應(yīng)出現(xiàn)INSETRT???????????????語(yǔ)句中,默認(rèn)為?true
updateable?-?可選,表示在ORM?框架執(zhí)行更新操作時(shí),該字段是否應(yīng)該出現(xiàn)在???????????????UPDATE?語(yǔ)句中,默認(rèn)為true.?對(duì)于一經(jīng)創(chuàng)建就不可以更改的字段,該???????????屬性非常有用,如對(duì)于?birthday?字段。
columnDefinition?-?可選,表示該字段在數(shù)據(jù)庫(kù)中的實(shí)際類型。通常ORM?框架可以根?????據(jù)屬性類型自動(dòng)判斷數(shù)據(jù)庫(kù)中字段的類型,但是對(duì)于Date?類型仍無(wú)法確定數(shù)據(jù)???????庫(kù)中字段類型究竟是?DATE,TIME?還是?TIMESTAMP.?此外?,String?的默認(rèn)映射類型為?VARCHAR,?如果要將?String?類型映射到特定數(shù)據(jù)庫(kù)的?BLOB或?TEXT?字段類型,該屬性非常有用。
示例?:
????@Column(name="BIRTH",nullable="false",columnDefinition="DATE")
????public String getBithday() {
???????return birthday;
????}
??
@Transient -?可選,表示該屬性并非一個(gè)到數(shù)據(jù)庫(kù)表的字段的映射,ORM框架將忽略該屬性,如果一個(gè)屬性并非數(shù)據(jù)庫(kù)表的字段映射,就務(wù)必將其標(biāo)示為@Transient,否則ORM?框架默認(rèn)其注解為?@Basic
示例?:
????//?根據(jù)?birth?計(jì)算出?age?屬性
????@Transient
????public int getAge() {
???????return getYear(new Date()) - getYear(birth);
????}
2.3無(wú)注解屬性的默認(rèn)值
如果屬性為單一類型,則映射為@Basic,
否則,如果屬性對(duì)應(yīng)的類型定義了@Embeddable注解,則映射為@Embedded,
否則,如果屬性對(duì)應(yīng)的類型實(shí)現(xiàn)了Serializable,?則屬性被映射為@Basic并在一個(gè)列中保存該對(duì)象的serialized版本,
否則,如果該屬性的類型為java.sql.Clob?或?java.sql.Blob,則作為@Lob并映射到適當(dāng)?shù)?/span>LobType.。
?
3.映射繼承關(guān)系
@Inheritance注解來(lái)定義所選擇的策略.?這個(gè)注解需要在每個(gè)類層次結(jié)構(gòu)(class hierarchy)?最頂端的實(shí)體類上使用
4.映射實(shí)體bean的關(guān)聯(lián)關(guān)系
4.1關(guān)聯(lián)映射的一些定義
單向一對(duì)多:一方有集合屬性,包含多個(gè)多方,而多方?jīng)]有一方的引用。用戶--->電子郵件
單向多對(duì)一:多方有一方的引用,一方?jīng)]有多方的引用。論文類別--->?類別
雙向一對(duì)多:兩邊都有多方的引用,方便查詢。班級(jí)--->?學(xué)生
雙向多對(duì)一:兩邊都有多方的引用,方便查詢。
單向多對(duì)多:需要一個(gè)中間表來(lái)維護(hù)兩個(gè)實(shí)體表。論壇--->文章
單向一對(duì)一:數(shù)據(jù)唯一,數(shù)據(jù)庫(kù)數(shù)據(jù)也是一對(duì)一。艦船--->?水手
主鍵相同的一對(duì)一:使用同一個(gè)主鍵,省掉外鍵關(guān)聯(lián)。客戶--->?地址
?
單向:關(guān)系寫哪邊,就由誰(shuí)管理。
雙向:一般由多方管理。
@OneToMany(mappedBy="對(duì)方") //反向配置,對(duì)方管理。
4.2?關(guān)聯(lián)映射的一些共有屬性
@OneToOne、@OneToMany、@ManyToOne、ManyToMany的共有屬性:
fetch?-?配置加載方式。取值有
Fetch.EAGER?-??及時(shí)加載,多對(duì)一默認(rèn)是Fetch.EAGER?
Fetch.LAZY?-?延遲加載,一對(duì)多默認(rèn)是Fetch.LAZY
cascade?-?設(shè)置級(jí)聯(lián)方式,取值有:
CascadeType.PERSIST?-?保存
CascadeType.REMOVE?-?刪除
CascadeType.MERGE?-?修改
CascadeType.REFRESH?-?刷新
CascadeType.ALL?-?全部
targetEntity?-?配置集合屬性類型,如:@OneToMany(targetEntity=Book.class)
?
@JoinColumn -?可選,用于描述一個(gè)關(guān)聯(lián)的字段。
@JoinColumn和@Column類似,介量描述的不是一個(gè)簡(jiǎn)單字段,而是一個(gè)關(guān)聯(lián)字段,例如描述一個(gè)?@ManyToOne?的字段。
?
屬性:
name?-?該字段的名稱,由于@JoinColumn描述的是一個(gè)關(guān)聯(lián)字段,如ManyToOne,?則默認(rèn)的名稱由其關(guān)聯(lián)的實(shí)體決定。
例如,實(shí)體?Order?有一個(gè)user?屬性來(lái)關(guān)聯(lián)實(shí)體?User,?則?Order?的?user?屬性為一個(gè)外鍵?,
其默認(rèn)的名稱為實(shí)體User的名稱?+?下劃線?+?實(shí)體User的主鍵名稱
4.3?一對(duì)一關(guān)聯(lián)
@OneToOne?–?表示一個(gè)一對(duì)一的映射
1.主表類A與從表類B的主鍵值相對(duì)應(yīng)。
?主表:@OneToOne(cascade = CascadeType.ALL)
?????@PrimaryKeyJoinColumn
?????public B getB(){
??Return b;
????}
從表:無(wú)
?
2.主表A中有一個(gè)從表屬性是B類型的b
主表:@OneToOne(cascade = CascadeType.ALL)
???@JoinColumn(name="主表外鍵")???//這里指定的是數(shù)據(jù)庫(kù)中的外鍵字段。
???public B getB(){
return b;
???????}
從表:無(wú)
?
3.主表A中有一個(gè)從表屬性是B類型的b,同時(shí),從表B中有一個(gè)主表屬性是A類型的a
主表:@OneToOne(cascade = CascadeType.ALL)
???@JoinColumn(name="主表外鍵")???//這里指定的是數(shù)據(jù)庫(kù)中的外鍵字段。
???public B getB(){
return b;
???????}
從表:@OneToOne(mappedBy = "主表類中的從表屬性")
???public?主表類?get主表類(){
return?主表對(duì)象
??????}
??注意:@JoinColumn是可選的。默認(rèn)值是從表變量名+"_"+從表的主鍵(注意,這里加的是主鍵。而不是主鍵對(duì)應(yīng)的變量)。
4.4?多對(duì)一關(guān)聯(lián)
@ManyToOne?-?表示一個(gè)多對(duì)一的映射,該注解標(biāo)注的屬性通常是數(shù)據(jù)庫(kù)表的外鍵。
1.單向多對(duì)一:多方有一方的引用,一方?jīng)]有多方的引用。
???????????在多方
@ManyToOne(targetEntity=XXXX.class)???//指定關(guān)聯(lián)對(duì)象
@JoinColumn(name="")????????????????????????????//指定產(chǎn)生的外鍵字段名
?
2.雙向多對(duì)一:配置方式同雙向一對(duì)多。
?
示例?:
????//?訂單?Order?和用戶?User?是一個(gè)?ManyToOne?的關(guān)系
????//?在?Order?類中定義
????@ManyToOne()
????@JoinColumn(name="USER")
????public User getUser() {
???????return user;
}
4.5?一對(duì)多關(guān)聯(lián)
@OneToMany -?描述一個(gè)一對(duì)多的關(guān)聯(lián),該屬性應(yīng)該為集合類型,在數(shù)據(jù)庫(kù)中并沒有實(shí)際字段。
1.單向一對(duì)多:一方有集合屬性,包含多個(gè)多方,而多方?jīng)]有一方的引用。
@OneToMany??默認(rèn)會(huì)使用連接表做一對(duì)多關(guān)聯(lián)
添加@JoinColumn(name="xxx_id")?后,就會(huì)使用外鍵關(guān)聯(lián),而不使用連接表了。
?
2.雙向一對(duì)多
1)在多方
@ManyToOne
@JoinColumn(name="自己的數(shù)據(jù)庫(kù)外鍵列名")
?
2)在一方
@OneToMany(mappedBy="多端的關(guān)聯(lián)屬性名")
@JoinColumn(name="對(duì)方的數(shù)據(jù)庫(kù)外鍵列名")
4.6?多對(duì)多關(guān)聯(lián)
@ManyToMany -?可選,描述一個(gè)多對(duì)多的關(guān)聯(lián)。
屬性:
targetEntity?-?表示多對(duì)多關(guān)聯(lián)的另一個(gè)實(shí)體類的全名,例如:package.Book.class
mappedBy?-?用在雙向關(guān)聯(lián)中,把關(guān)系的維護(hù)權(quán)翻轉(zhuǎn)。
?
1.單向多對(duì)多關(guān)聯(lián):
????在主控方加入@ManyToMany注解即可。
2.雙向多對(duì)多關(guān)聯(lián):
????兩個(gè)實(shí)體間互相關(guān)聯(lián)的屬性必須標(biāo)記為@ManyToMany,并相互指定targetEntity屬性。有且只有一個(gè)實(shí)體的@ManyToMany注解需要指定mappedBy屬性,指向targetEntity的集合屬性名稱。
[From:blog_935ebb670101dnre.html]
?
@Entity,注冊(cè)在類頭上,將一個(gè)類聲明為一個(gè)實(shí)體bean(即一個(gè)持久化POJO類) 。 @Table,注冊(cè)在類頭上,注解聲明了該實(shí)體bean映射指定的表(table)。 @Id用來(lái)注冊(cè)主屬性,@GeneratedValue用來(lái)注冊(cè)主屬性的生成策略,@Column用來(lái)注冊(cè)屬性,@Version用來(lái)注冊(cè)樂觀鎖,@Transient用來(lái)注冊(cè)不是屬性。 以上的@Id、@GeneratedValue、 @Column 、 @Version,可以用來(lái)注冊(cè)屬性,既可以寫在Java類的屬性上,也可以注冊(cè)在屬性對(duì)應(yīng)的getter上。 @Transient注冊(cè)在多余的屬性或多余的getter上,但是必須與以上的@Column等對(duì)應(yīng)。 @Column 標(biāo)識(shí)屬性對(duì)應(yīng)的字段,示例:@Column(name=“userName")@Column(
????name="columnName";????????????????????????????????(1)
????boolean unique() default false;???????????????????(2)
????boolean nullable() default true;??????????????????(3)
????boolean insertable() default true;????????????????(4)
????boolean updatable() default true;?????????????????(5)
????String columnDefinition() default "";?????????????(6)
????String table() default "";????????????????????????(7)
????int length() default 255;?????????????????????????(8)
????int precision() default 0; // decimal precision???(9)
????int scale() default 0; // decimal scale???????????(10) (1) name 可選,列名(默認(rèn)值是屬性名) (2) unique 可選,是否在該列上設(shè)置唯一約束(默認(rèn)值false) (3) nullable 可選,是否設(shè)置該列的值可以為空(默認(rèn)值false) (4) insertable 可選,該列是否作為生成的insert語(yǔ)句中的一個(gè)列(默認(rèn)值true) (5) updatable 可選,該列是否作為生成的update語(yǔ)句中的一個(gè)列(默認(rèn)值true) (6) columnDefinition 可選: 為這個(gè)特定列覆蓋SQL DDL片段 (這可能導(dǎo)致無(wú)法在不同數(shù)據(jù)庫(kù)間移植) (7) table 可選,定義對(duì)應(yīng)的表(默認(rèn)為主表) (8) length 可選,列長(zhǎng)度(默認(rèn)值255) (8) precision 可選,列十進(jìn)制精度(decimal precision)(默認(rèn)值0) (10) scale 可選,如果列十進(jìn)制數(shù)值范圍(decimal scale)可用,在此設(shè)置(默認(rèn)值0) @Id,標(biāo)識(shí)這個(gè)屬性是實(shí)體類的唯一識(shí)別的值。 注意:這個(gè)注解只能標(biāo)注單一列構(gòu)成的主鍵,如tbl_grade那種有兩個(gè)字段組成的聯(lián)合主鍵由其他注解標(biāo)識(shí)。 回憶*.hbm.xml: "uuid"> "assigned"/> @Id,只是標(biāo)識(shí)這個(gè)屬性是主鍵,但是并沒有指出其生成策略,如上例中的assigned就是由程序員指定的生成策略。 如果僅僅寫出@Id,即是使用assigned生成略,如: @Id
@Column
private int uuid;
如果想使用Oracle支持的sequence取主鍵,必須通過@GeneratedValue來(lái)指定生成策略,而由@SequenceGenerator指定如何使用sequence。
@Id
@Column
@GeneratedValue(
strategy = GenerationType.SEQUENCE,//使用sequence生成主鍵
generator =“generator“//引用下面名為gernator的生成策略
)
@SequenceGenerator(
name = “generator”,//定義名為generator的生成策略
allocationSize = 1,//每次sequence加1
name=“seq_a”//引用名為seq_a的sequence
)
private int uuid;
@Version 標(biāo)識(shí)這個(gè)屬性用來(lái)映射樂觀鎖的version @Transient 標(biāo)識(shí)這個(gè)屬性不用持久化 @Embeddable【小對(duì)象的頭上】 標(biāo)識(shí)實(shí)體中可以定義一個(gè)嵌入式組件(embedded component)。組件類必須在類一級(jí)定義@Embeddable注解。 @Embedded【大對(duì)象的屬性頭上】 引用定義的小對(duì)象。 @Embeddable【小對(duì)象的頭上】 標(biāo)識(shí)實(shí)體中可以定義一個(gè)嵌入式組件(embedded component)。組件類必須在類一級(jí)定義@Embeddable注解。 注意:如果這個(gè)小對(duì)象作為復(fù)合主鍵,一定要實(shí)現(xiàn)Serializable接口。這并不是注解決定的,而是Hibernate的主鍵都需要實(shí)現(xiàn)Serializable接口。 @EmbeddedId 【大對(duì)象的屬性頭上】 引用定義的小對(duì)象作為主鍵。 注意:不需要再使用@Id注解。 標(biāo)準(zhǔn)的1:1
XML的配置 主1【tbl_product】:
從1【tbl_product_info】:
product【引用自己的Java屬性名】
? 注解的配置 主1【tbl_product】:
@OneToOne(cascade=CascadeType.ALL)
@PrimaryKeyJoinColumn
private ProductInfoModel info;
從1【tbl_product_info】:
@Id
@Column
@GeneratedValue(generator=“copy【引用生成策略】")
@GenericGenerator(name=“copy【定義生成策略】”,strategy=“foreign【寫死,使用外來(lái)策略】”,parameters=@Parameter(name=“property”,value=“product【引用自己的Java屬性】"))
private int uuid;
@OneToOne(mappedBy=“info【引用對(duì)方的Java屬性】")
private ProductModel product;
? 標(biāo)準(zhǔn)的1:M XML的配置 1【tbl_parent】:
?
???????
???????
?
多【tbl_child】: 注解的配置 1【tbl_parent】:
@OneToMany
@JoinColumn(name="puuid【對(duì)方的數(shù)據(jù)庫(kù)外鍵列名】")
private Set children = new HashSet();
多【tbl_child】:
@ManyToOne
@JoinColumn(name="puuid【自己的數(shù)據(jù)庫(kù)外鍵列名】")
private ParentModel parent;
?
?
注解的配置
主1【tbl_product】:
@OneToOne(cascade=CascadeType.ALL,mappedBy=“product【對(duì)方的Java類屬性名】")
private ProductInfoModel info;
從1【tbl_product_info】:
@OneToOne
@JoinColumn(name=“puuid【自己的數(shù)據(jù)庫(kù)外鍵列名】")
private ProductModel product;
XML的配置
1【tbl_parent】:
???????
???????
class=“cn.javass.model.d.ChildModel【對(duì)方的Java類名】"/>
???????
???????
???????
注解的配置
- 1【tbl_parent】: ??
- @OneToMany(mappedBy="parent【對(duì)方的Java類屬性名?】") ??
- private?Set?children?=?new?HashSet(); ??
- 多【tbl_child】: ??
- @ManyToOne??
- @JoinTable( ??
- name=“tbl_parent_child【聯(lián)接表】", ??
- joinColumns=@JoinColumn(name="cuuid【聯(lián)接表里代表自己的數(shù)據(jù)庫(kù)字段名】"), ??
- inverseJoinColumns=@JoinColumn(name="puuid【聯(lián)接表里代表對(duì)方的數(shù)據(jù)庫(kù)字段名】") ??
- ) ??
- private?ParentModel?parent;??
XML的配置
1【tbl_product】:
???????
???????
?
注解的配置
1【tbl_product】:
@ManyToOne
@JoinTable(
name=" tbl_product_relation 【聯(lián)接表】",
joinColumns=@JoinColumn(name="suuid【聯(lián)接表里代表自己的列名】"),
inverseJoinColumns=@JoinColumn(name="cuuid【聯(lián)接表里代表對(duì)方的列名】",unique=true【寫死】)
)
private CourseModel course;
?
[From:?http://sishuok.com/forum/blogPost/insert.html]?
錯(cuò)誤一
錯(cuò)誤信息:javax.persistence.Table.indexes([Ljavax/persistence/Index
原因:Hibernate4.3不支持@table(name="tablename")
解決方案:使用@entity(name="tablename")代替@table(name="tablename")
錯(cuò)誤二
錯(cuò)誤信息:javax.persistence.JoinColumn.foreignKey()Ljavax/persistence/ForeignKey
原因:Hibernate4.3在多對(duì)一映射的時(shí)候不能使用@JoinColumn
解決方案:只寫@ManyToOne
錯(cuò)誤三
錯(cuò)誤信息:javax.persistence.OneToMany.orphanRemoval()Z
原因:javaee、ejb或junit的jar包與hibernate-jpa-2.0-api-1.0.0.Final.jar沖突
解決方案:查看是否存在以上jar包,如果存在,去掉即可
?
創(chuàng)作挑戰(zhàn)賽新人創(chuàng)作獎(jiǎng)勵(lì)來(lái)咯,堅(jiān)持創(chuàng)作打卡瓜分現(xiàn)金大獎(jiǎng)總結(jié)
以上是生活随笔為你收集整理的Hibernate4 注解方法说明的全部?jī)?nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: trietree的一个小练习
- 下一篇: grep命令 解说