【第十二篇】Spring Boot中的页面国际化

简介: 【第十二篇】Spring Boot中的页面国际化

1.1 页面国际化

有的时候,我们的网站会去涉及中英文甚至多语言的切换,这时候我们就需要对页面进行国际化设计了。

1.2 准备工作

在IDEA中统一设置properties的编码格式


1.3 编写配置文件

编写国际化配置文件,抽取页面需要进行国际化的页面信息,可以去登录页面查看一下,哪些内容需要编写国际化的配置!

1.3.1步骤一

1.3.1步骤一

我们在resources资源文件下新建一个i18n目录(文件夹),存放国际化配置文件

1.3.2 步骤二

i18n目录下新建一个login.properties文件,然后同样的再新建一个login_zh_CN.properties

此时IDEA自动识别到我们要做国际化操作,文件夹层级变了!

1.3.3 步骤三

我们可以在Resource Bundle 'login'这个目录上面去新建一个文件,作文英文的

弹出如下页面,我们再添加一个英文的:en_US

添加成功

1.3.4 步骤四

接下来编写配置,我们可以看到idea下面有另外一个视图

进入这个视图点击+ 号就可以直接添加属性,新建一个login.btn,可以看到右边有三个文件框可以输入,然后依次添加其他页面属性内容即可!

查看我们的配置好的文件

login.properties:默认

login.btn=登录

login.password=密码

login.remember=记住我

login.tip=请登录

login.username=用户名

login_en_US.properties:英文

login.btn=Sign in

login.password=Password

login.remember=Remember me

login.tip=Please sign in

login.username=Username

login_zh_CN.properties:中文

login.btn=登录

login.password=密码

login.remember=记住我

login.tip=请登录

login.username=用户名

OK,配置文件步骤搞定!

1.4 配置文件生效探究

先去看一下SpringBoot对国际化的自动配置,这里涉及到一个类:MessageSourceAutoConfiguration里面有一个方法,

这里发现SpringBoot已经自动配置好了管理国际化资源文件的组件ResourceBundleMessageSource

// 获取 properties 传递过来的值进行判断
@Bean
  @ConfigurationProperties(prefix = "spring.messages")
  public MessageSourceProperties messageSourceProperties() {
    return new MessageSourceProperties();
  }
  @Bean
  public MessageSource messageSource(MessageSourceProperties properties) {
    ResourceBundleMessageSource messageSource = new ResourceBundleMessageSource();
    if (StringUtils.hasText(properties.getBasename())) {
             // 设置国际化文件的基础名(去掉语言国家代码的)
      messageSource.setBasenames(StringUtils
          .commaDelimitedListToStringArray(StringUtils.trimAllWhitespace(properties.getBasename())));
    }
    if (properties.getEncoding() != null) {
      messageSource.setDefaultEncoding(properties.getEncoding().name());
    }
    messageSource.setFallbackToSystemLocale(properties.isFallbackToSystemLocale());
    Duration cacheDuration = properties.getCacheDuration();
    if (cacheDuration != null) {
      messageSource.setCacheMillis(cacheDuration.toMillis());
    }
    messageSource.setAlwaysUseMessageFormat(properties.isAlwaysUseMessageFormat());
    messageSource.setUseCodeAsDefaultMessage(properties.isUseCodeAsDefaultMessage());
    return messageSource;
  }

我们真实的情况是放在了resources下的i18n目录下,所以我们要去application.properties中配置这个messages的路径

# 我们国际化配置文件的真实位置
spring.messages.basename=i18n/login

1.5 配置页面国际化值

去页面获取国际化的值,查看Thymeleaf的文档,找到message取值操作为:#{xxx}

1.6 配置国际化解析

Spring中有一个国际化的Locale (区域信息对象),里面有一个叫做LocaleResolver(获取区域信息对象)的解析器!

我们去我们webmvc自动配置文件,寻找一下!看到SpringBoot默认配置:

