SpringMVC数据校验并通过国际化显示错误信息

目录

• SpringMVC数据校验并通过国际化显示错误信息
  • SpringMVC数据校验
  • 在页面中显示错误信息
  • 通过国际化显示错误信息

SpringMVC数据校验并通过国际化显示错误信息

SpringMVC数据校验

<mvc:annotation-driven/>会默认装配好一个LocalValidatorFactoryBean，通过在处理方法的入参上标注@Valid 注解即可让Spring MVC在完成数据绑定后执行数据校验的工作。

首先，我们在实体类上标注JSR303校验注解

public class User extends BaseDomain{
    private int userId;

	//将属性值长度限定为2~10之间，但中文占两个字符
    @Length(min = 2, max = 10)
    private String userName;
    
    //匹配4~30个数字和字母以及下划线字符
    @Pattern(regexp="w{4, 30}")
    private String name;
    
    @Length(min = 6)
    private String password;  

注解规则有多个可以参考下表

JSR 303注解

Hibernate Validator拓展注解

接着我们要让springMVC使用这些规则对数据进行校验，下面将使用LoginController控制器进行演示。

@Controller
public class LoginController {

    @RequestMapping(value = "/login", produces="text/html;charset=UTF-8")
    public String login(
   		@Valid @ModelAttribute("user") User user, 
    	BindingResult result, HttpSession session){
        if(result.hasErrors()){
            return "forward:/loginPage";
        }else{
            session.setAttribute("user", user);
            return "home";
        }
    }

​ 在已经标注了JSR303注解的表单/命令对象前标注一个@Valid，Spring MVC框架在将请求数据绑定到该入参对象后，就会调用校验框架根据注解声明的校验规则实施校验。

​ 在本例中我们对User对象标注@Valid注解。还有要记得标注@ModelAttribute，并显示的指定其value值为user，在显示错误信息时我们会用到它。

​ 还有一个问题就是校验所产生的校验结果保存在什么地方呢，如何传递给请求处理方法？Spring MVC是通过对处理方法签名的规约来保存校验结果的：前一个表单/命令对象的校验结果保存在其后的入参中，这个保存校验结果的入参必须是BindingResult 或Errors类型，这两个类都位于org.springframework.validation包中。

​ 而且需校验的表单/命令对象和其绑定结果对象或错误对象是成对出现的，它们之间不允许声明其他的入参。

在页面中显示错误信息

​ 由于表单/命令对象所对应的请求一般是从客户端的网页中传送过来的，如果发生了错误，我们必须通过网页显示出错误，提示用户更正错误。

<div class="login-container">

        <form:form modelAttribute="user" action="login" method="post">
            <div class="login-inner">
                <div class="login-inner-item login-operaType">
                    <div class="sign-in active">登录</div>
                    <div class="sign-up">注册</div>
                </div>
                <div class="login-inner-item">
                    <input type="text" class="layui-input" placeholder="账号" name="userName" value="${user.userName}">
                    <div class="message-error">
                        <form:errors path="userName" cssClass="message-error"/>
                    </div>
                </div>
                <div class="login-inner-item">
                    <input type="password" class="layui-input" placeholder="密码" name="password" value="${user.password}">
                    <div class="message-error">
                        <form:errors path="password" cssClass="message-error"/>
                    </div>
                </div>
                <div class="login-inner-item message-error">
                    ${errorMsg}
                </div>
                <div class="login-inner-link">
                    <a href="">忘记密码</a>
                </div>
                <div class="login-inner-item .login-inner-submit">
                    <input type="submit" class="layui-input" value="登录">
                </div>
            </div>
        </form:form>
    </div>

首先我们修改一下form标签，并指定模型数据为user，与前面标注的@ModelAttribute一致，如下

<form:form modelAttribute="user" action="login" method="post">
	...
</form:form>

然后使用<form:errors />标签来显示错误信息，path用来指定实体类中的属性，cssClass指定css样式类

<form:errors path="userName" cssClass="message-error"/>

也可以使用如下标签显示所有的错误信息，但是不精确没必要

<form:errors path="*"/>

接下来我们测试一下效果，如下就能显示错误信息了

​ 虽然能显示错误信息，但是这些错误信息是springMVC默认的，在实际运用中我们希望使用更加人性化的设置来显示错误信息。这时我们可以给校验注解添加message属性指定错误信息。

public class User extends BaseDomain{
    private int userId;

    @Length(min = 2, max = 10, message = "用户名不正确，长度必须在2~10之间")
    private String userName;

    @Length(min = 6, message = "密码长度不合法，长度必须大于6")
    private String password;

这样我们就能按照我们自己的想法去显示不同的错误信息，如下

​ 虽然这样做成功了，能个性化的显示错误信息，但是这使用硬编码的方式依旧不推荐使用，我们希望在不修改源代码的情况下来修改这些错误信息，这时就可以使用国际化的方式来显示错误信息了。

通过国际化显示错误信息

当一个属性校验失败后，校验框架默认会为该属性生成4个消息代码，这些代码以校验注解类名为前缀。例如User类中的password属性标准了一个@Length注解，当该属性值不满足@pattern所定义的规则时，就会产生一下4个错误代码：

Length.user.password
Length.password
Length.java.lang.String
Length

这里我们选择最精确的一个Length.user.password

​ 我们在类路径下添加一个文件夹i18n，用来存放国际化资源。然后再创建国际化资源，一个是message.properties，一个是message_zh_CN.properties，内容如下

接下来的工作是在springmvc-servlet中配置好这个国际化资源：

<bean id="messageSource" class="org.springframework.context.support.ResourceBundleMessageSource">
    <property name="basename" value="i18n.message"/>
</bean>

千万要注意，需要给这个bean添加一个id，且其值只能是messageSource，不然这个bean不会起作用。起初我配置好bean后，没给他加上id，然后配置的国际化根本不起作用，这个问题困扰我好久，最后通过查阅资料得知：

​ 对Spring容器启动时的步骤进行剖析，①处的initMessageSource()方法所执行的工作就是初始化容器中的国际化信息资源：它根据反射机制从BeanDefinitionRegistry中找出名称为“messageSource”且类型为org.springframework.context.MessageSource的Bean，将这个Bean定义的信息资源加载为容器级的国际化信息资源。

public void refresh() throws BeansException, IllegalStateException {
        synchronized(this.startupShutdownMonitor) {
            this.prepareRefresh();
            ConfigurableListableBeanFactory beanFactory = this.obtainFreshBeanFactory();
            this.prepareBeanFactory(beanFactory);

            try {
                this.postProcessBeanFactory(beanFactory);
                this.invokeBeanFactoryPostProcessors(beanFactory);
                this.registerBeanPostProcessors(beanFactory);
                //①初始化消息源
                this.initMessageSource();
                this.initApplicationEventMulticaster();
                this.onRefresh();
                this.registerListeners();
                this.finishBeanFactoryInitialization(beanFactory);
                this.finishRefresh();
            } catch (BeansException var9) {
                if (this.logger.isWarnEnabled()) {
                    this.logger.warn("Exception encountered during context initialization - cancelling refresh attempt: " + var9);
                }

                this.destroyBeans();
                this.cancelRefresh(var9);
                throw var9;
            } finally {
                this.resetCommonCaches();
            }

        }
    }

然后看看MessageSource类图结构

所以容器中存在ResourceBundleMessageSource这个bean，并且id为messageSource时，spring才会把这个Bean定义的信息资源加载为容器级的国际化信息资源

然后就可以把实体类中硬编码的message属性给去掉了，如下就是效果，和之前的一样