spring的本地化解析器

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"></bean>

    <property value="clientlanguage" name="cookieName"></property>
    
    <!-- -->


    <property value="100000" name="cookieMaxAge">

</property>

表 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 class="org.springframework.web.servlet.i18n.LocaleChangeInterceptor" id="localeChangeInterceptor"></bean>
    <property value="siteLanguage" name="paramName"></property>


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

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

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