©
本文档使用 PHP中文网手册 发布
Spring架构的绝大部分都支持国际化,Spring的web MVC框架也不例外。
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" class="org.springframework.web.servlet.i18n.CookieLocaleResolver">
<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.5. 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 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
会将网站语言修改为荷兰语。