spring boot实现国际化（全面代码）

前言

这是我的第一篇博客，也是原文是大神“刘东”的代码。之所以重新再次创建在自己的博客，第一是想保存一篇在成长中解决了自己难题的文章，其次是把大神的代码拷贝到本地时遇到了一些小问题，但是后来解决了，所以对大神的代码小有改动作以保存。

这Demo是spring boot +template模板作为示例，大神说：在项目开发中，可能遇到需要国际化，而支持国际化确是一件很头疼的事，但是spring boot给出了一个非常理想和方便的方案。

一、准备工作

pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>spring-boot-14</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>

    <name>spring-boot-14</name>
    <description>Demo project for Spring Boot</description>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>1.5.3.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-thymeleaf</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>


</project>

application.properties

spring.thymeleaf.suffix=.html
spring.thymeleaf.mode=HTML5
spring.thymeleaf.encoding=UTF-8
spring.thymeleaf.content-type=text/html
spring.thymeleaf.cache=false

spring.messages.basename=i18n/messages

SpringBootLanguageApplication.java

package com.language;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class SpringBootLanguageApplication {

    public static void main(String[] args) {
        SpringApplication.run(SpringBootLanguageApplication.class, args);
    }
}

创建国际化配置文件：LocaleConfig.java

package com.language.config;

import java.util.Locale;

import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.LocaleResolver;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter;
import org.springframework.web.servlet.i18n.LocaleChangeInterceptor;
import org.springframework.web.servlet.i18n.SessionLocaleResolver;

@Configuration
@EnableAutoConfiguration
@ComponentScan
public class LocaleConfig extends WebMvcConfigurerAdapter {

    @Bean
    public LocaleResolver localeResolver() {
        SessionLocaleResolver slr = new SessionLocaleResolver();
        // 设置默认语言(此处可不用设置，浏览器会根据浏览器的区域参数默认选择语言包)
        slr.setDefaultLocale(Locale.US);
        return slr;
    }

    @Bean
    public LocaleChangeInterceptor localeChangeInterceptor() {
        LocaleChangeInterceptor lci = new LocaleChangeInterceptor();
        // 设置参数名
        lci.setParamName("lang");
        return lci;
    }

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(localeChangeInterceptor());
    }
}

演示火狐浏览器： firefox浏览器修改区域语言；
打开firefox浏览器访问http://127.0.0.1:8080/hello （计算机系统语言是中文的），应该是看到如下信息：
欢迎你登录到阿里巴巴 网站（中文）

那么我们修改我们的语言呢，在浏览器地址栏输入如下信息：

about:config

回车进入一个警告页面，然后点击按钮【我保证会小心】（注：由于版本不一样，可能会有些不一样，但是操作是一样的）。

在搜索框输入accept，然后找到intl.accept_languages修改对应的值，我这里原本是：
zh-cn, zh, en-us, en
为了看到效果，修改为：
en-us, en
修改完之后，刷新http://127.0.0.1:8080/index ，可以看到信息：
welcome to login to alibaba website(English)
好了，没有什么特殊的需求的，记得把intl.accept_languages修改为原来的值。

说明：

网页切换语言
于url上拼接属性 如下

?lang=en_US

该属性会存于cookie中，网页跳转将继续使用该语言：

Cookie:JSESSIONID=9EFE46F94D0F89A9E7FBD1073631DEC5; hudson_auto_refresh=false; ACEGI_SECURITY_HASHED_REMEMBER_ME_COOKIE=d3A3NzE5MTAwMTI6MTQ4MjczNzMxNjkxMjpkZDQ2MzM2NTc3ZmM3ZjU1Y2UzYjk2YWU2NjkwNjlmMjNmMjQwMDhhZmRlOGQxOWQ0YzRjOTM4ZTAwNzYwZmM5; jenkins-timestamper-offset=-28800000; org.springframework.web.servlet.i18n.CookieLocaleResolver.LOCALE=en_US

最后一行即为存于cookie中的 语言属性

MainController.java

@GetMapping("/index")
    public String index() {
        System.out.println("============国际化=============");
        return "index";
    }

在resources目录增加两个properties文件，分别为：

messages_en_US.properties:

welcome= welcome to login to alibabawebsite(English)

messages_zh_CN.properties:（如果填写中文或其他国家文字不正确显示，可以右键此文件选择properties——》修改字符编码为UTF-8）

welcome = 欢迎登录到阿里巴巴（中文）

message.properties:

此处看你选择那种语言设置为默认语言

 

二、前端调用

在thymeleaf模板引擎中使用#{}的标签就能调用messages中的内容了

index.html：

<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8"/>
<title>spring boot——国际化</title>
</head>
<body>
  <h1>spring boot——国际化</h1>
    <h4>
        <a href="http://www.cnblogs.com/GoodHelper/">from</a>
    </h4>
    <br />
    <br />
    <a href="?lang=en_US">English(US)</a>
    <a href="?lang=zh_CN">简体中文</a>
   
    <br />
    
    <p><label th:text="#{welcome}"></label></p>
    
</body>
</html>

 三、附上项目结构目录

四、附加其他优秀文章

大神详解国际化：http://doc.okbase.net/IXHONG/archive/263154.html（推荐）

刘东原文国际化：https://www.cnblogs.com/GoodHelper/p/6824492.html（简洁）