简单示例
下面先演示一个示例:
1.首先需要在src目录下编写三个国际化资源文件。
i18n_en_US.properties(i18n.properties)和i18n_zh_CN.properties内容分别如下所示:
2.在MVC配置文件中注册国际化资源文件
<!-- 注册配置国际化资源文件 -->
<bean id="messageSource" class="org.springframework.context.support.ResourceBundleMessageSource">
<property name="basename" value="i18n"></property>
</bean>
3.编写index.jsp,i18n.jsp,i18n2.jsp三个页面,内容分别如下所示:
3.在MVC配置文件进行如下配置:
<mvc:annotation-driven></mvc:annotation-driven>
<!-- 配置直接转发的页面,而无须在经过控制器的方法 -->
<mvc:view-controller path="/i18n" view-name="i18n"/>
<mvc:view-controller path="/i18n2" view-name="i18n2"/>
4.在index.jsp进行请求响应之后即可根据浏览器本地语言的不同显示国际化资源文件中的不同文本。
上面的实例即为国际化的一个简单实例。默认情况下,SpringMVC 根据 Accept-Language 参数判断客户端的本地化类型。
当接受到请求时,SpringMVC 会在上下文中查找一个本地化解析器(LocalResolver,如AcceptHeaderLocaleResolver),找到后使用它获取请求所对应的本地化类型信息。
获取本地的国际化资源信息
本地的国际化资源信息封装在Locale类中,基于上述的例子我们可以在控制器类中编写如下代码:
@Autowired
private ResourceBundleMessageSource messageSource;
/**
* 入参Locale是SpringMVC所支持的原始Servlet API
* Locale封装了一些本地的国际化资源信息
*/
@RequestMapping("/i18n")
public String testI18n(Locale locale) {
//根据对象locale获取指定的username的值
String val = messageSource.getMessage("i18n.username", null, locale);
System.out.println(val);//"用户名"或"Username"
return "i18n";
}
动态更改本地化类型
我们还可以通过点击链接动态地更改显示的文本内容,比如显示中文或对应的英文等。
因为SpringMVC 允许装配一个动态更改本地化类型的拦截器,这样通过指定一个请求参数(如locale=zh_CN)就可以控制单个请求的本地化类型。
示例:
1.在MVC配置文件中进行如下配置:
<!-- 配置SessionLocaleResolver -->
<bean id="localeResolver" class="org.springframework.web.servlet.i18n.SessionLocaleResolver"></bean>
<!-- 配置LocaleChanceInterceptor -->
<mvc:interceptors>
<bean class="org.springframework.web.servlet.i18n.LocaleChangeInterceptor"></bean>
</mvc:interceptors>
2.然后在i18n.jsp中添加如下两个超链接:
<a href="i18n?locale=zh_CH">中文</a>
<a href="i18n?locale=en_US">英文</a>
3.运行请求响应之后,我们可以动态的更改显示的文本。
上述示例涉及到了SessionLocaleResolver &LocaleChangeInterceptor ,其工作原理如下图所示(可通过debug加深理解):
本地化解析器和本地化拦截器
- AcceptHeaderLocaleResolver:根据 HTTP 请求头的Accept-Language 参数确定本地化类型,如果没有显式定义本地化解析器, SpringMVC 使用该解析器。
- CookieLocaleResolver:根据指定的 Cookie 值确定本地化类型
- SessionLocaleResolver:根据 Session 中特定的属性确定本地化类型
- LocaleChangeInterceptor:从请求参数中获取本次请求对应的本地化类型。