添加 i18n 多语言配置文件

• yml 配置修改

默认 basename 为 messages 管理方便统一存放在 resources/i18n 目录修改默认 YML 配置如下：

spring:
  messages:
    basename: i18n.messages
复制

添加 properties 文件，命名如下：

messages.properties（默认的多语言文件, 中文语言）
messages_en_US.properties（英文语言文件）
复制

多语言解析器拦截器配置

多语言 Cookie 名称设置为 locale 切换多语言 url 地址 url?locale=en_US 切换为英文 url?locale=zh_CN 切换为中文 ，注意 en_US 对应多语言 messages_en_US.properties 设置的值，如果找不到语言使用默认文件。

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.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
import org.springframework.web.servlet.i18n.CookieLocaleResolver;
import org.springframework.web.servlet.i18n.LocaleChangeInterceptor;

@Configuration
public class LocaleMvcConfigurer implements WebMvcConfigurer {

    @Bean
    public LocaleResolver localeResolver() {
        CookieLocaleResolver cookieLocaleResolver = new CookieLocaleResolver();
        // 多语言 cookie 名称设置
        cookieLocaleResolver.setCookieName("locale");
        return cookieLocaleResolver;
    }

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        // i18n 多语言拦截处理器
        registry.addInterceptor(new LocaleChangeInterceptor()).addPathPatterns("/**");
    }
}
复制

多语言测试

修改多语言测试文件 messages.properties 内容 hi=测试 messages_en_US.properties 内容 hi=test

@GetMapping("/i18n")
public String i18n() {
    try {
        Locale locale = LocaleContextHolder.getLocale();
        return messageSource.getMessage("hi", null, locale);
    } catch (NoSuchMessageException e) {
        // Do Nothing
    }
    return "error";
}
复制

• 默认语言访问 localhost:8080/i18n
  返回 测试

• 默认语言访问 localhost:8080/i18n?locale=en_US 切换为英文
  返回 test
  访问 localhost:8080/i18n 返回 test

• 默认语言访问 localhost:8080/i18n?locale=zh_CN 切换为中文
  返回 测试
  访问 localhost:8080/i18n 返回 测试

全局多语言切换

访问 localhost:8080/language/us 全局多语言切换为英文

@Operation(summary = "多语言切换")
@GetMapping("/language/{lang}")
public Boolean language(@PathVariable("lang") String lang) {
    LocaleResolver localeResolver = RequestContextUtils.getLocaleResolver(request);
    localeResolver.setLocale(request, response, "us".equals(lang) ? Locale.US : Locale.CHINA);
    return true;
}
复制

语言代码表