spring的本地化解析器

本地化解析器 - 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"></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会将网站语言修改为荷兰语。