BindingResult 自定義錯(cuò)誤信息
前提概要
在Spring MVC和FreeMarker整合的項(xiàng)目中,采用JSR-303驗(yàn)證框架,通過(guò)注解的方式進(jìn)行數(shù)據(jù)驗(yàn)證
基礎(chǔ)框架
- MVC:Spring MVC 3
- 視圖:FreeMarker
- 驗(yàn)證:Hibernate-validator實(shí)現(xiàn)
配置文件和Java代碼的修改
在Spring MVC配置文件中添加配置
添加以下mvc的注解驅(qū)動(dòng)配置,一切變成“自動(dòng)化”
1
|
< mvc:annotation-driven /> |
在JavaBean中添加數(shù)據(jù)校驗(yàn)的注解
其中@Length、@email就是Hibernate-validator中的數(shù)據(jù)校驗(yàn)注解,還可以用javax.validation中的注解,比如@NotNull
1
2
3
4
5
6
|
public class SystemUser { @Length (min = 5 , max = 20 , message = "用戶名長(zhǎng)度必須位于5到20之間" ) private String userName; @Email (message = "比如輸入正確的郵箱" ) private String email; } |
在Controller方法中指定需要進(jìn)行校驗(yàn)
首先,要在需要進(jìn)行校驗(yàn)的Bean前面加上@Valid注解,告訴SpringMVC框架這個(gè)Bean需要進(jìn)行校驗(yàn);
同時(shí),還要在需要校驗(yàn)的Bean前面加上@modelattribute注解,從而將Bean暴露給視圖,并且指定名字,這有兩個(gè)作用,第一是顯示校驗(yàn)錯(cuò)誤需要使用這個(gè)名字,第二個(gè)是返回原來(lái)的頁(yè)面以后,前面輸入的所有值還要顯示出來(lái);
其次,每個(gè)需要校驗(yàn)的Bean后面緊跟一個(gè)BindingResult,SpringMVC框架會(huì)將校驗(yàn)結(jié)果保存在它里面,通過(guò)hasErrors方法可以判斷是否有校驗(yàn)錯(cuò)誤;
最后,當(dāng)返回到原頁(yè)面以后,SpringMVC框架還會(huì)將所有校驗(yàn)錯(cuò)誤信息保存在上下文中,供頁(yè)面上取得校驗(yàn)錯(cuò)誤,Spring提供了一套JSP自定義標(biāo)簽。
1
2
3
4
5
6
7
8
9
10
11
12
|
@RequestMapping (value = "/create.html" , method = RequestMethod.POST) public String doCreateUser( @Valid @ModelAttribute ( "userDetail" ) SystemUser user, BindingResult bindingResult, HttpServletRequest request) { // 如果有校驗(yàn)錯(cuò)誤,返回添加用戶的頁(yè)面 if (bindingResult.hasErrors()) { return "/user/create" ; } this .userService.createUser(user); return "/user/list.html" ; } |
進(jìn)行自定義校驗(yàn)
如果需要添加自定義校驗(yàn),比如驗(yàn)證用戶名是否已經(jīng)被使用了,那么簡(jiǎn)單的注解自然無(wú)能為力,需要自己編碼實(shí)現(xiàn),如果校驗(yàn)失敗,可以手動(dòng)將自定義校驗(yàn)錯(cuò)誤添加到BindingResult中。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
@RequestMapping (value = "/user/create.html" , method = RequestMethod.POST) public String doCreateUser( @Valid @ModelAttribute ( "userDetail" ) SystemUser user, BindingResult bindingResult, HttpServletRequest request) { // 如果有數(shù)據(jù)校驗(yàn)錯(cuò)誤,返回添加用戶的頁(yè)面 if (bindingResult.hasErrors()) { return "/user/create" ; } boolean isUserNameExist = this .userService.checkUserByUserName(user.getUserName()); // 如果用戶名已存在,返回添加用戶的頁(yè)面 if (isUserNameExist) { // 向BindingResult添加用戶已存在的校驗(yàn)錯(cuò)誤 bindingResult.rejectValue( "userName" , "該用戶名已存在" , "該用戶名已存在" ); return "/user/create" ; } this .userService.createUser(user); return "/user/list.html" ; } |
在JSP頁(yè)面上顯示校驗(yàn)錯(cuò)誤信息
返回頁(yè)面以后,SpringMVC框架將所有校驗(yàn)錯(cuò)誤信息都放在了上下文中,可以自己去取出來(lái),但是那樣非常麻煩,不過(guò)沒(méi)關(guān)系,Spring提供了一套自定義標(biāo)簽,可以方便的顯示校驗(yàn)錯(cuò)誤信息。
頁(yè)面頭部需要導(dǎo)入Spring的自定義標(biāo)簽庫(kù)
1
|
<%@ taglib prefix= "form" uri= "http://www.springframework.org/tags/form" %> |
需要一次性顯示全部校驗(yàn)錯(cuò)誤
(commandName的值就是@modelattribute注解中指定的值)
1
2
3
|
<form:form commandName= "userDetail" > <form:errors path= "*" cssStyle= "color:red" ></form:errors> </form:form> |
需要在對(duì)應(yīng)輸入框的后面顯示單個(gè)校驗(yàn)錯(cuò)誤
(通過(guò)path指定顯示那個(gè)具體的校驗(yàn)錯(cuò)誤,userDetail正是@modelattribute注解中指定的值,而點(diǎn)號(hào)后面則是指定顯示Bean中哪個(gè)屬性的校驗(yàn)錯(cuò)誤)
1
2
3
4
|
<input type= "text" name= "userName" value= "${userDetail.userName}" > <form:errors path= "userDetail.userName" cssStyle= "color:red" ></form:errors> <input type= "text" name= "email" value= "${userDetail.email}" > <form:errors path= "userDetail.email" cssStyle= "color:red" ></form:errors> |
BindingResult錯(cuò)誤返回顯示失敗
作為一個(gè)初學(xué)者經(jīng)常犯低級(jí)錯(cuò)誤,特別是沒(méi)有老師的情況下。絆了一整天,不過(guò)找到原因了
如果redirect跳轉(zhuǎn)回造成參數(shù)丟失
此時(shí)可以設(shè)置返回參數(shù)為Object
1
2
3
4
5
6
7
8
9
|
@RequestMapping (value = "/save" , method = RequestMethod.POST) public Object test(HttpServletRequest request, Model model, @Validated User user, BindingResult bindingResult) throws Exception { if (bindingResult.hasErrors()) { return "user/save" ; } user.setVersion( 0 ); return new ModelAndView( "redirect:/user/list" ); } |
以上為個(gè)人經(jīng)驗(yàn),希望能給大家一個(gè)參考,也希望大家多多支持服務(wù)器之家。
原文鏈接:https://blog.csdn.net/zhengun/article/details/84918567