配置依賴
<!-- https://mvnrepository.com/artifact/javax.persistence/persistence-api -->
<dependency>
<groupId>javax.persistence</groupId>
<artifactId>persistence-api</artifactId>
<version>1.0</version>
</dependency>
JAP作用
常用注解
@Table
@Table(name="",catalog="",schema="")
只能標(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("")
.
@Id
必須
@Id定義了映射到數(shù)據(jù)庫(kù)表的主鍵的屬性,一個(gè)實(shí)體只能有一個(gè)屬性被映射為主鍵.標(biāo)注在屬性或者getter
方法前
@GeneratedValue
@GeneratedValue(strategy=GenerationType, generator="")
strategy
:表示主鍵生成策略,有AUTO,INDENTITY,SEQUENCE 和 TABLE 4種,分別表示讓ORM框架自動(dòng)選擇,
根據(jù)數(shù)據(jù)庫(kù)的Identity字段生成,根據(jù)數(shù)據(jù)庫(kù)表的Sequence字段生成,以有根據(jù)一個(gè)額外的表生成主鍵,默認(rèn)為AUTO
generator
:表示主鍵生成器的名稱,這個(gè)屬性通常和ORM框架相關(guān),例如,Hibernate可以指定uuid等主鍵生成方式.
示例:
@Id
@GeneratedValues(strategy=StrategyType.SEQUENCE, generator = "IDENTITY")
public int getPk() {
return pk;
}
@Column
@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類型的字段有效
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
@Transient表示該屬性并非一個(gè)到數(shù)據(jù)庫(kù)表的字段的映射,ORM框架將忽略該屬性.
如果一個(gè)屬性并非數(shù)據(jù)庫(kù)表的字段映射,就務(wù)必將其標(biāo)示為@Transient,否則,ORM框架默認(rèn)其注解為@Basic.
@ManyToOne
@ManyToOne(fetch=FetchType,cascade=CascadeType)
@ManyToOne表示一個(gè)多對(duì)一的映射,該注解標(biāo)注的屬性通常是數(shù)據(jù)庫(kù)表的外鍵
optional:是否允許該字段為null,該屬性應(yīng)該根據(jù)數(shù)據(jù)庫(kù)表的外鍵約束來(lái)確定,默認(rèn)為true
fetch:表示抓取策略,默認(rèn)為FetchType.EAGER
cascade:表示默認(rèn)的級(jí)聯(lián)操作策略,可以指定為ALL,PERSIST,MERGE,REFRESH和REMOVE中的若干組合,默認(rèn)為無(wú)級(jí)聯(lián)操作
targetEntity:表示該屬性關(guān)聯(lián)的實(shí)體類型.該屬性通常不必指定,ORM框架根據(jù)屬性類型自動(dòng)判斷targetEntity.
示例:
//訂單Order和用戶User是一個(gè)ManyToOne的關(guān)系
//在Order類中定義
@ManyToOne()
@JoinColumn(name=”USER”)
public User getUser() {
return user;
}
@JoinColumn
@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的主鍵名稱
示例:
見(jiàn)@ManyToOne
@OneToMany
@OneToMany(fetch=FetchType,cascade=CascadeType)
@OneToMany描述一個(gè)一對(duì)多的關(guān)聯(lián),該屬性應(yīng)該為集體類型,在數(shù)據(jù)庫(kù)中并沒(méi)有實(shí)際字段.
fetch:表示抓取策略,默認(rèn)為FetchType.LAZY,因?yàn)殛P(guān)聯(lián)的多個(gè)對(duì)象通常不必從數(shù)據(jù)庫(kù)預(yù)先讀取到內(nèi)存
cascade:表示級(jí)聯(lián)操作策略,對(duì)于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)該被全部刪除
示例:
@OneTyMany(cascade=ALL)
public List getOrders() {
return orders;
}
@OneToOne
@OneToOne(fetch=FetchType,cascade=CascadeType)
@OneToOne描述一個(gè)一對(duì)一的關(guān)聯(lián)
fetch:表示抓取策略,默認(rèn)為FetchType.LAZY
cascade:表示級(jí)聯(lián)操作策略
示例:
@OneToOne(fetch=FetchType.LAZY)
public Blog getBlog() {
return blog;
}
@ManyToMany
@ManyToMany 描述一個(gè)多對(duì)多的關(guān)聯(lián).多對(duì)多關(guān)聯(lián)上是兩個(gè)一對(duì)多關(guān)聯(lián),但是在ManyToMany描述中,中間表是由ORM框架自動(dòng)處理
targetEntity:表示多對(duì)多關(guān)聯(lián)的另一個(gè)實(shí)體類的全名,例如:package.Book.class
mappedBy:表示多對(duì)多關(guān)聯(lián)的另一個(gè)實(shí)體類的對(duì)應(yīng)集合屬性名稱
示例:
User實(shí)體表示用戶,Book實(shí)體表示書籍,為了描述用戶收藏的書籍,可以在User和Book之間建立ManyToMany關(guān)聯(lián)
@Entity
public class User {
private List books;
@ManyToMany(targetEntity=package.Book.class)
public List getBooks() {
return books;
}
public void setBooks(List books) {
this.books=books;
}
}
@Entity
public class Book {
private List users;
@ManyToMany(targetEntity=package.Users.class, mappedBy=”books”)
public List getUsers() {
return users;
}
public void setUsers(List users) {
this.users=users;
}
}
兩個(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)多對(duì)多關(guān)聯(lián)
@MappedSuperclass
@MappedSuperclass可以將超類的JPA注解傳遞給子類,使子類能夠繼承超類的JPA注解
示例:
@MappedSuperclass
public class Employee() {
}
@Entity
public class Engineer extends Employee {
}
@Entity
public class Manager extends Employee {
}
@Embedded
@Embedded將幾個(gè)字段組合成一個(gè)類,并作為整個(gè)Entity的一個(gè)屬性.
例如User包括id,name,city,street,zip屬性.
我們希望city,street,zip屬性映射為Address對(duì)象.這樣,User對(duì)象將具有id,name和address這三個(gè)屬性.
Address對(duì)象必須定義為@Embededable
示例:
@Embeddable
public class Address {city,street,zip}
@Entity
public class User {
@Embedded
public Address getAddress() {
}
}
Hibernate驗(yàn)證注解
注解 | 說(shuō)明 |
---|---|
@Null | 被注釋的元素必須為 null |
@NotNull | 被注釋的元素必須不為 null |
@AssertTrue | 被注釋的元素必須為 true |
@AssertFalse | 被注釋的元素必須為 false |
@Min(value) | 被注釋的元素必須是一個(gè)數(shù)字敏簿,其值必須大于等于指定的最小值 |
@Max(value) | 被注釋的元素必須是一個(gè)數(shù)字,其值必須小于等于指定的最大值 |
@DecimalMin(value) | 被注釋的元素必須是一個(gè)數(shù)字分扎,其值必須大于等于指定的最小值 |
@DecimalMax(value) | 被注釋的元素必須是一個(gè)數(shù)字葛虐,其值必須小于等于指定的最大值 |
@Size(max=, min=) | 被注釋的元素的大小必須在指定的范圍內(nèi) |
@Digits (integer, fraction) | 被注釋的元素必須是一個(gè)數(shù)字骗卜,其值必須在可接受的范圍內(nèi) |
@Past | 被注釋的元素必須是一個(gè)過(guò)去的日期 |
@Future | 被注釋的元素必須是一個(gè)將來(lái)的日期 |
@Pattern(regex=,flag=) | 被注釋的元素必須符合指定的正則表達(dá)式 |
Hibernate Validator 附加的 constraint | |
@NotBlank(message =) | 驗(yàn)證字符串非null,且長(zhǎng)度必須大于0 |
被注釋的元素必須是電子郵箱地址 | |
@Length(min=,max=) | 被注釋的字符串的大小必須在指定的范圍內(nèi) |
@NotEmpty | 被注釋的字符串的必須非空 |
@Range(min=,max=,message=) | 被注釋的元素必須在合適的范圍內(nèi) |
SpringMVC中如何使用 Hibernate驗(yàn)證注解
配置
<mvc:annotation-driven validator="validator" />
<bean id="validator" class="org.springframework.validation.beanvalidation.LocalValidatorFactoryBean">
<property name="providerClass" value="org.hibernate.validator.HibernateValidator"/>
<!--不設(shè)置則默認(rèn)為classpath下的ValidationMessages.properties -->
<property name="validationMessageSource" ref="validatemessageSource"/>
</bean>
<bean id="validatemessageSource" class="org.springframework.context.support.ReloadableResourceBundleMessageSource">
<property name="basename" value="classpath:validatemessages"/>
<property name="fileEncodings" value="utf-8"/>
<property name="cacheSeconds" value="120"/>
</bean>
使用validator
import org.hibernate.validator.constraints.NotEmpty;
import org.hibernate.validator.constraints.Range;
public class Customer {
@NotEmpty //make sure name is not empty
String name;
@Range(min = 1, max = 150) //age need between 1 and 150
int age;
//getter and setter methods
}
Controller中如何驗(yàn)證.
package com.mkyong.common.controller;
import javax.validation.Valid;
import org.springframework.stereotype.Controller;
import org.springframework.ui.ModelMap;
import org.springframework.validation.BindingResult;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import com.mkyong.common.model.Customer;
@Controller
@RequestMapping("/customer")
public class SignUpController {
@RequestMapping(value = "/signup", method = RequestMethod.POST)
public String addCustomer(@Valid Customer customer, BindingResult result) {
if (result.hasErrors()) {
return "SignUpForm";
} else {
return "Done";
}
}
@RequestMapping(method = RequestMethod.GET)
public String displayCustomerForm(ModelMap model) {
model.addAttribute("customer", new Customer());
return "SignUpForm";
}
}