Java for Web学习笔记（七三）：国际化i18n（1）使用Spring框架MessageSource
一般性了解
我们在JSTL fmt[1]中已经接触过国际化i18n，本地化L10n。使用JSTL fmt(Internationalization and Formatting tag library)，有一些局限性：
- 我们需要将resource bundles（那些properties文件）放在在eclipse的src/main/resources中，也就是放在了/WEB-INF/classes中。使用classpath的要注意，这个位置是比较特别，JVM将永久缓存，直至web app终结。如果我们修改文件的内容，修改的内容不会被再次读入，除非重新加载web app。fmt无法使用其他地方的文件或者数据库。
- fmt通过HTTP请求的Accept-Language来进行判断使用使用哪种本地化。我们现在看到很多网页有个语言选择，选择后，后续的网页都采用这种语言，fmt在这方面不支持，因为浏览器不会根据网页的选择而修改其默认语言（进而修改Accept-Language）。
Spring的i18n解决这些问题，并提供更为便捷的方式；不仅在jsp中使用，还可以在代码中使用；可以直接错误object（如Throwable）传递到本地化API，实现直接本地化错误信息。
Resource bundle和message format
和fmt一样，Spring的i18n也使用resource bundle（java.util.ResourceBundle）和message format（java.text.MessageFormat），并在resource bundle之上提供抽象的message source，变得更容易本地化。resource bundle是消息中需要本地化的消息格式的集合。
message format
消息格式（java.text.MessageFormat）含有占位模板，在运行时被替换。例子如下
There are {0} cats on the farm.
There are {0,number,integer} cats on the farm.
The value of Pi to seven significant digits is {0,number,#.######}.
My birthdate: {0,date,short}. Today is {1,date,long} at {1,time,long}.
My birth day: {0,date,MMMMMM-d}. Today is {1,date,MMM d, YYYY} at {1,time,hh:mma).
There {0,choice,0#are no cats|1#is one cat|1这些占位符号（placeholder）是有顺序的，替换是按这个顺序，而不是语句中出现的顺序（语句中的顺序本来就是要本地化）。
With a {0,number,percentage} discount, the final price is {1,number,currency}.{#}
{#,number}
{#,number,integer}
{#,number,percent}
{#,number,currency}
{#,number,自定义格式，遵循java.text.DecimalFormat}
{#,date}
{#,date,short}
{#,date,medium}
{#,date,long}
{#,date,full}
{#,date,自定义格式，遵循java.text.SimpleDateFormat}
{#,time}
{#,time,short}
{#,time,medium}
{#,time,long}
{#,time,full}
{#,time,自定义格式，遵循java.text.SimpleDateFormat}
{#,choice,自定义格式，遵循java.text.ChoiceFormat}resource bundle的命名规则
resource bundle是这些message format的集合，一般采用properties文件的方式，key就是message code，value就是message format。例如：
alerts.current.date=Current Date and Time: {0,date,full} {0,time,full}[baseName]_[language]_[script]_[region]_[variant]
[baseName]_[language]_[script]_[region]
[baseName]_[language]_[script]
[baseName]_[language]_[region]_[variant]
[baseName]_[language]_[region] 例如labels_en_US.properties
[baseName]_[language] 例如labels_en.properties以上前面的比后面具有优先权。如果只有baseName，language和variant，最匹配的是第4个，例子为：baseName_en__JAVA
对于JSTL fmt：
- ResourceBundle首先根据指定的bundle名字下载和实例化一个ResourceBundlede扩展类。
- 如果找不到，将当中的"."提到为"/"，加上".properties"的后缀，在classpath中再找，返回一个PropertyResourceBundle类。
- 如果还找不到，使用fallback Locale来产生的可能的bundle名字，再找
- 还找不到，则找寻baseName的类或文件。（即我们可以使用baseName的文件作为缺省的匹配）
- 还找不到，抛出异常。
如果我们需要从数据库中获取，就需要自己实现ResourceBundle，然而ResourceBundle实例在同一时刻，只能支持一个Locale，它解析message的方法不带locale参数，因此需要为不同的locale提供不同的ResourceBundle实例。这导致实现的复杂。
Spring的message source
Spring的message source在resource bundle之上提供了抽象和封装，实现了org.springframework.context.MessageSource接口，接口提供了三个方法，可以看到locale是方法的参数，无需为不同的locale创建不同的实例，此外，已经返回解析后的message，无需再根据message format进行解析。
目前，Spring提供连个MessageSource接口的实现：
- org.springframework.context.support.ResourceBundleMessageSource，里面含有ResourceBundle的集合，使用ResourceBundle的getBundle()来定位资源，因此是和ResourceBundle完全相同的策略，即资源必须是在classpath下，因此受限不能更新。
- org.springframework.context.support.ReloadableResourceBundleMessageSource，里面并不含有ResourceBundle，但使用相同的检测策略，只支持文件，不支持类，可以放在非calsspath，即reloadable，通常为/WEB-INF/i18n。
ReloadableResourceBundleMessageSource小例子
设置properties文件
在/WEB-INF/i18n目录下设置两个资源文件。
test_en_US.properties
foo.test = Hello, {0} {1}
foo.message = This is the default message. Args: {0}, {1}, {2}.foo.test = \u60A8\u597D, {1} {0}foo.test = 您好, {1} {0}
foo.message = 这是缺省消息，参数: {0}, {1}, {2}.配置messageSource Bean
我们在root上下文中进行设置
public class RootContextConfiguration implements AsyncConfigurer,SchedulingConfigurer{
//... 略 ...
@Bean //【注意】这个bean的名字必须叫messageSource，否则无效
public MessageSource messageSource(){
ReloadableResourceBundleMessageSource messageSource = new ReloadableResourceBundleMessageSource();
//如果设置为-1，表示Cache forever。一般生产环境下采用-1，开发环境为了方便调测采用某个正整数，规范地我们可通过profile来定义
messageSource.setCacheSeconds(5);
/* 设置缺省的资源文件的编码，
* 如果个别文件采用其他编码（不适用缺省编码，但一般我们应统一进行设置），可以通过setFileEncoding()来指定
* Properties properties = new Properties();
* properties.setProperty("/WEB-INF/i18n/test_zh_CN", "GBK");
* messageSource.setFileEncodings(properties); */
messageSource.setDefaultEncoding(StandardCharsets.UTF_8.name());
//设置properties文件的basename，以便找到响应的资源文件
messageSource.setBasenames("/WEB-INF/i18n/messages", "/WEB-INF/i18n/errors","/WEB-INF/i18n/test");
return messageSource;
}
}小例子中我们采用文件作为资源，在实际中也可以会使用到数据库，例如NoSQL仓库，我们需要构建自定义的message source，这在后面介绍。
在代码中使用
@Service
public class MyTestService implements TestService{
private static final Logger logger = LogManager.getLogger();
@Inject MessageSource messageSource;
@Override
public void testSourceMessage() {
String msg = this.messageSource.getMessage("foo.message", new Object[]{"One","Two","Three"}, Locale.US);
logger.info(msg);
msg = this.messageSource.getMessage("foo.message", new Object[]{"一","二","三"}, Locale.getDefault());
logger.info(msg);
msg = this.messageSource.getMessage("foo.lable", new Object[]{"Hi"}, "{0}, my friend", Locale.ENGLISH);
logger.info(msg);
}
}输出结果：
14:43:36.789 [INFO ] MyTestService:20 testSourceMessage() - This is the default message. Args: One, Two, Three.
14:43:36.790 [INFO ] MyTestService:22 testSourceMessage() - 这是缺省消息，参数: 一, 二, 三.
14:43:36.791 [INFO ] MyTestService:24 testSourceMessage() - Hi, my friendLocale.US将匹配test_en_US.properties，如果我们设置Locale.ENGLISH，由于并没有test_en.propertiesst，将采用缺省的Locale值，即匹配了test_zh_CN.properties，如果仍没有找到，采用default message的参数。
在jsp中使用
测试案例的Controller相关代码如下：
@RequestMapping(value = "/test", method = RequestMethod.GET)
public String test(Map model){
model.put("firstName", "San");
model.put("lastName", "Zhang");
return "home/test";
} 在jsp中使用spring:message，如下。使用方法参考文档[2]
<%@ taglib prefix="spring" uri="http://www.springframework.org/tags" %>
... ...
... ...
我们可以得到页面输出您好, Zhang San。spring:message和fmt:message很相似，同样有htmlEscape属性，缺省为false。如果某个jsp中有大量需要htmlEscape的spring:message，我们可以在jsp中设置
defaultHtmlEscape
true
<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>
... ...
... ...我们去查看log，无论是采用spring的tag还是fmt的tag，log是同样的，同时通过ReloadableResourceBundleMessageSource bean来进行处理。
16:23:45.837 [TRACE] (Spring) JstlView - Rendering view with name 'home/test' with model {firstName=San, lastName=Zhang} and static attributes {}
16:23:45.837 [DEBUG] (Spring) JstlView - Added model object 'firstName' of type [java.lang.String] to request in view with name 'home/test'
16:23:45.837 [DEBUG] (Spring) JstlView - Added model object 'lastName' of type [java.lang.String] to request in view with name 'home/test'
16:23:45.837 [DEBUG] (Spring) JstlView - Forwarding to resource [/WEB-INF/jsp/view/home/test.jsp] in InternalResourceView 'home/test'
16:23:45.859 [DEBUG] (Spring) ReloadableResourceBundleMessageSource - Re-caching properties for filename [/WEB-INF/i18n/messages_zh_CN] - file hasn't been modified
16:23:45.859 [DEBUG] (Spring) ReloadableResourceBundleMessageSource - No properties file found for [/WEB-INF/i18n/messages_zh] - neither plain properties nor XML
16:23:45.859 [DEBUG] (Spring) ReloadableResourceBundleMessageSource - No properties file found for [/WEB-INF/i18n/messages] - neither plain properties nor XML
16:23:45.862 [DEBUG] (Spring) ReloadableResourceBundleMessageSource - Re-caching properties for filename [/WEB-INF/i18n/errors_zh_CN] - file hasn't been modified
16:23:45.863 [DEBUG] (Spring) ReloadableResourceBundleMessageSource - No properties file found for [/WEB-INF/i18n/errors_zh] - neither plain properties nor XML
16:23:45.863 [DEBUG] (Spring) ReloadableResourceBundleMessageSource - No properties file found for [/WEB-INF/i18n/errors] - neither plain properties nor XML
16:23:45.866 [DEBUG] (Spring) ReloadableResourceBundleMessageSource - Re-caching properties for filename [/WEB-INF/i18n/test_zh_CN] - file hasn't been modified
16:23:45.866 [TRACE] (Spring) DispatcherServlet - Cleared thread-bound request context: org.apache.catalina.connector.RequestFacade@e05013
16:23:45.866 [DEBUG] (Spring) DispatcherServlet - Successfully completed request没有经过JstlView的jsp
采用- 采用spring tag，将通过spring框架使用MessageSource。
- 使用filter，强制所有的jsp都通过spring框架。
第一种方式很简单，推荐使用。如果有与某种原因不能使用第一种方式，需要采用filter，我们首先要将filter设置为spring的bean，这样它才可以注入message source，方式和之前学习的Listener一样。我们在Bootstrap初始化root context后代码设置filter，这样确保可以注入root context中的bean，设置相关的jsp经过它。下面是相关filter的代码：
public class JstlLocalizationContextFilter implements Filter {
private MessageSource jstlMessageSource;
@Inject MessageSource messageSource;
public JstlLocalizationContextFilter() { }
@Override
public void destroy() { }
@Override
public void doFilter(ServletRequest request,ServletResponse response,FilterChain chain)
throws IOException,ServletException {
// Exposes JSTL-specific request attributes specifying locale and resource bundle for
// JSTL's formatting and message tags,using Spring's locale and MessageSource.
JstlUtils.exposeLocalizationContext((HttpServletRequest)request, this.jstlMessageSource );
chain.doFilter(request, response);
}
@Override
public void init(FilterConfig fConfig) throws ServletException {
ServletContext servletContext = fConfig.getServletContext();
WebApplicationContext rootContext = WebApplicationContextUtils
.getRequiredWebApplicationContext(servletContext);
AutowireCapableBeanFactory factory = rootContext.getAutowireCapableBeanFactory();
factory.autowireBeanProperties(this, AutowireCapableBeanFactory.AUTOWIRE_BY_TYPE,true);
factory.initializeBean(this,"JstlLocalizationContextFilter");
/* 【1】第一个参数servletContext首先检查JSTL的"javax.servlet.jsp.jstl.fmt.localizationContext"
* 的context-param（web.xml），如果有设置，生成相应的ResourceBundleMessageSource实例。
* 【2】第二个参数为spring的MessageSource。
* 将根据这两个参数获得子message source */
this.jstlMessageSource = JstlUtils.getJstlAwareMessageSource( servletContext, this.messageSource );
}
}相关文章相关链接： 我的Professional Java for Web Applications相关文章