Spring MVC(十五)--SpringMVC国际化配置项

Spring MVC中，当DispatcherServlet初始化的时候，会解析一个LocaleResolver接口的实现类，这个实现类就是用来解析国际化的。

一、国际化解析器

Spring MVC中提供了以下四个实现类：

• AcceptHeaderLocaleResolver：spring默认的区域解析器，它通过校验http请求的accept-language头部来解析区域。这个头是由web浏览器根据底层操作系统的区域设置，这个区域无法改变用户的区域，所以只能根据操作系统设置而获取，一般不使用；
• FixedLocaleResolver：使用固定的locale国际化，也是不可修改；
• CookieLocaleResolver：根据cookie数据获取国际化数据，但是如果用户禁止或没有设置cookie，就会根据http头中的accept-language来获取；
• SessionLocaleResolver：根据session进行国际化，即根据用户设置session的变量进行读取，所以它是可变的，也是使用最多的；

为了修改国际化，Spring MVC还提供了一个拦截器－LocaleChangeInterceptor，通过它可以获取参数，然后根据参数来改变区域；

它的配置方式如下：

1、JAVA配置方式

1⃣️配置CookieLocaleResolver

/**
     * 配置CookieLocaleResolver 
     * bean名称必须是localeResolver
     * 
     * @return
     */
    @Bean(name = "localeResolver")
    public CookieLocaleResolver initCookieLocaleResolver() {
        CookieLocaleResolver clr = new CookieLocaleResolver();
        // 设置cookie名称
        clr.setCookieDomain("lang");
        // 设置超时秒数
        clr.setCookieMaxAge(3600);
        // 默认使用简体中文
        clr.setDefaultLocale(Locale.SIMPLIFIED_CHINESE);
        return clr;
    }

2⃣️配置SessionLocaleResolver

/**
     * 配置SessionLocaleResolver 
     * bean名称必须是localeResolver
     * 
     * @return
     */
    @Bean(name = "localeResolver")
    public SessionLocaleResolver initSessionLocaleResolver() {
        SessionLocaleResolver slr = new SessionLocaleResolver();
        // 默认使用简体中文
        slr.setDefaultLocale(Locale.SIMPLIFIED_CHINESE);
        return slr;
    }

2、XML配置方式

1⃣️配置CookieLocaleResolver

<!--第一种：配置cookie国际化解析器 -->
    <bean id="localeResolver"
        class="org.springframework.web.servlet.i18n.CookieLocaleResolver">
        <!-- cookie变量的名称 -->
        <property name="cookieName" value="lang" />
        <!-- cookie超时时间 -->
        <property name="cookieMaxAge" value="20" />
        <!-- 默认使用简体中文 -->
        <property name="defaultLocale" value="zh_CN" />
    </bean>

2⃣️配置SessionLocaleResolver

<!--第一种：配置session国际化解析器 -->
    <bean id="localResolver"
        class="org.springframework.web.servlet.i18n.SessionLocaleResolver">
        因为session有其自身定义的超时时间和编码，所以此处不需要设置
        <property name="defaultLocale" value="zh_CN" />
    </bean>

注意⚠️：

• 不管配置哪种解析器，bean的名称都必须是localeResolver，这是Spring MVC默认的名称，不能修改，否则找不到；
• session有其自定义的超时时间，所以无需配置；

二、国际化文件加载

在实现国际化之前，首先要加载相关的资源文件，即消息源，这个功能由Spring MVC提供的MessageSource接口完成，并且有四个非抽象的实现类：

• StaticMessageSource：静态消息源；
• DelegatingMessageSource：实现的是代理功能；
• ResourceBundleMessageSource：由JDK提供的Bundle实现，只能把文件放置在对应的类路径下，不具备热加载功能，只有重启系统才能重新加载；
• ReloadavleResourceBundleMessageSource：可以把文件放置在任何地方，并且在不重启系统的前提下也能重新加载资源文件，这样就可以在程序运行期修改并重新加载资源文件；

