Spring Boot Validation unterstützt JSR-380-Anmerkungen (auch bekannt als Bean Validation 2.0, Teil von Jakarta EE und JavaSE). Die Überprüfungsfehlermeldung kann über das Nachrichtenattribut der Überprüfungsanmerkung festgelegt werden, und jede Überprüfungsanmerkung verfügt über einen Standard Bei der Konfiguration wird beispielsweise der Nachrichtenattributwert von @NotBlank
wie folgt festgelegt: @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 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系列
翻了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
message = „{...}“
hat die Form: Geben Sie den Namen des Internationalisierungsattributs an, das entsprechend dem Gebietsschema durch den entsprechenden Wert ersetzt wird. Die Definition dieser Internationalisierungsattribute finden Sie in org.hibernate.validator.ValidationMessages <code>hibernate-validator
. und eine Reihe internationaler Eigenschaftsdefinitionen:
In der tatsächlichen Verwendung zusätzlich zum Festlegen der Form der Nachricht ="{propName}"
Um die Internationalisierungseigenschaften auszulesen, können Sie auch direkt den Wert message="spezifische Eingabeaufforderungsinformationen" festlegen. Wenn Sie die Nachricht nicht explizit festlegen, verwenden Sie den Standardwert in org.hibernate .validator.ValidationMessages.properties
bereits erwähnte Konfiguration.
Spring Boot Validation unterstützt zunächst nicht direkt das Lesen der eigenen Internationalisierungskonfiguration von Spring Boot (konfiguriert über spring.messages), muss jedoch in resources/ValidationMessages.properties konfiguriert werden. Das Validierungsattribut wird wirksam. und die Kombination aus Validierung und der eigenen Internationalisierungskonfiguration von Spring Boot wird nur in Spring Boot 2.6+ unterstützt.
Als nächstes stellen wir in Kombination mit den Versionen Spring Boot 2.5 und 2.6 vor, wie Spring Boot Validation benutzerdefinierte internationale Verifizierungsaufforderungsinformationen integriert.
resources/ValidationMessages.properties
-Reihe Das Internationalisierungsattribut in der Datei und Chinesisch müssen ASCII-transkodiert werden, um #🎜🎜##🎜🎜# wie unten gezeigt korrekt anzuzeigen: #🎜🎜##🎜🎜##🎜🎜##🎜🎜#Sogar die Spring Boot-Anwendung deklariert auch ihre eigene Internationalisierungskonfiguration. aber das Spring Boot Validation Framework kann es nicht lesen "{propName}"
in i18n/messages.properties kann nicht gelesen werden: #🎜🎜##🎜🎜##🎜🎜##🎜🎜#Und Sie möchten, dass das Spring Boot Validation Framework und Spring Boot selbst dieselbe Internationalisierungskonfiguration verwenden, Sie können es folgendermaßen konfigurieren: #🎜🎜#rrreee#🎜🎜#Hinweis:#🎜🎜#message="{propName}"
: #🎜🎜#spring.messages
lesen (nach dem Festlegen der UTF-8-Kodierung ist für Chinesisch keine ASCII-Transkodierung erforderlich), #🎜🎜 # #🎜🎜#resources
/ValidationMessages.properties
(Chinesisch erfordert ASCII-Transkodierung), #🎜🎜# #🎜 🎜#hibernate-validator
-Internationalisierungsdateien. #🎜🎜##🎜🎜##🎜🎜##🎜🎜#Und die Leseprioritäten sind von oben nach unten, das heißt, die oberste wird zuerst wirksam. #🎜🎜##🎜🎜#Die spezifische Konfiguration und Verwendung ist in der folgenden Abbildung dargestellt: #🎜🎜##🎜🎜##🎜🎜##🎜🎜##🎜🎜#Spring Boot 2.6 Bezüglich der Integration der Spring Boot-Validierung und MessageSource. Spezifische Implementierungsdetails finden Sie im GitHub Pull Request #17530, der im Release erwähnt wird: #🎜🎜##🎜🎜##🎜🎜##🎜🎜#Das obige ist der detaillierte Inhalt vonSo konfigurieren Sie die Internationalisierung der SpringBoot Validation-Eingabeaufforderungsinformationen. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!