使用Thymeleaf配置国际化页面

news2024/10/6 12:30:21

在国际化（i18n，即 Internationalization 的缩写，其中“i”和“n”之间有18个字母）的上下文中，Thymeleaf 和 Spring Boot 可以很容易地一起工作，以支持多种语言的页面显示。下面是如何在 Spring Boot 应用中使用 Thymeleaf 来配置国际化页面的步骤：

1、创建消息源文件

在src/main/resources目录下创建消息源文件。通常，我们会为每个支持的语言创建一个文件，例如：

login.properties （无语言）
login_en_US.properties（英文）
login_zh_CN.properties（简体中文）

文件 login.properties

login.tip=请登录
login.username=用户名
login.password=用户密码
login.remember=记住我
login.button=登录

文件 login_en_US.properties

login.tip=Please sign in
login.username=Username
login.password=Password
login.remember=Remember me
login.button=Login

文件 login_zh_CN.properties

login.tip=请登录
login.username=用户名
login.password=用户密码
login.remember=记住我
login.button=登录

创建完的目录结构
在这里插入图片描述

2、编写配置文件

在 Spring Boot 全局配置文件中，配置自定义的国际资源文件的基本名，代码如下：
文件 application.properties

spring.messages.basename=i18n.login

（当指定多个资源文件时，用逗号分隔），例如spring.messages.basename=i18n.login,i18n.message，当使用message.properties国际化文件，可以省略基本名。

3、创建区域信息解析器

在config包下创建一个区域信息解析器 MyLocalResolver，代码如下

@Configuration
public class MyLocalResolver implements LocaleResolver {
    @Override
    public Locale resolveLocale(HttpServletRequest request) {
        String l = request.getParameter("l");
        String header = request.getHeader("Accept-Language");
        Locale locale=null;
        if(!StringUtils.isEmpty(l)){
            String[] split = l.split("_");
            locale=new Locale(split[0],split[1]);
        }else {
            String[] splits = header.split(",");
            String[] split = splits[0].split("-");
            locale=new Locale(split[0],split[1]);
        }
        return locale;
    }

    @Override
    public void setLocale(HttpServletRequest request, HttpServletResponse response, Locale locale) {

    }

    /**
     * 自定义国际化主键就生效了
     */
    @Bean
    public LocaleResolver localeResolver(){
        return new MyLocalResolver();
    }
}

4、页面国际化

<!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">
    <title>用户登录界面</title>
    <link th:href="@{/login/css/bootstrap.min.css}" rel="stylesheet">
    <link th:href="@{/login/css/signin.css}" rel="stylesheet">
</head>
<body class="text-center">
<!--  用户登录form表单 -->
<form class="form-signin">
    <img class="mb-4" th:src="@{/login/img/login.jpg}" width="72" height="72">
    <h1 class="h3 mb-3 font-weight-normal" th:text="#{login.tip}" >请登录</h1>
    <input type="text" class="form-control" th:placeholder="#{login.username}" required="" autofocus="">
    <input type="password" class="form-control" th:placeholder="#{login.password}" required="">
    <div class="checkbox mb-3">
        <label>
            <input type="checkbox" value="remember-me"  > [[#{login.remember}]]
        </label>
    </div>
    <button class="btn btn-lg btn-primary btn-block" type="submit" th:text="#{login.button}">登录</button>
    <p class="mt-5 mb-3 text-muted">© <span th:text="${currentYear}">2018</span>-<span th:text="${currentYear}+1">2019</span></p>
    <!--thymeleaf 模板引擎的参数用（）代替 ？-->
    <a class="btn btn-sm" th:href="@{/toLoginPage(l='zh_CN')}">中文</a>|
    <a class="btn btn-sm" th:href="@{/toLoginPage(l='en_US')}">English</a>
</form>
</body>
</html>