13.6. 本地化解析器

Spring Framework

13.6. 本地化解析器

Spring架构的绝大部分都支持国际化,Spring的web框架也不例外。DispatcherServlet 允许你使用客户端本地化信息自动解析消息。 这个工作由LocaleResolver完成。

当收到请求时,DispatcherServlet寻找一个本地化解析器,如果找到它就使用它设置本地化信息。 通过RequestContext.getLocale()方法, 你总可以获取由本地化解析器解析的客户端的本地化信息。

除了自动的本地化解析以外,你还可以将一个拦截器置于处理器映射中(参考 第 13.4.3 节 “拦截器(HandlerInterceptor)”),以便在某种环境下可以改变本地化信息,例如,可以基于请求中的参数变更本地化信息。

本地化解析器和拦截器都定义在org.springframework.web.servlet.i18n包中,你可以在应用的上下文中配置它们。下文介绍了一些Spring提供的本地化解析器。

13.6.1. AcceptHeaderLocaleResolver

这个本地化解析器检查请求中客户端浏览器发送的accept-language 信息,通常这个HTTP Header包含客户端操作系统的本地化信息。

13.6.2. CookieLocaleResolver

这个本地化解析器检查客户端中的Cookie是否包含本地化信息。如果有的话,就使用。当你配置这个解析器的时候,你可以指定cookie名,以及cookie的最长生存期(Max Age)。 下面这个例子定义了一个CookieLocaleResolver

<bean id="localeResolver">

    <property name="cookieName" value="clientlanguage"/>
    
    <!-- in seconds. If set to -1, the cookie is not persisted (deleted when browser shuts down) -->
    <property name="cookieMaxAge" value="100000">

</bean>

表 13.6. CookieLocaleResolver的属性

属性 缺省值 描述
cookieName classname + LOCALE cookie的名字。
cookieMaxAge Integer.MAX_INT cookie在客户端存在的最长时间。如果该值是-1,这个cookie只被保留在内存中,当客户关闭浏览器时,这个cookie就不存在了。
cookiePath / 通过这个参数,你可以将该cookie的作用限制在一部分特定的。具体地说,只有该目录(cookiePath)及其子目录下的页面可以使用这个cookie。

13.6.3. SessionLocaleResolver

SessionLocaleResolver允许你从用户请求相关的session中获取本地化信息。

13.6.4. LocaleChangeInterceptor

你可以使用LocaleChangeInterceptor修改本地化信息。这个拦截器需要被添加到处理器映射中(参考第 13.4 节 “处理器映射(handler mapping)”)。它可以侦测请求中某个特定的参数,然后调用上下文中的LocaleResolver中的 setLocale()方法,相应地修改本地化信息。

<bean id="localeChangeInterceptor"
      class="org.springframework.web.servlet.i18n.LocaleChangeInterceptor">
    <property name="paramName" value="siteLanguage"/>
</bean>

<bean id="localeResolver"
      class="org.springframework.web.servlet.i18n.CookieLocaleResolver"/>

<bean id="urlMapping"
      class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
    <property name="interceptors">
        <list>
            <ref bean="localeChangeInterceptor"/>
        </list>
    </property>
    <property name="mappings">
        <value>/**/*.view=someController</value>
    </property>
</bean>

在上面这个例子中,所有对*.view资源的请求,只要包含参数siteLanguage,都会改变本地化信息。比如下面这个请求http://www.sf.net/home.view?siteLanguage=nl会将网站语言修改为荷兰语。