13.6. 本地化解析器 - Spring Framework reference 2.0.5 参考手册中文版

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会将网站语言修改为荷兰语。

13.6. 本地化解析器 - Spring Framework reference 2.0.5 参考手册中文版