其实在配置国际化解析器之前还要配置消息源，下面介绍如何配置，还是有两种方式：

1、JAVA方式配置消息源

1⃣️配置ResourceBundleMessageSource

/**
     * 配置ResourceBundleMessageSource消息源 
     * bean名称必须为messageSource
     * 
     * @return
     */
    @Bean(name = "messageSource")
    public MessageSource initResourceBundleMessageSource() {
        ResourceBundleMessageSource rbms = new ResourceBundleMessageSource();
        rbms.setDefaultEncoding("UTF-8");
        rbms.setBasename("msg");
        return rbms;
    }

2⃣️配置ReloadableResourceBundleMessageSource

/**
     * 配置ReloadableResourceBundleMessageSource消息源 
     * bean名称必须为messageSource
     * 
     * @return
     */
    @Bean(name = "messageSource")
    public MessageSource initReloadableResourceBundleMessageSource() {
        ReloadableResourceBundleMessageSource rrbms = new ReloadableResourceBundleMessageSource();
        rrbms.setDefaultEncoding("UTF-8");
        // 因为是热加载，所以需要加上classpath
        rrbms.setBasename("classpath:msg");
        // 设置刷新的秒数，即多长时间刷新一次
        rrbms.setCacheSeconds(1800);
        // 设置刷新的毫秒数
        rrbms.setCacheMillis(1800000);
        return rrbms;
    }

2、XML方式配置消息源

1⃣️配置ResourceBundleMessageSource

<!--第一种方式：配置ResourceBundleMessageSource：这种方式只能把资源文件放到指定的路径下，不能热加载,需要重启系统才能加载它 -->
    <bean id="messageResource"
        class="org.springframework.context.support.ResourceBundleMessageSource">
        <property name="defaultEncoding" value="UTF-8" />
        <property name="basename" value="msg" />
    </bean>

2⃣️配置ReloadableResourceBundleMessageSource

<!--第二种方式：配置ReloadableResourceBundleMessageSource：这种方式只能把资源文件放到任何位置，不需要重启就能加载文件，并且可以设置刷新时间 -->
    <bean id="messageSource"
        class="org.springframework.context.support.ReloadableResourceBundleMessageSource">
        <!-- 默认编码方式 -->
        <property name="defaultEncoding" value="UTF-8" />
        <!-- 资源文件的前缀:多了一个classpath，如果资源文件在一个文件夹下，还要加上文件夹路径，否则报错 -->
        <property name="basename" value="classpath:message/msg" />
        <!-- 刷新时间 -->
        <property name="cacheSeconds" value="3600" />
    </bean>

需要注意以下几点：

• 无论何种方式配置何种消息源，bean的名称必须是messageSource;
• ReloadableResourceBundleMessageSource可以热加载，所以需要配置刷新时间，并且配置资源文件的前缀时需要加classpath，如果资源文件在classpath的某个文件夹下，还需要加上文件夹的名称；

三、配置拦截器

通过请求参数去改变国际化的值时，可以使用Spring提供的拦截器LocaleChangeInterceptor，它继承了HandlerInterceptorAdapter，通过覆盖它的preHandle方法，然后使系统所配置的LocaleResolver实现国际化，这个一般是配置在Spring MVC的配置文件中：

<!-- 配置国际化拦截器 -->
    <mvc:interceptors>
        <mvc:interceptor>
            <mvc:mapping path="/**" />
            <bean class="org.springframework.web.servlet.i18n.LocaleChangeInterceptor">
                <property name="paramName" value="language" />
            </bean>
        </mvc:interceptor>
    </mvc:interceptors>

其中：

• <mvc:mapping>的path属性值配置成/**，这样就能拦截所有/请求及其子路径中的请求了；
• 拦截器的属性paramName的值就是url中传过来的参数，如language=zh_CN或language=en_US等；

至此，国际化中所有的配置都已经介绍完毕，下一篇文章将举一个实现过程的例子。