Java for Web学习笔记（七四）：国际化i18n（2）Locale Resolver

SessionLocaleResolver

　　判断locale，采用HTTP请求的Accept-Language，如果我们希望还能通过其他途径来设定locale，需要Locale Resolver，即解析出合适的locale，这样，我们就可以允许用户变更语言，而不局限于浏览器的设置。Spring提供了org.springframework.web.servlet.i18n.SessionLocaleResolver，依次检查：

1. 首先检查session中的SessionLocaleResolver.LOCALE_SESSION_ATTRIBUTE_NAME的值，如果有，采用此值
2. 然后检查SessionLocaleResolver的defaultLocale属性，如果有，采用此值
3. 返回HttpServletRequest的getLocale()，也就是HTTP请求中的Accept-Language的值。

设置Locale Resolver

　　我们将Locale Resolver设置在Dispatch servlet context中，允许不同的Dispatch servlet context具有不同的解释器。

public class SerlvetContextConfiguration extends WebMvcConfigurerAdapter{    ... ...    @Bean    public LocaleResolver localeResolver(){ //名字必须为localeResolver        return new SessionLocaleResolver();    }}

用户自定义语言的小例子

　　用户设定某用语言后，我们希望用户接下来访问的页面都采用该语言的本地化方式。➤ 采用session存放用户的Locale，小例子中该Locale的获取采用URL参数方式。

@RequestMapping(value = "/test", method = RequestMethod.GET)public String test(Map<String, Object> model,HttpServletRequest request,HttpServletResponse response,              @RequestParam(value="locale", required=false) String localeStr){               setUserLocale(request,response,localeStr);       ... ...}//-- 【1】使用session中设置SessionLocaleResolver.LOCALE_SESSION_ATTRIBUTE_NAME属性方式private void setUserLocale(HttpServletRequest request,String localeStr){       Locale locale = getLocaleFromStr(localStr);       if(locale == null)              return;       HttpSession session = request.getSession(true);       session.setAttribute(SessionLocaleResolver.LOCALE_SESSION_ATTRIBUTE_NAME, locale);}//--【方式二】使用LocaleResolver的setLocale方法进行设置。@Inject private LocaleResolver localeresolver;private void setUserLocale(HttpServletRequest request,HttpServletResponse response,String localeStr){       Locale locale = getLocaleFromStr(localStr);       if(locale == null)              return;       this.localeresolver.setLocale(request, response, locale);}private Locale getLocaleFromStr(String str){       if(str == null)              return null;       String[] p = StringUtils.split(str, "_");       Locale locale ;       switch(p.length){       case 2:           return new Locale(p[0], p[1]);           break;       case 3:           return new Locale(p[0], p[1], p[2]);           break;       default:           return new Locale(p[0]);       }  }

　　方式一等同于localeResolver采用sessionLocaleResolver的情况,即如果用户设置了某种语言，就在session中设置SessionLocaleResolver.LOCALE_SESSION_ATTRIBUTE_NAME属性，用户后续的访问均采用该语言。对于其他的locale Resolver，如果是CookieLocaleResolver，则我们可以在Cookie中看到相关的设置。

　　我们注意到locale resolver是在Dispatcher servlet上下文的bean，如果有某些静态的jsp，不经过spring的dispatcher，就不会使用该resolver，也就是用户设置了语言后，对这些jsp无效。

不经过Dispatcher servlet处理的jsp如何使用locale resolver

　　这种jsp通常就是某些静态页面。在上次学习中，提及了两个方法，对于采用spring tag的方式，并没能使用locale resolver，即使我们将localeResovler设置在root context，测试也未能通过。在这种情况下，我们需要使用Filter的方式。

public class JstlLocalizationContextFilter implements Filter {    ... ...    /** 不采用inject是因为Filter是作为root context的bean，因此只能加载root的bean，      * 而local resolver bean是在dispather context定义的，无法加载，所以重新生成一个来用。 */    private LocaleResolver localeResolver= new SessionLocaleResolver();    @Override    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)                          throws IOException, ServletException {        request.setAttribute(DispatcherServlet.LOCALE_RESOLVER_ATTRIBUTE, localeResolver);        JstlUtils.exposeLocalizationContext((HttpServletRequest)request, this.jstlMessageSource );        chain.doFilter(request, response);    }}

使用拦截器：LocaleChangeInterceptor

　　在上面的小例子中，我们是手动在Controller的代码中对某个url的请求进行检查，并根据sessionLocaleResolver的原理对session进行了设置。如果这个执行并不是仅限于某个url，而是任意的可以的，我们会想到filter。Spring提供了要给非常类似的概念：拦截器（Interceptor），可以拦截任何经过DispatcherServlet的请求，可以在Interceptor内直接使用Bean（想想在filter中使用的麻烦）。

　　Spring提供了LocaleChangeInterceptor，如果请求中带有locale参数，就存放在session，配合sessionLocalResolver完成国际化，一般LocaleChangeInterceptor和sessionLocalResolver是一起使用的。

@Configuration@EnableWebMvc@ComponentScan(       basePackages = "com.wrox.site",       useDefaultFilters = false,       includeFilters = @ComponentScan.Filter(Controller.class))public class ServletContextConfiguration extends WebMvcConfigurerAdapter{    /* 添加连接器重写WebMvcConfigurerAdapter的方法，因此我们必须要标记@EnableWebMvc，如果没有，将不起所用。     * Interceptor有几个重要的方法：     *  - preHandle() : DispatcherServlet收到请求，在controller具体处理handler之前调用     *  - postHandle()：handler返回，但在view渲染之前     *  - afterCompletion()：view渲染之后，离开DispatcherServlet之前 */    @Override    public void addInterceptors(InterceptorRegistry registry) {                super.addInterceptors(registry);        registry.addInterceptor(new LocaleChangeInterceptor());    }    @Bean    public LocaleResolver localeResolver(){        return new SessionLocaleResolver();    }    ... ...}

　　将LocaleChangeInterceptor加入拦截器后，我们任意（需要经过DispatchServlet）的请求加上参数locale=en，则定位到basename_en.properties文件，如果是locale=en_US，将定位到basename_en_US.properties文件。如果我们需要对LocaleChangeInterceptor做一些定制，例如不采用缺省的locale，采用lang，代码如下：

@Configuration@EnableWebMvc@ComponentScan(       basePackages = "com.wrox.site",       useDefaultFilters = false,       includeFilters = @ComponentScan.Filter(Controller.class))public class ServletContextConfiguration extends WebMvcConfigurerAdapter{    @Override    public void addInterceptors(InterceptorRegistry registry) {            super.addInterceptors(registry);        LocaleChangeInterceptor lci = new MyLocaleChangeInterceptor();        lci.setParamName("lang");        registry.addInterceptor(lci);    }     ... ...}

CookieLocaleResolver

　　使用seesion locale resovler有一个缺点，它是基于session的，而我们希望能基于登录的用户，用户设置过语言（作为用户的属性），只要佢登录，就显示想用的语言。用户的属性在登录后，常以Principal的方式携带。这时我们可以使用CookieLocaleResolver。

自定义CookieLocaleResolver

public class UserCookieLocaleResolver extends CookieLocaleResolver{    //【1】resolveLocale()修改的将是response中的Content-Language header，但不决策选择哪个资源。书中例子只给出resolveLocale()，抓包也看到返回的内容语言消息头变化，就是似乎不变更资源，这个问题查了很久，需要另外通过resolveLocaleContext()来影响资源的选择。    @Override    public Locale resolveLocale(HttpServletRequest request) {        Principal user = request.getUserPrincipal();        Locale locale = getLocaleFromPricipal(request);         if(locale != null)            return locale;        else            return super.resolveLocale(request);    }    //【2】resolveLocaleContext()处理实际选择的资源，但不修改响应的Content-Language    @Override    public LocaleContext resolveLocaleContext(HttpServletRequest request) {        Locale locale = simulatePricipal(request.getUserPrincipal());                if(locale != null){            return new LocaleContext() {                @Override                public Locale getLocale() {                    return locale;                }            };        }else{                    return super.resolveLocaleContext(request);        }    }    private Locale getLocaleFromPricipal(HttpServletRequest request){         ......    }}

手动设置语言

可以通过url加上参数设置语言，如果localeResolver是CookieLocaleReslover，则我们可以看到在响应中设置Cookie。浏览器在后续的请求中Cookie会携带org.springframework.web.servlet.i18n.CookieLocaleResolver.LOCALE信息。

TimeZone

　　转换为当地时区也是个麻烦事情，Spring没有时区相关的解析器，可以利用LocaleContextHolder来存放Timezone。

//从请求中获取TimeZone，如果没有返回nullTimeZone tz = RequestContextUtils.getTimeZone(request);//利用LocaleContextHolder来设置或者读取TimezoneLocaleContextHolder.setTimeZone(timezone);TimeZone timezone = LocaleContextHolder.getTimeZone();

　　在JSTL中使用TimeZone，可参见http://blog.csdn.net/flowingflying/article/details/52744823

主题 Theme

　　Spring提供主体的概念，主体是CCS，JS，图片等其他资源的集合。设置主题是很有帮助的，有些语言的顺序是从右到左（ 我们可以使用java.awt.ComponentOrientation的getOrientation(Locale)来获取语言的方向），这些需要CSS来处理。

　　和locale类似，Spring提供ThemeResolvers（包含SessionThemeResolver和CookieThemeResolver）来为用户选择合适的主题，提供 ThemeChangeInterceptor ，当用户在请求参数中设置选择的主题，转变为该主题。提供ResourceBundleThemeSource和ResourceBundleMessageSource类似，使用<spring:theme>。

　　我们可以自定义ThemResolver，是之和locale关联，根据locale来决定使用主题。

相关文章相关链接： 我的Professional Java for Web Applications相关文章