页面国际化
国际化,英文名叫internationalization,因为中间有18个字母,又叫i18n。
我们平时工作或者开发一些网站时,尤其是国际网站,国际化是必须要做的事情。
准备工作
首先需要保证配置文件的编码格式是UTF-8,否则可能出现页面乱码的情况。选择File->Settings
,搜索File Encodings
进行设置。
测试使用
1、建立不同语言的配置文件。在resources目录下建立目录名称为i18n,添加xxx.properties
国际化配置文件。使用xxx_语言代号_国家代号.properties
的命名格式来添加不同语言的国际化配置文件。当我们添加了指定语言的国际化配置文件后,可以发现IDEA帮我们自动识别了,并帮我们生成了Resource Bundle 'xxx'
目录。
我们再来编写一个英文的国际化配置文件。在国际化配置目录上右键选择New->Add Properties Files to Resource Bundle
可以快速创建国际化配置文件。
点进其中一个国际化配置文件,点击下方的Resource Bundle
,切换窗口之后点击上方的+
号可以快速配置属性。
最终配置完成的效果如下图所示。
如果是一整个完整的页面或者文档页的文章量十分大的时候,没有必要做这些细节化的国际化操作。
Thymeleaf配置国际化
在前台页面配置这些国际化属性需要用到的表达式是Message Expressions,就是用#{...}
这种格式来获取后台配置的国际化属性。
让项目识别国际化配置
首先需要配置绑定国际化的映射路径:
#配置绑定国际化的login路径
spring.messages.basename=i18n.login
配置完映射路径后,在前端使用Message Expressions去获取国际化配置属性时会有提示。
把前端内容填写完毕后,重启项目,访问localhost:8080/,跳到登录页面如下图所示。登录页的文字会跟随着浏览器的语言环境而变化。
原理:谷歌浏览器中右键检查->NetWork
,查看localhost请求我们会发现,在Request Headers
中Accept-Language
参数的值为zh_CN
,说明SpringBoot框架会根据浏览器请求中的语言来使用对应语言的国际化配置。
只不过,以上效果并不是最理想的,我们想要的理想效果是可以通过点击按钮或者链接实现语言的动态切换。
通过点击按钮实现语言动态切换
我们可以参考Dubbo官网,点击网站右上方的按钮可以切换中英文,仔细观察会发现中文和英文的请求地址是不一样的:
中文:http://dubbo.apache.org/zh-cn/
英文:http://dubbo.apache.org/en-us/
也就是说,它是通过不同链接来实现国际化映射的。
在Spring中,国际化对象是Locale。在SpringBoot中,框架帮我们自动注入了国际化的组件。相关源码如下:
@Bean
@ConditionalOnMissingBean
@ConditionalOnProperty(prefix = "spring.mvc", name = "locale")
public LocaleResolver 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;
}
在我们的接收请求解析中发现了一个重写的方法,源码如下:
@Override
public Locale resolveLocale(HttpServletRequest request) {
Locale defaultLocale = getDefaultLocale();
// 从 request 中获得 Accept-Language 语言信息
if (defaultLocale != null && request.getHeader("Accept-Language") == null) {
return defaultLocale;
}
// 得到请求中国际化的信息
Locale requestLocale =