SpringBoot Validation提示信息国际化如何配置

PHPz

发布时间：2023-05-11 11:43:05

1815人浏览过

来源于亿速云

转载

spring boot validation支持jsr-380（aka. bean validation 2.0，part of jakarta ee and javase）注解，可通过验证注解的message属性设置验证错误提示信息，且每个验证注解都有默认的message配置，例如@notblank的message属性值设置如下图：

SpringBoot Validation提示信息国际化如何配置

默认的message = "{...}"的形式即指定国际化属性的名称，后续会根据语言环境替换为对应的值，而这些国际化属性的定义可参见hibernate-validator中的org.hibernate.validator.ValidationMessages.properties等一些列国际化属性定义：

SpringBoot Validation提示信息国际化如何配置

而我们在实际使用过程中，除了可以设置message="{propName}"的形式来读取国际化属性，亦可以直接设置值message="具体的提示信息"，而不明确设置message则使用之前提到的org.hibernate.validator.ValidationMessages.properties中的默认配置。

SpringBoot Validation提示信息国际化如何配置

Spring Boot Validation起初其并不直接支持读取Spring Boot自身的国际化配置（通过spring.messages进行配置），而是需要在resources/ValidationMessages.properties中进行配置的国际化属性才会生效，而后续在Spring Boot 2.6+版本才支持Validation与Spring Boot自身的国际化配置相结合。

接下来结合Spring Boot 2.5和2.6版本分别介绍下Spring Boot Validation如何集成自定义国际化验证提示信息。

Spring Boot 2.5.x

在Spring Boot 2.5.x版本中，Spring Boot Validation默认只支持读取resources/ValidationMessages.properties系列文件的中的国际化属性，且中文需要进行ASCII转码才可正确显示

如下图：

SpringBoot Validation提示信息国际化如何配置

而就算Spring Boot应用亦声明了自身的国际化配置，但是Spring Boot Validation框架是读取不到的

例如：

Spring Boot应用自身的国际化配置如下图，但是在验证注解message属性设置i18n/messages.properties中的"{propName}"是读取不到的：

SpringBoot Validation提示信息国际化如何配置

而想要Spring Boot Validation框架和Spring Boot自身使用同样的国际化配置，则可通过如下方式进行配置：

import org.springframework.context.MessageSource;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.validation.Validator;
import org.springframework.validation.beanvalidation.LocalValidatorFactoryBean;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

/**
 * Spring Web验证器自定义国际化文件配置

 * 注：适用于Spring Boot 2.5.*
 *
 * @author luohq
 * @date 2022-05-21
 */
@Configuration
public class WebValidationConfig implements WebMvcConfigurer {

    /**
     * 国际化消息源
     */
    private MessageSource messageSource;

    public WebValidationConfig(MessageSource messageSource) {
        //注入Spring Boot国际化消息源（需通过spring.messages明确指定）
        this.messageSource = messageSource;
    }

    /**
     * 使用自定义LocalValidatorFactoryBean，
     * 设置Spring国际化消息源
     */
    @Bean
    @Override
    public Validator getValidator() {
        LocalValidatorFactoryBean bean = new LocalValidatorFactoryBean();
        //仅兼容Spring Boot spring.messages设置的国际化文件和原hibernate-validator的国际化文件
        //不支持resource/ValidationMessages.properties系列
        bean.setValidationMessageSource(this.messageSource);
        return bean;
    }

}

注：

Zancms外贸英文电子产品手表网站源码2.0.6

Zancms 外贸英文电子产品手表网站源码，乃Zancms专业外贸独立站系统精心研发之杰作。此源码专为电子产品与电子手表企业的出口业务量身定制，全力助力企业拓展海外市场。其具备卓越的英文展示界面，确保与国际客户无障碍沟通交流。更为独特的是，源码内置先进的 AI 翻译功能，不仅能够精准翻译产品详情、网站文案等各类信息，还能依据不同地区客户的语言偏好，智能适配多种语言版本，极大地提升了网站的国际化服务

下载

通过上述配置类进行配置后，
仅兼容Spring Boot spring.messages设置的国际化文件和原hibernate-validator的国际化文件
不再支持resource/ValidationMessages.properties系列

Spring Boot 2.6.x

翻了Github上Spring Boot框架的Release说明，发现其在2021-08-20发布的v2.6.0-M2中提到了支持使用自身国际化MessageSource解析验证提示信息，也就是说Spring Boot 2.6.x版本之后已支持验证注解message属性引用Spring Boot自身国际化配置。

SpringBoot Validation提示信息国际化如何配置