Spring國(guó)際化和Validation詳解

更新時(shí)間：2024年11月22日 14:37:42 作者：風(fēng)舞紅葉

本文介紹了SpringBoot中國(guó)際化和Validation的融合實(shí)現(xiàn),包括配置MessageSource和LocalValidatorFactoryBean,以及自定義約束注解和校驗(yàn)器,通過(guò)解析請(qǐng)求頭中的Accept-Language,SpringBoot可以返回不同語(yǔ)言的文本信息

SpringBoot國(guó)際化和Validation融合

場(chǎng)景

在應(yīng)用交互時(shí)，可能需要根據(jù)客戶端得語(yǔ)言來(lái)返回不同的語(yǔ)言數(shù)據(jù)。

前端通過(guò)參數(shù)、請(qǐng)求頭等往后端傳入locale相關(guān)得參數(shù)，后端獲取參數(shù)，根據(jù)不同得locale來(lái)獲取不同得語(yǔ)言得文本信息返回給前端。

實(shí)現(xiàn)原理

SpringBoot支持國(guó)際化和Validation，主要通過(guò)MessageSource接口和Validator實(shí)現(xiàn)。

國(guó)際化配置‌

編寫(xiě)國(guó)際化配置文件，如messages_en_US.properties和messages_zh_CN.properties，并置于resources/i18n目錄下。
配置application.yml或application.properties以指定國(guó)際化文件的位置，例如spring.messages.basename=i18n/messages。
配置LocaleResolver以解析當(dāng)前請(qǐng)求的locale，常用的實(shí)現(xiàn)是AcceptHeaderLocaleResolver，它通過(guò)請(qǐng)求頭accept-language獲取當(dāng)前的locale。

‌Validation配置‌

引入spring-boot-starter-validation依賴以支持Validation功能

		<dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-validation</artifactId>
        </dependency>

配置LocalValidatorFactoryBean以使用國(guó)際化的校驗(yàn)消息，需注入MessageSource

示例

引入依賴

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

國(guó)際化配置文件

在src/main/resources/i18n目錄下創(chuàng)建兩個(gè)文件：messages_en_US.properties和messages_zh_CN.properties。

#messages_en_US.properties
welcome.message=Welcome to our website!

#messages_zh_CN.properties
welcome.message=歡迎來(lái)到我們的網(wǎng)站！

配置MessageSource‌

在Spring Boot的配置文件中（application.properties或application.yml），配置MessageSource以指定國(guó)際化文件的位置。

如果你打算使用Validation的默認(rèn)國(guó)際化文件，你實(shí)際上不需要為Validation單獨(dú)指定文件，因?yàn)?code>LocalValidatorFactoryBean會(huì)自動(dòng)查找ValidationMessages.properties。

但是，你可以配置自己的國(guó)際化文件，并讓MessageSource同時(shí)服務(wù)于你的應(yīng)用消息和Validation消息。

# 國(guó)際化文件被放置在src/main/resources/i18n目錄下，并以messages為前綴
spring.messages.basename=i18n/messages,org.hibernate.validator.ValidationMessages
spring.messages.encoding=utf-8

注意：上面的配置假設(shè)你的自定義消息文件位于i18n/messages.properties，而Validation的默認(rèn)消息文件是org.hibernate.validator.ValidationMessages.properties。

實(shí)際上,ValidationMessages.properties文件位于Hibernate Validator的jar包中，所以你不需要顯式地將它包含在你的資源目錄中。Spring Boot會(huì)自動(dòng)從classpath中加載它。

配置LocalValidatorFactoryBean‌

在你的配置類中，創(chuàng)建一個(gè)LocalValidatorFactoryBean的bean，并將MessageSource注入到它中。

這樣，LocalValidatorFactoryBean就會(huì)使用Spring的MessageSource來(lái)解析校驗(yàn)消息。

import org.hibernate.validator.HibernateValidator;
import org.springframework.context.MessageSource;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.validation.beanvalidation.LocalValidatorFactoryBean;

import java.util.Properties;

@Configuration
public class ValidateConfig {

    @Bean
    public LocalValidatorFactoryBean validatorFactoryBean(MessageSource messageSource) {
        LocalValidatorFactoryBean factoryBean = new LocalValidatorFactoryBean();
        factoryBean.setValidationMessageSource(messageSource);
        //        設(shè)置使用 HibernateValidator 校驗(yàn)器
        factoryBean.setProviderClass(HibernateValidator.class);
//        設(shè)置 快速異常返回 只要有一個(gè)校驗(yàn)錯(cuò)誤就立即返回失敗，其他參數(shù)不在校驗(yàn)
        Properties properties = new Properties();
        properties.setProperty("hibernate.validator.fail_fast", "true");
        factoryBean.setValidationProperties(properties);
//        加載配置
        factoryBean.afterPropertiesSet();
        return factoryBean;
    }
}

使用校驗(yàn)

import javax.validation.constraints.NotNull;

public class MyModel {

    @NotNull(message = "{not.null.message}")
    private String field;

    // getters and setters
}