@Bean
@ConditionalOnMissingBean
@ConditionalOnProperty(prefix = "spring.mvc", name = "locale")
public LocaleResolver localeResolver() {
    // 容器中没有就自己配,有的话就用用户配置的
    if (this.mvcProperties.getLocaleResolver() == WebMvcProperties.LocaleResolver.FIXED) {
        return new FixedLocaleResolver(this.mvcProperties.getLocale());
    }
    // 接收头国际化分解
    AcceptHeaderLocaleResolver localeResolver = new AcceptHeaderLocaleResolver();
    localeResolver.setDefaultLocale(this.mvcProperties.getLocale());
    return localeResolver;
}
AcceptHeaderLocaleResolver 这个类中有一个方法
public Locale resolveLocale(HttpServletRequest request) {
    Locale defaultLocale = this.getDefaultLocale();
    // 默认的就是根据请求头带来的区域信息获取Locale进行国际化
    if (defaultLocale != null && request.getHeader("Accept-Language") == null) {
        return defaultLocale;
    } else {
        Locale requestLocale = request.getLocale();
        List<Locale> supportedLocales = this.getSupportedLocales();
        if (!supportedLocales.isEmpty() && !supportedLocales.contains(requestLocale)) {
            Locale supportedLocale = this.findSupportedLocale(request, supportedLocales);
            if (supportedLocale != null) {
                return supportedLocale;
            } else {
                return defaultLocale != null ? defaultLocale : requestLocale;
            }
        } else {
            return requestLocale;
        }
    }
}

那假如我们现在想点击链接让我们的国际化资源生效,就需要让我们自己的Locale生效!

我们去写一个自己的LocaleResolver,可以在链接上携带区域信息!

修改一下前端页面的跳转链接:

我们去写一个处理的组件类!

package com.dzj.config;
import org.springframework.web.servlet.LocaleResolver;
import org.thymeleaf.util.StringUtils;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.Locale;
public class MyLocaleResolver implements LocaleResolver {
    @Override
    public Locale resolveLocale(HttpServletRequest request) {
        //获取请求中的语言参数
        String language = request.getParameter("l");
        Locale locale = Locale.getDefault();//如果没有就是用默认的
        //如果请求的链接携带了国际化的参数
        if(!StringUtils.isEmpty(language)){
            //zh_CN
            String[] split = language.split("_");
            // 语言,国家
            locale = new Locale(split[0], split[1]);
        }
        return locale;
    }
    @Override
    public void setLocale(HttpServletRequest request, HttpServletResponse response, Locale locale) {
    }
}

为了让我们的区域化信息能够生效,我们需要再配置一下这个组件!在我们自己的MvcConofig下添加bean

package com.dzj.config;
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;
@Configuration
public class MyMvcConfig implements WebMvcConfigurer {
    //自定义的国际化组件就生效了
    @Bean
    public LocaleResolver localeResolver(){
        return new MyLocaleResolver();
    }
}

到这里国际化配置编写工作就完全做好了!

相关文章
|
8天前
|
JavaScript 前端开发 Java
springboot从控制器请求至页面时js失效的解决方法
springboot从控制器请求至页面时js失效的解决方法
17 0
springboot从控制器请求至页面时js失效的解决方法
|
8天前
|
Java 数据库连接 mybatis
springboot访问jsp页面变成直接下载?
springboot访问jsp页面变成直接下载?
91 0
|
8天前
|
JavaScript 前端开发
springboot+layui从控制器请求至页面时js失效的解决方法
springboot+layui从控制器请求至页面时js失效的解决方法
17 0
|
5天前
|
前端开发 JavaScript Java
Java网络商城项目 SpringBoot+SpringCloud+Vue 网络商城(SSM前后端分离项目)五(前端页面
Java网络商城项目 SpringBoot+SpringCloud+Vue 网络商城(SSM前后端分离项目)五(前端页面
Java网络商城项目 SpringBoot+SpringCloud+Vue 网络商城(SSM前后端分离项目)五(前端页面
|
8天前
|
存储 Java Spring
Spring之国际化:i18n
【1月更文挑战第17天】 一、i18n概述 二、Java国际化 三、Spring6国际化 1、MessageSource接口 2、使用Spring6国际化
59 1
|
8天前
|
XML Java 数据格式
springboot 微服务项目如何集成 html 页面
springboot 微服务项目如何集成 html 页面
36 0
|
8天前
|
安全 Java 数据安全/隐私保护
SpringBoot启动后出现Please sign in页面
项目启动后,出现莫名其妙的Please sign in页面
63 0
|
8天前
|
存储 人工智能 运维
spring国际化 - i18n
spring国际化 - i18n
40 0
|
8天前
|
Java
SpringBoot thymeleaf自定义错误页面
SpringBoot thymeleaf自定义错误页面
25 0
|
8天前
|
存储 开发框架 自然语言处理
Spring6 i18n国际化
Spring6 i18n国际化