Comment configurer l'internationalisation des informations d'invite de validation SpringBoot

Spring Boot Validation prend en charge les annotations JSR-380 (alias Bean Validation 2.0, qui fait partie de Jakarta EE et JavaSE). Le message d'erreur de vérification peut être défini via l'attribut de message de l'annotation de vérification, et chaque annotation de vérification a une configuration de message par défaut. tel que La valeur de l'attribut de message de @NotBlank est définie comme indiqué ci-dessous : @NotBlank的message属性值设置如下图：

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

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

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转码才可正确显示

如下图：

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

例如：

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

而想要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验证器自定义国际化文件配置<br/>
 * 注：适用于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;
    }

}

注：

• 通过上述配置类进行配置后，

• 仅兼容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自身国际化配置。

实际测试Spring Boot 2.6.x版本，验证注解message="{propName}"：

• 可以直接读取通过spring.messages设置的国际化配置中的属性（设置UTF-8编码后中文可无需ASCII转码），

• 同时亦支持读取resources/ValidationMessages.properties中的配置（中文需ASCII转码），

• 且依旧支持原hibernate-validator

  

Le message = "{...}" par défaut spécifie le nom de l'attribut d'internationalisation, qui sera remplacé par celle correspondante en fonction de la locale. La valeur de ces propriétés d'internationalisation peut être trouvée dans hibernate-validator et une série de définitions de propriétés d'internationalisation telles que org.hibernate.validator.ValidationMessages.properties<.> :

Et nous l'utilisons actuellement Pendant le processus, en plus de définir le formulaire de message="{propName}" pour lire les propriétés internationales, vous pouvez également définir directement la valeur message="informations d'invite spécifiques ". Si vous ne définissez pas explicitement le message, utilisez la configuration par défaut dans org.hibernate.validator.ValidationMessages.properties mentionnée précédemment.

Spring Validation de démarrage Au début, il ne prenait pas directement en charge la lecture de la propre configuration d'internationalisation de Spring Boot (configurée via spring.messages), mais les propriétés d'internationalisation qui doivent être configurées dans resources/ValidationMessages.properties prendront effet plus tard, dans Spring Boot 2.6 uniquement. la version + prend en charge la combinaison de la validation et de la propre configuration internationale de Spring Boot.

Ensuite, nous présenterons comment Spring Boot Validation intègre les informations d'invite de validation internationale personnalisées en conjonction avec les versions Spring Boot 2.5 et 2.6.

Spring Boot 2.5.x

Dans la version Spring Boot 2.5.x, Spring Boot Validation prend uniquement en charge l'internationalisation lors de la lecture de la série de fichiers resources/ValidationMessages.properties par attribut par défaut, et le chinois doit être transcodé en ASCII pour s'afficher correctement🎜🎜Comme indiqué ci-dessous :🎜🎜🎜🎜Même si l'application Spring Boot déclare sa propre configuration d'internationalisation, le framework Spring Boot Validation ne peut pas la lire🎜🎜Par exemple : 🎜🎜L'application Spring Boot elle-même La configuration d'internationalisation est comme indiqué ci-dessous, mais le "{propName}" dans le paramètre d'attribut de message d'annotation de vérification i18n/messages.properties ne peut pas être lu : 🎜🎜🎜🎜Et vous souhaitez utiliser le même cadre de validation Spring Boot que Spring Boot lui-même. La configuration internationale peut être configuré comme suit : 🎜rrreee🎜Remarque : 🎜

• 🎜Après la configuration via la classe de configuration ci-dessus, 🎜🎜
• 🎜Uniquement compatible avec les fichiers d'internationalisation définis par Spring Boot spring.messages et les fichiers d'internationalisation du hibernate-validator d'origine🎜🎜
• 🎜Ne prend plus en charge la série resource/ValidationMessages.properties🎜🎜🎜

  Spring Boot 2.6.x h3>🎜 J'ai vérifié les instructions de publication du framework Spring Boot sur Github et j'ai découvert que dans la v2.6.0-M2 publiée le 20/08/2021, il mentionnait la prise en charge de l'utilisation de son propre MessageSource internationalisé pour analyser les informations d'invite de vérification, c'est-à-dire On dit que Spring Boot 2.6.x et versions ultérieures prennent en charge l'attribut de message d'annotation de vérification pour faire référence à la propre configuration internationale de Spring Boot. 🎜🎜🎜🎜Actuel test de la version Spring Boot 2.6.x, annotation de vérification message="{propName}" : 🎜

  • 🎜peut être lue directement via spring. Attributs dans la configuration d'internationalisation définie par messages (le chinois ne nécessite pas de transcodage ASCII après avoir défini le codage UTF-8), 🎜🎜
  • 🎜prend également en charge la lecture des ressources/Configuration dans ValidationMessages.properties (le chinois nécessite un transcodage ASCII), 🎜🎜
  • 🎜 et prend toujours en charge les fichiers d'internationalisation du hibernate-validator d'origine. 🎜🎜🎜🎜Et la priorité de lecture est de haut en bas, c'est-à-dire que celle du haut prend effet en premier. 🎜🎜Voir la figure ci-dessous pour une configuration et une utilisation spécifiques : 🎜🎜🎜🎜🎜Spring Boot 2.6 Concernant l'intégration de Spring Boot Validation et MessageSource, des détails d'implémentation spécifiques peuvent être trouvés dans la GitHub Pull Request #17530 mentionnée dans la version : 🎜🎜🎜🎜

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!