如何使用BindingResult自定義錯誤信息

本篇內容介紹了“如何使用BindingResult自定義錯誤信息”的有關知識，在實際案例的操作過程中，不少人都會遇到這樣的困境，接下來就讓小編帶領大家學習一下如何處理這些情況吧！希望大家仔細閱讀，能夠學有所成！

目錄

• BindingResult 自定義錯誤信息

• 前提概要

• 基礎框架

• 配置文件和Java代碼的修改

• 在Controller方法中指定需要進行校驗

• 進行自定義校驗

• 在JSP頁面上顯示校驗錯誤信息

• BindingResult錯誤返回顯示失敗

BindingResult 自定義錯誤信息

前提概要

在Spring MVC和FreeMarker整合的項目中，采用JSR-303驗證框架，通過注解的方式進行數據驗證

基礎框架

MVC：Spring MVC 3

視圖：FreeMarker

驗證：Hibernate-validator實現

配置文件和Java代碼的修改

在Spring MVC配置文件中添加配置

添加以下mvc的注解驅動配置，一切變成“自動化”

<mvc:annotation-driven />

在JavaBean中添加數據校驗的注解

其中@Length、@email就是Hibernate-validator中的數據校驗注解，還可以用javax.validation中的注解，比如@NotNull

public class SystemUser {  
    @Length(min = 5, max = 20, message = "用戶名長度必須位于5到20之間")  
    private String userName;   
    @Email(message = "比如輸入正確的郵箱")  
    private String email;  
}

在Controller方法中指定需要進行校驗

首先，要在需要進行校驗的Bean前面加上@Valid注解，告訴SpringMVC框架這個Bean需要進行校驗；

同時，還要在需要校驗的Bean前面加上@modelattribute注解，從而將Bean暴露給視圖，并且指定名字，這有兩個作用，第一是顯示校驗錯誤需要使用這個名字，第二個是返回原來的頁面以后，前面輸入的所有值還要顯示出來；

其次，每個需要校驗的Bean后面緊跟一個BindingResult，SpringMVC框架會將校驗結果保存在它里面，通過hasErrors方法可以判斷是否有校驗錯誤；

最后，當返回到原頁面以后，SpringMVC框架還會將所有校驗錯誤信息保存在上下文中，供頁面上取得校驗錯誤，Spring提供了一套JSP自定義標簽。

@RequestMapping(value = "/create.html", method = RequestMethod.POST)  
public String doCreateUser(  
        @Valid @ModelAttribute("userDetail") SystemUser user,  
        BindingResult bindingResult,  
        HttpServletRequest request) {  
    // 如果有校驗錯誤，返回添加用戶的頁面  
    if (bindingResult.hasErrors()) {  
        return "/user/create";  
    }        
    this.userService.createUser(user);  
    return "/user/list.html";  
}

進行自定義校驗

如果需要添加自定義校驗，比如驗證用戶名是否已經被使用了，那么簡單的注解自然無能為力，需要自己編碼實現，如果校驗失敗，可以手動將自定義校驗錯誤添加到BindingResult中。

@RequestMapping(value = "/user/create.html", method = RequestMethod.POST)  
public String doCreateUser(  
        @Valid @ModelAttribute("userDetail") SystemUser user,  
        BindingResult bindingResult,  
        HttpServletRequest request) {  
    // 如果有數據校驗錯誤，返回添加用戶的頁面  
    if (bindingResult.hasErrors()) {  
        return "/user/create";  
    }    
    boolean isUserNameExist = this.userService.checkUserByUserName(user.getUserName());  
    // 如果用戶名已存在，返回添加用戶的頁面  
    if (isUserNameExist) {  
        // 向BindingResult添加用戶已存在的校驗錯誤  
        bindingResult.rejectValue("userName", "該用戶名已存在", "該用戶名已存在");  
        return "/user/create";  
    }        
    this.userService.createUser(user);  
    return "/user/list.html";  
}

在JSP頁面上顯示校驗錯誤信息

返回頁面以后，SpringMVC框架將所有校驗錯誤信息都放在了上下文中，可以自己去取出來，但是那樣非常麻煩，不過沒關系，Spring提供了一套自定義標簽，可以方便的顯示校驗錯誤信息。

頁面頭部需要導入Spring的自定義標簽庫

<%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %>

需要一次性顯示全部校驗錯誤

（commandName的值就是@modelattribute注解中指定的值）

<form:form commandName="userDetail"> 
<form:errors path="*" cssStyle="color:red"></form:errors> 
</form:form>

需要在對應輸入框的后面顯示單個校驗錯誤

（通過path指定顯示那個具體的校驗錯誤，userDetail正是@modelattribute注解中指定的值，而點號后面則是指定顯示Bean中哪個屬性的校驗錯誤）

<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錯誤返回顯示失敗

作為一個初學者經常犯低級錯誤，特別是沒有老師的情況下。絆了一整天，不過找到原因了

如果redirect跳轉回造成參數丟失

此時可以設置返回參數為Object

@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");
}

“如何使用BindingResult自定義錯誤信息”的內容就介紹到這里了，感謝大家的閱讀。如果想了解更多行業相關的知識可以關注億速云網站，小編將為大家輸出更多高質量的實用文章！