詳解SpringMVC學習系列（6）之數據驗證

2019-11-26 13:25:05

字體：大中小

來源：轉載

供稿：網友

在系列（4）、（5）中我們展示了如何綁定數據，綁定完數據之后如何確保我們得到的數據的正確性？這就是我們本篇要說的內容 ―> 數據驗證。

這里我們采用Hibernate-validator來進行驗證，Hibernate-validator實現了JSR-303驗證框架支持注解風格的驗證。首先我們要到http://hibernate.org/validator/下載需要的jar包，這里以4.3.1.Final作為演示，解壓后把hibernate-validator-4.3.1.Final.jar、jboss-logging-3.1.0.jar、validation-api-1.0.0.GA.jar這三個包添加到項目中。

配置之前項目中的springservlet-config.xml文件，如下：

<!-- 默認的注解映射的支持 -->   <mvc:annotation-driven validator="validator" conversion-service="conversion-service" />    <bean id="validator" class="org.springframework.validation.beanvalidation.LocalValidatorFactoryBean">    <property name="providerClass" value="org.hibernate.validator.HibernateValidator"/>    <!--不設置則默認為classpath下的 ValidationMessages.properties -->    <property name="validationMessageSource" ref="validatemessageSource"/>  </bean>  <bean id="conversion-service" class="org.springframework.format.support.FormattingConversionServiceFactoryBean" />  <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>

其中<property name="basename" value="classpath:validatemessages"/>中的classpath:validatemessages為注解驗證消息所在的文件，需要我們在resources文件夾下添加。

在com.demo.web.controllers包中添加一個ValidateController.java內容如下：

package com.demo.web.controllers;import java.security.NoSuchAlgorithmException;import javax.validation.Valid;import org.springframework.stereotype.Controller;import org.springframework.ui.Model;import org.springframework.validation.BindingResult;import org.springframework.web.bind.annotation.ModelAttribute;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.RequestMethod;import com.demo.web.models.ValidateModel;@Controller@RequestMapping(value = "/validate")public class ValidateController {    @RequestMapping(value="/test", method = {RequestMethod.GET})  public String test(Model model){    if(!model.containsAttribute("contentModel")){      model.addAttribute("contentModel", new ValidateModel());    }    return "validatetest";  }    @RequestMapping(value="/test", method = {RequestMethod.POST})  public String test(Model model, @Valid @ModelAttribute("contentModel") ValidateModel validateModel, BindingResult result) throws NoSuchAlgorithmException{        //如果有驗證錯誤 返回到form頁面    if(result.hasErrors())      return test(model);    return "validatesuccess";     }  }

其中@Valid @ModelAttribute("contentModel") ValidateModel validateModel的@Valid 意思是在把數據綁定到@ModelAttribute("contentModel") 后就進行驗證。

在com.demo.web.models包中添加一個ValidateModel.java內容如下：

package com.demo.web.models;import org.hibernate.validator.constraints.Email;import org.hibernate.validator.constraints.NotEmpty;import org.hibernate.validator.constraints.Range;public class ValidateModel{    @NotEmpty(message="{name.not.empty}")  private String name;  @Range(min=0, max=150,message="{age.not.inrange}")  private String age;  @NotEmpty(message="{email.not.empty}")  @Email(message="{email.not.correct}")  private String email;    public void setName(String name){    this.name=name;  }  public void setAge(String age){    this.age=age;  }  public void setEmail(String email){    this.email=email;  }    public String getName(){    return this.name;  }  public String getAge(){    return this.age;  }  public String getEmail(){    return this.email;  }  }

在注解驗證消息所在的文件即validatemessages.properties文件中添加以下內容：

name.not.empty=/u540D/u79F0/u4E0D/u80FD/u4E3A/u7A7A/u3002age.not.inrange=/u5E74/u9F84/u8D85/u51FA/u8303/u56F4/u3002email.not.correct=/u90AE/u7BB1/u5730/u5740/u4E0D/u6B63/u786E/u3002email.not.empty=/u7535/u5B50/u90AE/u4EF6/u4E0D/u80FD/u60DF/u6050/u3002

其中name.not.empty等分別對應了ValidateModel.java文件中message=”xxx”中的xxx名稱，后面的內容是在輸入中文是自動轉換的ASCII編碼，當然你也可以直接把xxx寫成提示內容，而不用另建一個validatemessages.properties文件再添加，但這是不正確的做法，因為這樣硬編碼的話就沒有辦法進行國際化了。

在views文件夾中添加validatetest.jsp和validatesuccess.jsp兩個視圖，內容分別如下：

<%@ page language="java" contentType="text/html; charset=UTF-8"  pageEncoding="UTF-8"%><!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %><html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Insert title here</title></head><body>  <form:form modelAttribute="contentModel" method="post">           <form:errors path="*"></form:errors><br/><br/>          name：<form:input path="name" /><br/>    <form:errors path="name"></form:errors><br/>        age：<form:input path="age" /><br/>    <form:errors path="age"></form:errors><br/>        email：<form:input path="email" /><br/>    <form:errors path="email"></form:errors><br/>    <input type="submit" value="Submit" />      </form:form> </body></html>

<%@ page language="java" contentType="text/html; charset=UTF-8"  pageEncoding="UTF-8"%><!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Insert title here</title></head><body>  驗證成功！</body></html>

其中特別要指出的是validatetest.jsp視圖中<form:form modelAttribute="contentModel" method="post">的modelAttribute="xxx"后面的名稱xxx必須與對應的@Valid @ModelAttribute("xxx") 中的xxx名稱一致，否則模型數據和錯誤信息都綁定不到。

<form:errors path="name"></form:errors>即會顯示模型對應屬性的錯誤信息，當path="*"時則顯示模型全部屬性的錯誤信息。

運行測試：