messages.properties文件中，你可以添加

not.null.message=This field cannot be null.

而在Hibernate Validator的ValidationMessages.properties文件中，已經(jīng)包含了默認(rèn)的校驗(yàn)消息，如{javax.validation.constraints.NotNull.message}的值。

自定義校驗(yàn)

定義約束注解:創(chuàng)建一個(gè)注解，用@Constraint標(biāo)記，并定義message、groups和payload屬性

import javax.validation.Constraint;
import javax.validation.Payload;
import java.lang.annotation.*;


@Documented
@Target({ElementType.PARAMETER, ElementType.FIELD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = MyValidateContent.class)
public @interface MyValidate {
    String message() default "";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

實(shí)現(xiàn)約束驗(yàn)證器**:創(chuàng)建一個(gè)實(shí)現(xiàn)了ConstraintValidator接口的類，并重寫(xiě)isValid方法
在isValid方法中使用ConstraintValidatorContext**‌：如果驗(yàn)證失敗，使用ConstraintValidatorContext的buildConstraintViolationWithTemplate方法來(lái)構(gòu)建ConstraintViolation

import com.example.dto.ParamVo;

import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;


public class MyValidateContent implements ConstraintValidator<MyValidate, ParamVo> {
    @Override
    public void initialize(MyConstraint constraintAnnotation) {
        // 初始化代碼（如果需要的話）
    }
    @Override
    public boolean isValid(ParamVo paramVo, ConstraintValidatorContext constraintValidatorContext) {
        if ("N".equals(paramVo.getSex())) {
            if (paramVo.getAge() < 18) {
                buildMessage(constraintValidatorContext, "template1");
                return false;
            }
        } else {
            if (paramVo.getAge() <  20) {
                buildMessage(constraintValidatorContext, "template2");
                return false;
            }
        }
        return true;
    }

    private void buildMessage(ConstraintValidatorContext context, String key) {
        String template = ('{'+key+'}').intern();
        context.buildConstraintViolationWithTemplate(template)
                .addConstraintViolation();
    }
}

在這個(gè)例子中，如果sex是N并且age小于18，驗(yàn)證器將使用ConstraintValidatorContext來(lái)構(gòu)建一個(gè)帶有錯(cuò)誤消息的ConstraintViolation。

消息模板"{template1}"將會(huì)在驗(yàn)證失敗時(shí)被解析，并替換為你在MyValidate注解中定義的默認(rèn)消息或你在messages.properties文件中定義的國(guó)際化消息。

確保你的MyValidate注解定義了一個(gè)message屬性，并且你在messages.properties文件中有一個(gè)對(duì)應(yīng)的條目例如：

template1=男性要大于18
template2=女性要大于20

import com.example.validate.MyValidate;
import lombok.Getter;
import lombok.Setter;
import org.hibernate.validator.constraints.Length;

import javax.validation.constraints.NotBlank;
import javax.validation.constraints.NotNull;

@Getter
@Setter
@MyValidate
public class ParamVo {
    @NotBlank(message = "{javax.validation.constraints.NotNull.message}")
    private String sex;
    @NotNull(message = "age 不能為空")
    private Integer age;
    @NotBlank(message = "{name.not.null}")
    @Length(max = 3,message = "{name.length.max}")
    private String name;
}

Controller層異常處理

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.BindingResult;
import org.springframework.validation.FieldError;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;

import java.util.HashMap;
import java.util.Map;


@RestControllerAdvice
public class GlobalException {
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<Object> handleValidationExceptions(MethodArgumentNotValidException ex) {
        Map<String, String> errors = new HashMap<>();
        BindingResult result = ex.getBindingResult();
        for (FieldError error : result.getFieldErrors()) {
            errors.put(error.getField(), error.getDefaultMessage());
        }
        // 這里可以根據(jù)實(shí)際需求定制返回的錯(cuò)誤信息結(jié)構(gòu)
        Map<String, Object> response = new HashMap<>();
        response.put("status", HttpStatus.BAD_REQUEST.value());
        response.put("errors", errors);
        return new ResponseEntity<>(response, HttpStatus.BAD_REQUEST);
    }
}

內(nèi)部方法校驗(yàn)

import org.springframework.validation.annotation.Validated;
import javax.validation.constraints.Min;
import javax.validation.constraints.NotNull;
//@Validated 
@Validated
public interface ServiceIntface {
    //校驗(yàn)返回值，校驗(yàn)入?yún)?
    @NotNull Object hello(@NotNull @Min(10) Integer id, @NotNull String name);
}

import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Service;

@Slf4j
@Service
public class ServiceImpl implements ServiceIntface {
    @Override
    public Object hello(Integer id, String name) {
        return null;
    }
}

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;

import javax.validation.ConstraintViolation;
import javax.validation.ConstraintViolationException;
import java.util.HashMap;
import java.util.Map;
import java.util.Set;


@RestControllerAdvice
public class GlobalException {

    @ExceptionHandler(ConstraintViolationException.class)
    public ResponseEntity<Object> handleValidationExceptions(ConstraintViolationException ex) {
        Map<String, String> errors = new HashMap<>();
        Set<ConstraintViolation<?>> constraintViolations = ex.getConstraintViolations();
        for (ConstraintViolation<?> constraintViolation : constraintViolations) {
            String key = constraintViolation.getPropertyPath().toString();
            String message = constraintViolation.getMessage();
            errors.put(key, message);
        }

        // 這里可以根據(jù)實(shí)際需求定制返回的錯(cuò)誤信息結(jié)構(gòu)
        Map<String, Object> response = new HashMap<>();
        response.put("status", HttpStatus.BAD_REQUEST.value());
        response.put("errors", errors);
        return new ResponseEntity<>(response, HttpStatus.BAD_REQUEST);
    }
}

校驗(yàn)寫(xiě)在接口上的，拋出異常javax.validation.ConstraintViolationException
校驗(yàn)寫(xiě)在具體實(shí)現(xiàn)，拋出異常javax.validation.ConstraintDeclarationException

注意點(diǎn)

代碼中國(guó)際化使用

代碼里響應(yīng)，手動(dòng)獲取使用MessageSource的getMessage方法即可，也就是spring容器中的getMessage()

# messages_en_US.properties
welcome.message=Welcome to our website!

# messages_zh_CN.properties
welcome.message=歡迎來(lái)到我們的網(wǎng)站！

#定義消息，并使用占位符{0}、{1}等表示參數(shù)位置
#welcome.message=歡迎{0}來(lái)到{1}

//創(chuàng)建一個(gè)配置類來(lái)配置LocaleResolver，以便根據(jù)請(qǐng)求解析當(dāng)前的語(yǔ)言環(huán)境：
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.LocaleResolver;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
import org.springframework.web.servlet.i18n.SessionLocaleResolver;

import java.util.Locale;

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Bean
    public LocaleResolver localeResolver() {
        SessionLocaleResolver sessionLocaleResolver = new SessionLocaleResolver();
        sessionLocaleResolver.setDefaultLocale(Locale.US); // 設(shè)置默認(rèn)語(yǔ)言
        return sessionLocaleResolver;
    }
}

//創(chuàng)建一個(gè)控制器來(lái)使用國(guó)際化的消息
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.MessageSource;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.servlet.http.HttpServletRequest;
import java.util.Locale;

@RestController
@RequestMapping("/hello")
public class HelloController {

    @Autowired
    private MessageSource messageSource;

    @GetMapping
    public String hello(HttpServletRequest request) {
        Locale locale = (Locale) request.getAttribute(org.springframework.web.servlet.LocaleResolver.LOCALE_RESOLVER_ATTRIBUTE);
         //messageSource.getMessage("welcome.message", new Object[]{"張三", "中國(guó)"}, Locale.CHINA)。
        return messageSource.getMessage("welcome.message", null, locale);
    }
}

Locale獲取

默認(rèn)情況下spring注冊(cè)的messageSource對(duì)象為ResourceBundleMessageSource，會(huì)讀取spring.message配置。

請(qǐng)求中Locale的獲取是通過(guò)LocaleResolver進(jìn)行處理，默認(rèn)是AcceptHeaderLocaleResolver，通過(guò)WebMvcAutoConfiguration注入，從Accept-Language請(qǐng)求頭中獲取locale信息。

此時(shí)前端可以在不同語(yǔ)言環(huán)境時(shí)傳入不同的請(qǐng)求頭Accept-Language即可達(dá)到切換語(yǔ)言的效果

Accept-Language: en-Us
Accept-Language: zh-CN

默認(rèn)情況下前端請(qǐng)求中的不用處理，如果約定其他信息傳遞Local，使用自定義的I18nLocaleResolver替換默認(rèn)的AcceptHeaderLocaleResolver，重寫(xiě)resolveLocale方法就可以自定義Locale的解析邏輯。

import cn.hutool.core.util.StrUtil;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.LocaleResolver;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.Locale;

/**
 *
 */
@Configuration
public class I18nConfig {
    @Bean
    public LocaleResolver localeResolver() {
        return new I18nLocaleResolver();
    }

    /**
     * 獲取請(qǐng)求頭國(guó)際化信息
     * 使用自定義的I18nLocaleResolver替換默認(rèn)的AcceptHeaderLocaleResolver，重寫(xiě)resolveLocale方法就可以自定義Locale的解析邏輯。
     *
     * 自定義后使用content-language傳Locale信息，使用_劃分語(yǔ)言個(gè)地區(qū)。
     * content-language: en_US
     * content-language: zh_CN
     */
    static class I18nLocaleResolver implements LocaleResolver {

        @Override
        public Locale resolveLocale(HttpServletRequest httpServletRequest) {
            String language = httpServletRequest.getHeader("content-language");
            Locale locale = Locale.getDefault();
            if (StrUtil.isNotBlank(language)) {
                String[] split = language.split("_");
                locale = new Locale(split[0], split[1]);
            }
            return locale;
        }

        @Override
        public void setLocale(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse, Locale locale) {

        }
    }
}