SpringBoot系列(九)国际化

快来打我* 2022-05-31 07:51 362阅读 0赞

## 一、国际化配置文件定义 ##

> springboot默认就支持国际化的，而且不需要你过多的做什么配置，只需要在resources/下定义国际化配置文件即可，注意名称必须以messages开发。

*  messages.properties （默认，当找不到语言的配置的时候，使用该文件进行展示）。
 *  messages\_zh\_CN.properties（中文）
 *  messages\_en\_US.properties（英文）

英文配置如下：

welcome to login to csdn(English)

JSP页面定义：

<%@ taglib prefix="spring" uri="http://www.springframework.org/tags" %>
    <html>
    <%@page contentType="text/html; charset=UTF-8" %>
    <head>
        <title>i18n国际化</title>
    </head>
    <body>
        <spring:message code="welcome"></spring:message>
    </body>
    </html>

> 重新启动项目，访问渲染该JSP页面的路径即可；将会显示welcome to login to csdn(English)，如还是显示中文，继续看下面。

--------------------

## 二、默认区域解析器 ##

> 为了让web应用程序支持国际化，必须识别每个用户的首选区域，并根据这个区域显示内容。在Spring MVC应用程序中，用户的区域是通过区域解析器来识别的，它必须是实现LocaleResolver接口。Spring MVC提供了几个LocaleResolver实现，让你可以按照不同的条件来解析区域。除此之外，你还可以实现这个接口创建自己的区域解析器。如果没有做特殊的处理的话，Spring 采用的默认区域解析器是AcceptHeaderLocaleResolver。它通过检验HTTP请求的头部信息accept-language来解析区域。这个头部是由用户的wb浏览器底层根据底层操作系统的区域设置进行设定的。请注意，这个区域解析器无法改变用户的区域，因为它无法修改用户操作系统的区域设置。

**既然无法修改，那么我们的代码怎么测试呢？请看如下内容？**

**firefox浏览器修改区域语言**

在浏览器地址栏输入如下信息：

about:config

确认警告页面后，在搜索框输入accept，然后找到intl.accept\_languages修改对应的值，我这里原本是：

zh-cn, zh, en-us, en

为了看到效果，修改为：

en-us, en

测试完后，记得把intl.accept\_languages修改为原来的值。

**注意：chrome浏览器修改区域语言挺麻烦的，可以实现，自行百度；**

--------------------

## 三、修改默认国际化配置文件前缀 ##

> SpringBoot默认的文件名称前缀是messages\_xx.properties，那么如何修改这个名称和路径呢？

########################################################
    
    ### i18n setting. ######################################################## #指定message的basename，多个以逗号分隔，如果不加包名的话，默认从classpath路径开始，默认: messages spring.messages.basename=i18n/messages #设定加载的资源文件缓存失效时间，-1的话为永不过期，默认为-1 spring.messages.cache-seconds= 3600 #设定Message bundles的编码，默认: UTF-8 #spring.messages.encoding=UTF-8

--------------------

## 四、代码中获取国际化信息 ##

@Autowired
    private MessageSource messageSource;

> 需要注意的是messageSource是org.springframework.context.MessageSource

那么怎么使用了，在使用前我们需要先知道一个知识点，如何得到当前请求的Locale

那么怎么获取呢，有两种获取方式：

第一种方式是：

Locale locale = LocaleContextHolder.getLocale();

第二种方式是：

Locale locale= RequestContextUtils.getLocale(request);

完整代码如下：

String msg = messageSource.getMessage("welcome",null,locale);

--------------------

## 五、区域解析器类别 ##

> 前面提到过，Spring MVC提供了几个LocaleResolver实现，让你可以按照不同的条件来解析区域。除此之外，你还可以实现这个接口创建自己的区域解析器。如果没有做特殊的处理的话，Spring 采用的默认区域解析器是AcceptHeaderLocaleResolver。

**1、AcceptHeaderLocaleResolver**

我们在之前说过，我们只所以可以看到国际化的效果是因为有一个区域解析器在进行处理。默认的区域解析器就是AcceptHeaderLocaleResolver。我们简单说明这个解析器：

Spring采用的默认区域解析器是AcceptHeaderLocaleResolver。它通过检验HTTP请求的accept-language头部来解析区域。这个头部是由用户的web浏览器根据底层操作系统的区域设置进行设定。请注意，这个区域解析器无法改变用户的区域，因为它无法修改用户操作系统的区域设置。

**2、SessionLocaleResolver**

会话区域解析器也就是说，你设置完只针对当前的会话有效，session失效，还原为默认状态。那么这个具体怎么操作呢？具体操作起来也是很简单的，我们需要在我们的启动类App.java（按你的实际情况进行修改）配置区域解析器为SessionLocaleResolver，具体和下面的CookieLocaleResolver类似。

**3、CookieLocaleResolver**

Cookie区域解析器也就是说，你设置完针对cookie生效，session失效。在SpringBoot启动时加载配置类里配置区域解析器为CookieLocaleResolver，具体代码如下：

@Configuration
    public class i18nConfig { 
    
        @Bean
        public LocaleResolver localeResolver() {
    
            CookieLocaleResolver localeResolver = new CookieLocaleResolver();
    
            localeResolver.setCookieName("localeCookie");
    
            //设置默认区域
            localeResolver.setDefaultLocale(Locale.ENGLISH);
    
            localeResolver.setCookieMaxAge(3600);//设置cookie有效期.
    
            return localeResolver;
        }
    }

> **页面做国际化切换开关，修改浏览器Cookie中localeCookie的值**

**4、FixedLocaleResolver**

一直使用固定的Local,改变Local 是不支持的。一旦启动时设定，则是固定的，无法改变Local。

**5、使用参数修改用户的区域**

> 除了显式调用LocaleResolver.setLocale()来修改用户的区域之外，还可以将LocaleChangeInterceptor拦截器应用到处理程序映射中，它会发现当前HTTP请求中出现的特殊参数。其中的参数名称可以通过拦截器的paramName属性进行自定义。如果这种参数出现在当前请求中，拦截器就会根据参数值来改变用户的区域。

拦截器对象配置，生成bean对象后，加入到SpringBoot的拦截器配置里去（略）

@Bean
        public LocaleChangeInterceptor localeChangeInterceptor() {
    
            LocaleChangeInterceptor lci = new LocaleChangeInterceptor();
    
            // 设置请求地址的参数,默认为：locale
            lci.setParamName(LocaleChangeInterceptor.DEFAULT_PARAM_NAME);
    
            return lci;
        }

**注意：这个是可以和会话区域解析器以及Cookie区域解析器一起使用的，但是不能和FixedLocaleResolver一起使用，否则会抛出异常信息。**

**参考文章**：([http://blog.csdn.net/linxingliang/article/details/52350238][http_blog.csdn.net_linxingliang_article_details_52350238])

[http_blog.csdn.net_linxingliang_article_details_52350238]: http://blog.csdn.net/linxingliang/article/details/52350238