Springboot 支持国际化顾名思义就是除了支持中文字体还支持英文字体及其他
上图便于理解
可以发现,我点击下方的english标签则整体字体切换为英文 点击下方的中文标签则整体字体切换为中文
此篇文章就是来实现这个功能的,具体怎么做,我们一步一步做。
第一步:编写国际化配置文件
1.首先我们先解决idea的properties的编码问题
如下图所示设置
2.在resources资源文件下新建一个i18n目录,建立一个login.propetries文件(一定要放到resources下否则会乱码),还有一个login_zh_CN.properties,发现
IDEA自动识别了我们要做国际化操作;
3.编写配置
login.properties : 默认
login.btn=登录
login.password=密码
login.remember=记住我
login.tip=请登录
login.username=用户名
英文:
login.btn=Sign in
login.password=Password
login.remember=Remember me
login.tip=Please sign in
login.username=Username
中文:
login.btn=登录
login.password=密码
login.remember=记住我
login.tip=请登录
login.username=用户名
第二步:利用Springboot自动配置国际化
读源码
MessageSourceAutoConfiguration 里面有一个方法,这里发现SpringBoot已经自动配置好了管理我们国际化资源文件的组件 ResourceBundleMessageSource;
public class MessageSourceAutoConfiguration {
private static final Resource[] NO_RESOURCES = new Resource[0];
public MessageSourceAutoConfiguration() {
}
@Bean
@ConfigurationProperties(prefix = "spring.messages") //我们的配置文件可以直接放在类路径下叫: messages.properties, 就可以进行国际化操作了
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(prop
erties.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;
}
}
发现缘由了,我们在application.yml 中设置配置
spring:
messages:
basename: i18n.login #国际化 配置真实位置
encoding: UTF-8
第三步:重写webmvc自动配置文件 实现通过点击标签 自动切换中文英文
1.读源码
在WebMvcAutoConfiguration.class 中我们找到LocaleResolver()方法 顾名思义区域解释器
我们查看此方法
public LocaleResolver localeResolver() {
if (this.mvcProperties.getLocaleResolver() == org.springframework.boot.autoconfigure.web.servlet.WebMvcProperties.LocaleResolver.FIXED) {
return new FixedLocaleResolver(this.mvcProperties.getLocale());
} else {
AcceptHeaderLocaleResolver localeResolver = new AcceptHeaderLocaleResolver();
localeResolver.setDefaultLocale(this.mvcProperties.getLocale());
return localeResolver;
}}
这个方法的意思就是 首先springboot会检查看有没有用户配置的LocaleResolver 没有的话就用默认的
我们点进去查看AcceptHeaderLocaleResolver
发现此方法
public Locale resolveLocale(HttpServletRequest request) {
Locale defaultLocale = this.getDefaultLocale();
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;
} }}
这就是实现方法
2.实现
通过阅读源码我们得到了大体思路
我们自定义MyLocaleResolver 实现LocaleResolver接口 重写resolveLocale()方法 模仿上面实现方法写就ok了
以下是实现代码
/**
* @Author MRyan
* @Date 2020/2/5 15:26
* @Version 1.0
*/
public class MyLocaleResolver implements LocaleResolver {
//解析请求
@Override
public Locale resolveLocale(HttpServletRequest request) {
//获取请求中的参数链接
String language = request.getParameter("l");//前端传递的参数用来判断中文还是英文
Locale locale = Locale.getDefault();//获取默认Locale
if (!StringUtils.isEmpty(language)) {//判断传递参数是否为空
//zh_CN
String[] split = language.split("_");//前后分割 分开获取国家和地区
//国家,地区
locale = new Locale(split[0], split[1]);
}
return locale;
}
@Override
public void setLocale(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse, Locale locale) {
}}
自动转配到我们自定义的configurer,并且我们对index.html进行拦截返回index页面 (index.html传参)
/**
* @Author MRyan
* @Date 2020/2/5 15:37
* @Version 1.0
*/@Configuration
public class MyMvcConfig implements WebMvcConfigurer {
/***
* 自定义视图解释器
* @param registry
*/
@Override
public void addViewControllers(ViewControllerRegistry registry) {
registry.addViewController("/").setViewName("index");
registry.addViewController("index.html").setViewName("index");
}
/***
* 自定义国际化组件生效!
* @return
*/
@Bean
public LocaleResolver localeResolver(){
return new MyLocaleResolver();
}}
(完结)第四步:修改前端代码
前端全部代码如下:
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
<meta name="description" content="">
<meta name="author" content="">
<title>国际化</title>
<!-- Bootstrap core CSS -->
<link th:href="@{/css/bootstrap.min.css}" rel="stylesheet">
<!-- Custom styles for this template -->
<link th:href="@{/css/signin.css}" rel="stylesheet">
</head>
<body class="text-center">
<form class="form-signin" action="dashboard.html">
<img class="mb-4" src="/img/bootstrap-solid.png" alt="" width="72" height="72">
<h1 class="h3 mb-3 font-weight-normal" th:text="#{login.tip}"></h1>
<label class="sr-only" th:text="#{login.username}"></label>
<input type="text" class="form-control" th:placeholder="#{login.username}" required="" autofocus="">
<label class="sr-only" th:text="#{login.password}"></label>
<input type="password" class="form-control" th:placeholder="#{login.password}" required="">
<div class="checkbox mb-3">
<label>
<input type="checkbox" value="remember-me" th:text="#{login.remember}">
</label>
</div>
<button class="btn btn-lg btn-primary btn-block" type="submit" th:text="#{login.btn}"></button>
<p class="mt-5 mb-3 text-muted">© 2019-2020</p>
<a class="btn btn-sm" th:href="@{/index.html(l='zh_CN')}">中文</a>
<a class="btn btn-sm" th:href="@{/index.html(l='en_US')}">English</a>
</form>
</body>
</html>
用#来解析国际化
//这里传入参数不需要使用 ? 使用 (key=value)
<a class="btn btn-sm" th:href="@{/index.html(l='zh_CN')}">中文</a>
<a class="btn btn-sm" th:href="@{/index.html(l='en_US')}">English</a>
到这里我们就简单实现了国际化功能
我们会发现不难但是很繁琐
可以自行扩展