您好,登錄后才能下訂單哦!
一、 spring-boot-starter-validation 依賴概述
上一篇 《Spring Boot Web 開發注解篇》,就可以快速地進行 Web 開發。那么在表單提交的時候,我們需要進行驗證。前端驗證可以擋住 99% 的小白用戶,這里要實現服務端驗證。
Starters 機制告訴我們,只要加入 spring-boot-starter-validation 這個 Starter ,就可以使用其實現驗證。那什么是 spring-boot-starter-validation?
spring-boot-starter-validation 就是使用 Hibernate Validator 框架來提供 Java Bean 驗證功能。
1.1 spring-boot-starter-validation 職責
spring-boot-starter-validation 是一個用于驗證的 Starter,主要完成的是 Java Bean 的驗證功能。
1.2 spring-boot-starter-validation 依賴關系
spring-boot-starter-validation 依賴的組成如下表:
可見,tomcat 容器是 8.x 版本。這里有個小問題了,為啥 spring-boot-starter-web 也有這些上面這些依賴呢?這樣如果開發 web 就不需要重復添加 spring-boot-starter-validation 依賴了。但如果沒用 web 依賴時候想要實現 Bean 驗證,則只要單單加入 spring-boot-starter-validation 依賴即可。
二、 運行 chapter-4-spring-boot-validating-form-input 表單驗證工程
1. git clone 下載工程 spring-boot-core-book-demo
項目地址見 GitHub – https://github.com/JeffLi1993/spring-boot-core-book-demo:
git clone https://github.com/JeffLi1993/spring-boot-core-book-demo.git
2. Maven 編譯安裝這個工程:
cd spring-boot-core-book-demo mvn clean install
3. 運行 chapter-4-spring-boot-validating-form-input 工程
右鍵項目 ValidatingFormInputApplication 類運行即可:
2017-08-09 16:24:58.387 INFO 12193 — [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat started on port(s): 8080 (http) 2017-08-09 16:24:58.395 INFO 12193 — [ main] s.b.core.ValidatingFormInputApplication : Started ValidatingFormInputApplication in 9.846 seconds (JVM running for 11.23)
訪問 http://localhost:8080/users 用戶列表頁面:
點擊創建用戶按鈕,打開用戶管理頁面:
輸入非法值提示:
三、 詳解 spring-boot-validating-form-input
1.pom.xml 如下:
validator 驗證依賴主要在 web 依賴中,web 依賴包含了 hibernate-validator 依賴
還有以下依賴:
單元測試依賴
Spring Data JPA 依賴 :: 數據持久層框架
h3 數據源連接驅動
模板引擎 Thymeleaf 依賴
2.實體類
具體業務層邏輯這邊不解釋,主要還是在控制層和 View 如何展示表單驗證
實體類 User 如下:
@Entity public class User implements Serializable { /** * 編號 */ @Id @GeneratedValue private Long id; /** * 名稱 */ @NotEmpty(message = “姓名不能為空”) @Size(min = 2, max = 8, message = “姓名長度必須大于 2 且小于 20 字”) private String name; /** * 年齡 */ @NotNull(message = “年齡不能為空”) @Min(value = 0, message = “年齡大于 0”) @Max(value = 300, message = “年齡不大于 300”) private Integer age; /** * 出生時間 */ @NotEmpty(message = “出生時間不能為空”) private String birthday; public Long getId() { return id; } public void setId(Long id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public Integer getAge() { return age; } public void setAge(Integer age) { this.age = age; } public String getBirthday() { return birthday; } public void setBirthday(String birthday) { this.birthday = birthday; } @Override public String toString() { return “User{” + “id=” + id + “, name='” + name + ‘\” + “, age=” + age + “, birthday=” + birthday + ‘}'; } } @Entity @Id @GeneratedValue
以上注解是 JPA 框架提供的,實體類和表建立映射關系的。
Bean Validation 規范,運行時的數據驗證框架。它是 JSR 303 規范,Hibernate Validator 實現了這套規范,并擴展了一些注解,如下:
@Null 被注釋的元素必須為 null
@NotNull 被注釋的元素必須不為 null
@Min(value) 被注釋的元素必須是一個數字,其值必須大于等于指定的最小值
@Max(value) 被注釋的元素必須是一個數字,其值必須小于等于指定的最大值
@Size(max, min) 被注釋的元素的大小必須在指定的范圍內
@Email 被注釋的元素必須是電子郵箱地址
@Length 被注釋的字符串的大小必須在指定的范圍內
@NotEmpty 被注釋的字符串的必須非空
@Range 被注釋的元素必須在合適的范圍內
3.控制層 UserController
UserController 控制層代碼如下:
/** * 創建用戶 * 處理 “/users” 的 POST 請求,用來獲取用戶列表 * 通過 @ModelAttribute 綁定參數,也通過 @RequestParam 從頁面中傳遞參數 */ @RequestMapping(value = “/create”, method = RequestMethod.POST) public String postUser(ModelMap map, @ModelAttribute @Valid User user, BindingResult bindingResult) { if (bindingResult.hasErrors()) { map.addAttribute(“action”, “create”); return “userForm”; } userService.insertByUser(user); return “redirect:/users/”; } /** * 處理 “/users/{id}” 的 PUT 請求,用來更新 User 信息 * */ @RequestMapping(value = “/update”, method = RequestMethod.POST) public String putUser(ModelMap map, @ModelAttribute @Valid User user, BindingResult bindingResult) { if (bindingResult.hasErrors()) { map.addAttribute(“action”, “update”); return “userForm”; } userService.update(user); return “redirect:/users/”; }
在新增和更新用戶時,我們會對表單進行驗證,那么首先用 @Valid 注解到實體類,使實體類 User 中驗證注解生效,然后我們介紹下 BindingResult ,是數據綁定的結果對象,從源碼中可以看出,其繼承了 Errors 接口,所以所有的錯誤信息都會被綁定到這個對象。通過 hasErrors() 方法判斷是否有錯誤信息,如果有返回原頁面,并展示錯誤信息。
總結
以上所述是小編給大家介紹的Spring Boot 表單驗證篇,希望對大家有所幫助,如果大家有任何疑問請給我留言,小編會及時回復大家的。在此也非常感謝大家對億速云網站的支持!
免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。