Spring MVC(十五)--SpringMVC国际化配置项
Spring MVC中,当DispatcherServlet初始化的时候,会解析一个LocaleResolver接口的实现类,这个实现类就是用来解析国际化的。
一、国际化解析器
Spring MVC中提供了以下四个实现类:
- AcceptHeaderLocaleResolver:spring默认的区域解析器,它通过校验http请求的accept-language头部来解析区域。这个头是由web浏览器根据底层操作系统的区域设置,这个区域无法改变用户的区域,所以只能根据操作系统设置而获取,一般不使用;
- FixedLocaleResolver:使用固定的locale国际化,也是不可修改;
- CookieLocaleResolver:根据cookie数据获取国际化数据,但是如果用户禁止或没有设置cookie,就会根据http头中的accept-language来获取;
- SessionLocaleResolver:根据session进行国际化,即根据用户设置session的变量进行读取,所以它是可变的,也是使用最多的;
为了修改国际化,Spring MVC还提供了一个拦截器-LocaleChangeInterceptor,通过它可以获取参数,然后根据参数来改变区域;
它的配置方式如下:
1、JAVA配置方式
1⃣️配置CookieLocaleResolver
1 /** 2 * 配置CookieLocaleResolver 3 * bean名称必须是localeResolver 4 * 5 * @return 6 */ 7 @Bean(name = "localeResolver") 8 public CookieLocaleResolver initCookieLocaleResolver() { 9 CookieLocaleResolver clr = new CookieLocaleResolver(); 10 // 设置cookie名称 11 clr.setCookieDomain("lang"); 12 // 设置超时秒数 13 clr.setCookieMaxAge(3600); 14 // 默认使用简体中文 15 clr.setDefaultLocale(Locale.SIMPLIFIED_CHINESE); 16 return clr; 17 }
2⃣️配置SessionLocaleResolver
1 /** 2 * 配置SessionLocaleResolver 3 * bean名称必须是localeResolver 4 * 5 * @return 6 */ 7 @Bean(name = "localeResolver") 8 public SessionLocaleResolver initSessionLocaleResolver() { 9 SessionLocaleResolver slr = new SessionLocaleResolver(); 10 // 默认使用简体中文 11 slr.setDefaultLocale(Locale.SIMPLIFIED_CHINESE); 12 return slr; 13 }
2、XML配置方式
1⃣️配置CookieLocaleResolver
1 <!--第一种:配置cookie国际化解析器 --> 2 <bean id="localeResolver" 3 class="org.springframework.web.servlet.i18n.CookieLocaleResolver"> 4 <!-- cookie变量的名称 --> 5 <property name="cookieName" value="lang" /> 6 <!-- cookie超时时间 --> 7 <property name="cookieMaxAge" value="20" /> 8 <!-- 默认使用简体中文 --> 9 <property name="defaultLocale" value="zh_CN" /> 10 </bean>
2⃣️配置SessionLocaleResolver
1 <!--第一种:配置session国际化解析器 --> 2 <bean id="localResolver" 3 class="org.springframework.web.servlet.i18n.SessionLocaleResolver"> 4 因为session有其自身定义的超时时间和编码,所以此处不需要设置 5 <property name="defaultLocale" value="zh_CN" /> 6 </bean>
注意⚠️:
- 不管配置哪种解析器,bean的名称都必须是localeResolver,这是Spring MVC默认的名称,不能修改,否则找不到;
- session有其自定义的超时时间,所以无需配置;
二、国际化文件加载
在实现国际化之前,首先要加载相关的资源文件,即消息源,这个功能由Spring MVC提供的MessageSource接口完成,并且有四个非抽象的实现类:
- StaticMessageSource:静态消息源;
- DelegatingMessageSource:实现的是代理功能;
- ResourceBundleMessageSource:由JDK提供的Bundle实现,只能把文件放置在对应的类路径下,不具备热加载功能,只有重启系统才能重新加载;
- ReloadavleResourceBundleMessageSource:可以把文件放置在任何地方,并且在不重启系统的前提下也能重新加载资源文件,这样就可以在程序运行期修改并重新加载资源文件;
其实在配置国际化解析器之前还要配置消息源,下面介绍如何配置,还是有两种方式:
1、JAVA方式配置消息源
1⃣️配置ResourceBundleMessageSource
1 /** 2 * 配置ResourceBundleMessageSource消息源 3 * bean名称必须为messageSource 4 * 5 * @return 6 */ 7 @Bean(name = "messageSource") 8 public MessageSource initResourceBundleMessageSource() { 9 ResourceBundleMessageSource rbms = new ResourceBundleMessageSource(); 10 rbms.setDefaultEncoding("UTF-8"); 11 rbms.setBasename("msg"); 12 return rbms; 13 }
2⃣️配置ReloadableResourceBundleMessageSource
1 /** 2 * 配置ReloadableResourceBundleMessageSource消息源 3 * bean名称必须为messageSource 4 * 5 * @return 6 */ 7 @Bean(name = "messageSource") 8 public MessageSource initReloadableResourceBundleMessageSource() { 9 ReloadableResourceBundleMessageSource rrbms = new ReloadableResourceBundleMessageSource(); 10 rrbms.setDefaultEncoding("UTF-8"); 11 // 因为是热加载,所以需要加上classpath 12 rrbms.setBasename("classpath:msg"); 13 // 设置刷新的秒数,即多长时间刷新一次 14 rrbms.setCacheSeconds(1800); 15 // 设置刷新的毫秒数 16 rrbms.setCacheMillis(1800000); 17 return rrbms; 18 }
2、XML方式配置消息源
1⃣️配置ResourceBundleMessageSource
1 <!--第一种方式:配置ResourceBundleMessageSource:这种方式只能把资源文件放到指定的路径下,不能热加载,需要重启系统才能加载它 --> 2 <bean id="messageResource" 3 class="org.springframework.context.support.ResourceBundleMessageSource"> 4 <property name="defaultEncoding" value="UTF-8" /> 5 <property name="basename" value="msg" /> 6 </bean>
2⃣️配置ReloadableResourceBundleMessageSource
1 <!--第二种方式:配置ReloadableResourceBundleMessageSource:这种方式只能把资源文件放到任何位置,不需要重启就能加载文件,并且可以设置刷新时间 --> 2 <bean id="messageSource" 3 class="org.springframework.context.support.ReloadableResourceBundleMessageSource"> 4 <!-- 默认编码方式 --> 5 <property name="defaultEncoding" value="UTF-8" /> 6 <!-- 资源文件的前缀:多了一个classpath,如果资源文件在一个文件夹下,还要加上文件夹路径,否则报错 --> 7 <property name="basename" value="classpath:message/msg" /> 8 <!-- 刷新时间 --> 9 <property name="cacheSeconds" value="3600" /> 10 </bean>
需要注意以下几点:
- 无论何种方式配置何种消息源,bean的名称必须是messageSource;
- ReloadableResourceBundleMessageSource可以热加载,所以需要配置刷新时间,并且配置资源文件的前缀时需要加classpath,如果资源文件在classpath的某个文件夹下,还需要加上文件夹的名称;
三、配置拦截器
通过请求参数去改变国际化的值时,可以使用Spring提供的拦截器LocaleChangeInterceptor,它继承了HandlerInterceptorAdapter,通过覆盖它的preHandle方法,然后使系统所配置的LocaleResolver实现国际化,这个一般是配置在Spring MVC的配置文件中:
1 <!-- 配置国际化拦截器 --> 2 <mvc:interceptors> 3 <mvc:interceptor> 4 <mvc:mapping path="/**" /> 5 <bean class="org.springframework.web.servlet.i18n.LocaleChangeInterceptor"> 6 <property name="paramName" value="language" /> 7 </bean> 8 </mvc:interceptor> 9 </mvc:interceptors>
其中:
- <mvc:mapping>的path属性值配置成/**,这样就能拦截所有/请求及其子路径中的请求了;
- 拦截器的属性paramName的值就是url中传过来的参数,如language=zh_CN或language=en_US等;
至此,国际化中所有的配置都已经介绍完毕,下一篇文章将举一个实现过程的例子。
本文来自博客园,作者:bug改了我,转载请注明原文链接:https://www.cnblogs.com/hellowhy/p/9751987.html