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(); } }
到这里国际化配置编写工作就完全做好了!