Spring架构的绝大部分都支持国际化,Spring的web框架也不例外。DispatcherServlet
允许你使用客户端本地化信息自动解析消息。 这个工作由LocaleResolver
完成。
当收到请求时,DispatcherServlet
寻找一个本地化解析器,如果找到它就使用它设置本地化信息。 通过RequestContext.getLocale()
方法, 你总可以获取由本地化解析器解析的客户端的本地化信息。
除了自动的本地化解析以外,你还可以将一个拦截器置于处理器映射中(参考 第 13.4.3 节 “拦截器(HandlerInterceptor
)”),以便在某种环境下可以改变本地化信息,例如,可以基于请求中的参数变更本地化信息。
本地化解析器和拦截器都定义在org.springframework.web.servlet.i18n
包中,你可以在应用的上下文中配置它们。下文介绍了一些Spring提供的本地化解析器。
这个本地化解析器检查请求中客户端浏览器发送的accept-language
信息,通常这个HTTP Header包含客户端操作系统的本地化信息。
这个本地化解析器检查客户端中的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。 |
你可以使用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
会将网站语言修改为荷兰语。