JPA Annotation注解
JPA & Hibernate 注解
先說說JPA和Hibernate的關(guān)系
JPA（Java Persistence API），是Java EE 5的標(biāo)準(zhǔn)ORM接口，也是ejb3規(guī)范的一部分。
Hibernate是當(dāng)今很流行的ORM框架，也是JPA的一個(gè)實(shí)現(xiàn)，其它還有Toplink之類的ROM框架。
JPA和Hibernate之間的關(guān)系，可以簡單的理解為JPA是標(biāo)準(zhǔn)接口，Hibernate是實(shí)現(xiàn)。
Hibernate主要是通過三個(gè)組件來實(shí)現(xiàn)的：
- hibernate-core：Hibernate的核心實(shí)現(xiàn)，提供了Hibernate所有的核心功能。
- hibernate-entitymanager：Hibernate實(shí)現(xiàn)了標(biāo)準(zhǔn)的JPA，可以把它看成hibernate-core和JPA之間的適配器，它并不直接提供ORM的功能，而是對hibernate-core進(jìn)行封裝，使得Hibernate符合JPA的規(guī)范。
- hibernate-annotation：Hibernate支持annotation方式配置的基礎(chǔ)，它包括了標(biāo)準(zhǔn)的JPA annotation以及Hibernate自身特殊功能的annotation。
注解詳細(xì)如下：
| 1 | @Entity(name="EntityName") |
必須，name為可選，對應(yīng)數(shù)據(jù)庫中一的個(gè)表
| 1 | @Table(name="",catalog="",schema="") |
可選，通常和 @Entity 配合使用，只能標(biāo)注在實(shí)體的class定義處,表示實(shí)體對應(yīng)的數(shù)據(jù)庫表的信息。
name：可選，表示表的名稱。默認(rèn)，表名和實(shí)體名稱一致，只有在不一致的情況下才需要指定表名。
catalog：可選，表示Catalog名稱，默認(rèn)為Catalog(“”)。
schema：可選，表示Schema名稱，默認(rèn)為Schema(“”)。
?
@id
@id定義了映射到數(shù)據(jù)庫表的主鍵的屬性，一個(gè)實(shí)體只能有一個(gè)屬性被映射為主鍵。
@GeneratedValue(strategy=GenerationType,generator=””)
可選
strategy：表示主鍵生成策略，有AUTO，INDENTITY，SEQUENCE 和 TABLE 4種，分別表示讓ORM框架自動(dòng)選擇，根據(jù)數(shù)據(jù)庫的 Identity 字段生成，根據(jù)數(shù)據(jù)庫表的 Sequence 字段生成，以有根據(jù)一個(gè)額外的表生成主鍵，默認(rèn)為 AUTO。
generator:表示主鍵生成器的名稱，這個(gè)屬性通常和ORM框架相關(guān)，例如，Hibernate可以指定uuid等主鍵生成方式.
@Basic(fetch=FetchType,optional=true)
可選
@Basic表示一個(gè)簡單的屬性到數(shù)據(jù)庫表的字段的映射，對于沒有任何標(biāo)注的getXxxx()方法，默認(rèn)即為@Basic
fetch：表示該屬性的讀取策略，有EAGER和LAZY兩種，分別表示主支抓取和延遲加載，默認(rèn)為EAGER。
optional：表示該屬性是否允許為null，默認(rèn)為true。
@Column
可選
@Column描述了數(shù)據(jù)庫表中該字段的詳細(xì)定義，這對于根據(jù)JPA注解生成數(shù)據(jù)庫表結(jié)構(gòu)的工具非常有作用。
name：表示數(shù)據(jù)庫表中該字段的名稱，默認(rèn)情形屬性名稱一致。
nullable：表示該字段是否允許為null，默認(rèn)為true。
unique：表示該字段是否是唯一標(biāo)識，默認(rèn)為false。
length：表示該字段的大小，僅對String類型的字段有效。
insertable：表示在ORM框架執(zhí)行插入操作時(shí)，該字段是否應(yīng)出現(xiàn)INSETRT語句中，默認(rèn)為true。
updateable：表示在ORM框架執(zhí)行更新操作時(shí)，該字段是否應(yīng)該出現(xiàn)在UPDATE語句中，默認(rèn)為true。對于一經(jīng)創(chuàng)建就不可以更改的字段，該屬性非常有用，如對于birthday字段。
columnDefinition：表示該字段在數(shù)據(jù)庫中的實(shí)際類型。通常ORM框架可以根據(jù)屬性類型自動(dòng)判斷數(shù)據(jù)庫中字段的類型，但是對于Date類型仍無法確定數(shù)據(jù)庫中字段類型究竟是DATE，TIME還是TIMESTAMP。此外，String的默認(rèn)映射類型為VARCHAR，如果要將String類型映射到特定數(shù)據(jù)庫的BLOB或TEXT字段類型，該屬性非常有用。
@Transient
可選
@Transient表示該屬性并非一個(gè)到數(shù)據(jù)庫表的字段的映射，ORM框架將忽略該屬性。
如果一個(gè)屬性并非數(shù)據(jù)庫表的字段映射。就務(wù)必將其標(biāo)示為@Transient。否則。ORM框架默認(rèn)其注解為@Basic
?@OneToOne(fetch=FetchType,cascade=CascadeType)
可選
@OneToOne描述一個(gè)一對一的關(guān)聯(lián)
fetch：表示抓取策略，默認(rèn)為FetchType.LAZY
cascade：表示級聯(lián)操作策略
@ManyToOne(fetch=FetchType,cascade=CascadeType)
可選
@ManyToOne表示一個(gè)多對一的映射,該注解標(biāo)注的屬性通常是數(shù)據(jù)庫表的外鍵
optional：是否允許該字段為null，該屬性應(yīng)該根據(jù)數(shù)據(jù)庫表的外鍵約束來確定，默認(rèn)為true
fetch：表示抓取策略，默認(rèn)為FetchType.EAGER
cascade：表示默認(rèn)的級聯(lián)操作策略，可以指定為ALL，PERSIST，MERGE，REFRESH和REMOVE中的若干組合，默認(rèn)為無級聯(lián)操作
targetEntity：表示該屬性關(guān)聯(lián)的實(shí)體類型。該屬性通常不必指定，ORM框架根據(jù)屬性類型自動(dòng)判斷targetEntity。
?
@OneToMany(fetch=FetchType,cascade=CascadeType)
可選
@OneToMany描述一個(gè)一對多的關(guān)聯(lián),該屬性應(yīng)該為集體類型,在數(shù)據(jù)庫中并沒有實(shí)際字段。
fetch：表示抓取策略,默認(rèn)為FetchType.LAZY,因?yàn)殛P(guān)聯(lián)的多個(gè)對象通常不必從數(shù)據(jù)庫預(yù)先讀取到內(nèi)存
cascade：表示級聯(lián)操作策略,對于OneToMany類型的關(guān)聯(lián)非常重要,通常該實(shí)體更新或刪除時(shí),其關(guān)聯(lián)的實(shí)體也應(yīng)當(dāng)被更新或刪除
例如：實(shí)體User和Order是OneToMany的關(guān)系，則實(shí)體User被刪除時(shí)，其關(guān)聯(lián)的實(shí)體Order也應(yīng)該被全部刪除
@ManyToMany
可選
@ManyToMany 描述一個(gè)多對多的關(guān)聯(lián).多對多關(guān)聯(lián)上是兩個(gè)一對多關(guān)聯(lián),但是在ManyToMany描述中,中間表是由ORM框架自動(dòng)處理
targetEntity:表示多對多關(guān)聯(lián)的另一個(gè)實(shí)體類的全名,例如:package.Book.class
mappedBy:表示多對多關(guān)聯(lián)的另一個(gè)實(shí)體類的對應(yīng)集合屬性名稱
兩個(gè)實(shí)體間相互關(guān)聯(lián)的屬性必須標(biāo)記為@ManyToMany,并相互指定targetEntity屬性,
需要注意的是,有且只有一個(gè)實(shí)體的@ManyToMany注解需要指定mappedBy屬性,指向targetEntity的集合屬性名稱
利用ORM工具自動(dòng)生成的表除了User和Book表外,還自動(dòng)生成了一個(gè)User_Book表,用于實(shí)現(xiàn)多對多關(guān)聯(lián)
@JoinColumn
可選
@JoinColumn和@Column類似,介量描述的不是一個(gè)簡單字段,而一一個(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屬性來關(guān)聯(lián)實(shí)體User,則Order的user屬性為一個(gè)外鍵,
其默認(rèn)的名稱為實(shí)體User的名稱+下劃線+實(shí)體User的主鍵名稱
@JoinTable(name = “student_teacher”, inverseJoinColumns = @JoinColumn(name = “tid”), joinColumns = @JoinColumn(name = “sid”))
可選
由第三張表來維護(hù)兩張表的關(guān)系
name：是關(guān)系表的名字
joinColumns：自己這一端的主鍵
inverseJoinColumns：對方的主鍵
?
@MappedSuperclass
可選
@MappedSuperclass可以將超類的JPA注解傳遞給子類,使子類能夠繼承超類的JPA注解
@Embedded
@Embedded將幾個(gè)字段組合成一個(gè)類,并作為整個(gè)Entity的一個(gè)屬性.
例如User包括id,name,city,street,zip屬性.
我們希望city,street,zip屬性映射為Address對象.這樣,User對象將具有id,name和address這三個(gè)屬性.
Address對象必須定義為@Embededable
驗(yàn)證注解
@Pattern
String
通過正則表達(dá)式來驗(yàn)證字符串
@Pattern(regex=”[a-z]{6}”)
@Length
String
驗(yàn)證字符串的長度
@length(min=3,max=20)
@Email
String
驗(yàn)證一個(gè)Email地址是否有效
@email
@Range
Long
驗(yàn)證一個(gè)整型是否在有效的范圍內(nèi)
@Range(min=0,max=100)
@Min
Long
驗(yàn)證一個(gè)整型必須不小于指定值
@Min(value=10)
@Max
Long
驗(yàn)證一個(gè)整型必須不大于指定值
@Max(value=20)
@Size
集合或數(shù)組
集合或數(shù)組的大小是否在指定范圍內(nèi)
@Size(min=1,max=255)
轉(zhuǎn)載于:https://www.cnblogs.com/tyhJava/p/5459737.html
總結(jié)
以上是生活随笔為你收集整理的JPA Annotation注解的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： 自连接什么时候要用
- 下一篇： 关于验证码的DEMO