?

前些天發現了一個巨牛的人工智能學習網站，通俗易懂，風趣幽默，忍不住分享一下給大家。點擊跳轉到教程。

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;

????}
從表：無

?

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的集合屬性名稱。

[From:blog_935ebb670101dnre.html]

?

@Entity，注冊在類頭上，將一個類聲明為一個實體bean(即一個持久化POJO類) 。 @Table，注冊在類頭上，注解聲明了該實體bean映射指定的表（table）。 @Id用來注冊主屬性，@GeneratedValue用來注冊主屬性的生成策略，@Column用來注冊屬性，@Version用來注冊樂觀鎖，@Transient用來注冊不是屬性。 以上的@Id、@GeneratedValue、 @Column 、 @Version，可以用來注冊屬性，既可以寫在Java類的屬性上，也可以注冊在屬性對應的getter上。 @Transient注冊在多余的屬性或多余的getter上，但是必須與以上的@Column等對應。 @Column 標識屬性對應的字段，示例：@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 可選,列名(默認值是屬性名) (2) unique 可選,是否在該列上設置唯一約束(默認值false) (3) nullable 可選,是否設置該列的值可以為空(默認值false) (4) insertable 可選,該列是否作為生成的insert語句中的一個列(默認值true) (5) updatable 可選,該列是否作為生成的update語句中的一個列(默認值true) (6) columnDefinition 可選: 為這個特定列覆蓋SQL DDL片段 (這可能導致無法在不同數據庫間移植) (7) table 可選,定義對應的表(默認為主表) (8) length 可選,列長度(默認值255) (8) precision 可選,列十進制精度(decimal precision)(默認值0) (10) scale 可選,如果列十進制數值范圍(decimal scale)可用,在此設置(默認值0) @Id，標識這個屬性是實體類的唯一識別的值。 注意：這個注解只能標注單一列構成的主鍵，如tbl_grade那種有兩個字段組成的聯合主鍵由其他注解標識。 回憶*.hbm.xml： "uuid"> "assigned"/> @Id，只是標識這個屬性是主鍵，但是并沒有指出其生成策略，如上例中的assigned就是由程序員指定的生成策略。 如果僅僅寫出@Id，即是使用assigned生成略，如： @Id
@Column
private int uuid;
如果想使用Oracle支持的sequence取主鍵，必須通過@GeneratedValue來指定生成策略，而由@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 標識這個屬性用來映射樂觀鎖的version @Transient 標識這個屬性不用持久化 @Embeddable【小對象的頭上】 標識實體中可以定義一個嵌入式組件(embedded component)。組件類必須在類一級定義@Embeddable注解。 @Embedded【大對象的屬性頭上】 引用定義的小對象。 @Embeddable【小對象的頭上】 標識實體中可以定義一個嵌入式組件(embedded component)。組件類必須在類一級定義@Embeddable注解。 注意：如果這個小對象作為復合主鍵，一定要實現Serializable接口。這并不是注解決定的，而是Hibernate的主鍵都需要實現Serializable接口。 @EmbeddedId 【大對象的屬性頭上】 引用定義的小對象作為主鍵。 注意：不需要再使用@Id注解。 標準的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【寫死，使用外來策略】”,parameters=@Parameter(name=“property”,value=“product【引用自己的Java屬性】"))
private int uuid;
@OneToOne(mappedBy=“info【引用對方的Java屬性】")
private ProductModel product;
? 標準的1:M XML的配置 1【tbl_parent】：
?
???????
???????
?
多【tbl_child】： 注解的配置 1【tbl_parent】：
@OneToMany
@JoinColumn(name="puuid【對方的數據庫外鍵列名】")
private Set children = new HashSet();
多【tbl_child】：
@ManyToOne
@JoinColumn(name="puuid【自己的數據庫外鍵列名】")
private ParentModel parent;
?
?

主1【tbl_product】： ??

"?cascade="all"/> ??

從1【tbl_product_info】： ??

true【寫死】"/>??

注解的配置

主1【tbl_product】：
@OneToOne(cascade=CascadeType.ALL,mappedBy=“product【對方的Java類屬性名】")
private ProductInfoModel info;
從1【tbl_product_info】：
@OneToOne
@JoinColumn(name=“puuid【自己的數據庫外鍵列名】")
private ProductModel product;

XML的配置

1【tbl_parent】：

???????
???????
class=“cn.javass.model.d.ChildModel【對方的Java類名】"/>
???????

???????
???????

注解的配置

• 1【tbl_parent】： ??
• @OneToMany(mappedBy="parent【對方的Java類屬性名?】") ??
• private?Set?children?=?new?HashSet(); ??
• 多【tbl_child】： ??
• @ManyToOne??
• @JoinTable( ??
• name=“tbl_parent_child【聯接表】", ??
• joinColumns=@JoinColumn(name="cuuid【聯接表里代表自己的數據庫字段名】"), ??
• inverseJoinColumns=@JoinColumn(name="puuid【聯接表里代表對方的數據庫字段名】") ??
• ) ??
• private?ParentModel?parent;??

XML的配置

1【tbl_product】：

???????
???????
?

注解的配置

1【tbl_product】：
@ManyToOne
@JoinTable(
name=" tbl_product_relation 【聯接表】",
joinColumns=@JoinColumn(name="suuid【聯接表里代表自己的列名】"),
inverseJoinColumns=@JoinColumn(name="cuuid【聯接表里代表對方的列名】",unique=true【寫死】)
)
private CourseModel course;

?

[From:?http://sishuok.com/forum/blogPost/insert.html]

?

錯誤一
錯誤信息：javax.persistence.Table.indexes([Ljavax/persistence/Index
原因：Hibernate4.3不支持@table(name="tablename")
解決方案：使用@entity(name="tablename")代替@table(name="tablename")

錯誤二
錯誤信息：javax.persistence.JoinColumn.foreignKey()Ljavax/persistence/ForeignKey
原因：Hibernate4.3在多對一映射的時候不能使用@JoinColumn
解決方案：只寫@ManyToOne

錯誤三
錯誤信息：javax.persistence.OneToMany.orphanRemoval()Z
原因：javaee、ejb或junit的jar包與hibernate-jpa-2.0-api-1.0.0.Final.jar沖突
解決方案：查看是否存在以上jar包，如果存在，去掉即可

?

創作挑戰賽新人創作獎勵來咯，堅持創作打卡瓜分現金大獎

總結

以上是生活随笔為你收集整理的Hibernate4 注解方法说明的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。