SpringMVC（12） - 使用区域设置

素颜马尾好姑娘i 2022-04-16 06:06 424阅读 0赞

参考：[https://docs.spring.io/spring/docs/4.3.20.RELEASE/spring-framework-reference/htmlsingle/\#mvc-localeresolver][https_docs.spring.io_spring_docs_4.3.20.RELEASE_spring-framework-reference_htmlsingle_mvc-localeresolver]

Spring的体系结构的大多数部分都支持国际化，就像Spring Web MVC框架一样。 DispatcherServlet可以使用客户端的区域设置自动解析消息。这是通过LocaleResolver对象完成的。

当请求进入时，DispatcherServlet会查找区域设置解析器，如果找到它，则会尝试使用它来设置区域设置。使用RequestContext.getLocale()方法，始终可以检索由区域设置解析器解析的区域设置。

除了自动locale解析之外，还可以将拦截器附加到处理器映射以在特定情况下更改locale，例如，基于请求中的参数。

Locale解析器和拦截器在org.springframework.web.servlet.i18n包中定义，并以正常方式在应用程序上下文中进行配置。以下是Spring中包含的区域设置解析器的选择。

1.  获取时区信息  
除了获取客户端的区域外，了解其时区通常也很有用。 LocaleContextResolver接口提供LocaleResolver的扩展，允许解析器提供更丰富的LocaleContext，其中可能包含时区信息。

可以使用RequestContext.getTimeZone()方法获取用户的TimeZone。时区信息将由Spring的ConversionService注册的Date/Time  Converter和Formatter对象自动使用。

2. AcceptHeaderLocaleResolver  
该区域设置解析器检查客户端（例如，Web浏览器）发送的请求中的accept-language请求头。通常，此请求头字段包含客户端操作系统的区域设置信息。此解析程序不支持时区信息。

3. CookieLocaleResolver  
此区域设置解析器检查客户端上可能存在的Cookie，以查看是否指定了Locale或TimeZone。如果是，则使用指定的详细信息。使用此区域设置解析器的属性，可以指定cookie的名称以及最大存活时间。在下面找到定义CookieLocaleResolver的示例。

**CookieLocaleResolver属性**

<table> 
 <thead> 
  <tr> 
   <th>属性</th> 
   <th>默认值</th> 
   <th>描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td style="vertical-align:top;"> <p>cookieName</p> </td> 
   <td style="vertical-align:top;"> <p>classname + LOCALE</p> </td> 
   <td style="vertical-align:top;"> <p>cookie的名称</p> </td> 
  </tr> 
  <tr> 
   <td style="vertical-align:top;"> <p>cookieMaxAge</p> </td> 
   <td style="vertical-align:top;"> <p>Servlet container default</p> </td> 
   <td style="vertical-align:top;"> <p>Cookie在客户端上存在的最长时间。 如果指定-1，则不会保留cookie;它只有在客户端关闭浏览器之后才可用。</p> </td> 
  </tr> 
  <tr> 
   <td style="vertical-align:top;"> <p>cookiePath</p> </td> 
   <td style="vertical-align:top;"> <p>/</p> </td> 
   <td style="vertical-align:top;">限制cookie对网站某个部分的可见性。 指定cookiePath时，cookie只对该路径及其下方的路径可见。</td> 
  </tr> 
 </tbody> 
</table>

4. SessionLocaleResolver

SessionLocaleResolver允许从可能与用户请求关联的会话中检索Locale和TimeZone。 与CookieLocaleResolver相比，此策略将本地选择的区域设置存储在Servlet容器的HttpSession中。 因此，这些设置对于每个会话来说都是临时的，因此在每个会话终止时都会丢失。

请注意，与Spring Session项目等外部会话管理机制没有直接关系。 此SessionLocaleResolver将简单地针对当前的HttpServletRequest评估和修改相应的HttpSession属性。

5. LocaleChangeInterceptor

可以通过将LocaleChangeInterceptor添加到其中一个处理器映射来更改区域设置。 它将检测请求中的参数并更改区域设置。 它在LocaleResolver上调用setLocale()，它也存在于上下文中。

以下示例显示所有请求\*.view资源，同时也包含名为siteLanguage的参数时，将更改区域设置。 因此，例如，对以下URL的请求http://www.sf.net/home.view?siteLanguage=nl会将站点语言更改为荷兰语。

<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>

[https_docs.spring.io_spring_docs_4.3.20.RELEASE_spring-framework-reference_htmlsingle_mvc-localeresolver]: https://docs.spring.io/spring/docs/4.3.20.RELEASE/spring-framework-reference/htmlsingle/#mvc-localeresolver