国际化

还有针对特定地区的本地化功能，英文是localization，缩写为L10n，本地化是指根据地区调整类似姓名、日期的显示等。

也有把上面两者合称为全球化，英文是globalization，缩写为g11n。

在Java中，支持多语言和本地化是通过配合Locale实现的：

对于Web应用程序，要实现国际化功能，主要是渲染View的时候，要把各种语言的资源文件提出来，这样，不同的用户访问同一个页面时，显示的语言就是不同的。

我们来看看在Spring MVC应用程序中如何实现国际化。

实现国际化的第一步是获取到用户的Locale。在Web应用程序中，HTTP规范规定了浏览器会在请求中携带Accept-Language头，用来指示用户浏览器设定的语言顺序，如：

上述HTTP请求头表示优先选择简体中文，其次选择中文，最后选择英文。q表示权重，解析后我们可获得一个根据优先级排序的语言列表，把它转换为Java的Locale，即获得了用户的Locale。大多数框架通常只返回权重最高的Locale。

Spring MVC通过LocaleResolver来自动从HttpServletRequest中获取Locale。有多种LocaleResolver的实现类，其中最常用的是CookieLocaleResolver：

  1. @Primary
  2. @Bean
  3. LocaleResolver createLocaleResolver() {
  4.     var clr = new CookieLocaleResolver();
  5.     clr.setDefaultLocale(Locale.ENGLISH);
  6.     clr.setDefaultTimeZone(TimeZone.getDefault());
  7.     return clr;
  8. }

CookieLocaleResolver从HttpServletRequest中获取Locale时，首先根据一个特定的Cookie判断是否指定了Locale，如果没有，就从HTTP头获取，如果还没有，就返回默认的Locale。

提取资源文件

第二步是把写死在模板中的字符串以资源文件的方式存储在外部。对于多语言，主文件名如果命名为messages，那么资源文件必须按如下方式命名并放入classpath中：

  • 默认语言，文件名必须为messages.properties；
  • 简体中文，Locale是zh_CN，文件名必须为messages_zh_CN.properties；
  • 日文，Locale是ja_JP，文件名必须为messages_ja_JP.properties；
  • 其它更多语言……

每个资源文件都有相同的key，例如，默认语言是英文，文件messages.properties内容如下：

  1. language.select=Language
  2. home=Home
  3. signin=Sign In
  4. copyright=Copyright©{0,number,#}

文件messages_zh_CN.properties内容如下：

  1. language.select=语言
  2. home=首页
  4. copyright=版权所有©{0,number,#}

第三步是创建一个Spring提供的MessageSource实例，它自动读取所有的.properties文件，并提供一个统一接口来实现“翻译”：

其中，signin是我们在.properties文件中定义的key，第二个参数是Object[]数组作为格式化时传入的参数，最后一个参数就是获取的用户Locale实例。

创建MessageSource如下：

  1. MessageSource createMessageSource() {
  2.     var messageSource = new ResourceBundleMessageSource();
  3.     // 指定文件是UTF-8编码:
  4.     messageSource.setDefaultEncoding("UTF-8");
  5.     // 指定主文件名:
  6.     messageSource.setBasename("messages");
  7.     return messageSource;
  8. }

注意到ResourceBundleMessageSource会自动根据主文件名自动把所有相关语言的资源文件都读进来。

再注意到Spring容器会创建不只一个MessageSource实例，我们自己创建的这个MessageSource是专门给页面国际化使用的，因此命名为i18n，不会与其它MessageSource实例冲突。

实现多语言

要在View中使用MessageSource加上Locale输出多语言，我们通过编写一个MvcInterceptor，把相关资源注入到ModelAndView中：

  1. @Component
  2. public class MvcInterceptor implements HandlerInterceptor {
  3.     @Autowired
  4.     LocaleResolver localeResolver;
  6.     // 注意注入的MessageSource名称是i18n:
  7.     @Autowired
  8.     @Qualifier("i18n")
  9.     MessageSource messageSource;
  11.     public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
  12.         if (modelAndView != null) {
  13.             // 解析用户的Locale:
  14.             Locale locale = localeResolver.resolveLocale(request);
  15.             // 放入Model:
  16.             modelAndView.addObject("__messageSource__", messageSource);
  18.         }
  19.     }
  20. }

不要忘了在WebMvcConfigurer中注册MvcInterceptor。现在，就可以在View中调用MessageSource.getMessage()方法来实现多语言：

    这样，我们可以把多语言页面改写为：

    1. <a href="/signin">{{ _('signin') }}</a>

    如果是带参数的多语言，需要把参数传进去：

    1. <h5>{{ _('copyright', 2020) }}</h5>

    使用其它View引擎时，也应当根据引擎接口实现更方便的语法。

    最后，我们需要允许用户手动切换Locale，编写一个LocaleController来实现该功能：

    1. @Controller
    2. public class LocaleController {
    3.     final Logger logger = LoggerFactory.getLogger(getClass());
    5.     @Autowired
    6.     LocaleResolver localeResolver;
    8.     @GetMapping("/locale/{lo}")
    9.     public String setLocale(@PathVariable("lo") String lo, HttpServletRequest request, HttpServletResponse response) {
    10.         // 根据传入的lo创建Locale实例:
    11.         Locale locale = null;
    12.         int pos = lo.indexOf('_');
    13.         if (pos > 0) {
    14.             String lang = lo.substring(0, pos);
    15.             String country = lo.substring(pos + 1);
    16.             locale = new Locale(lang, country);
    17.         } else {
    18.             locale = new Locale(lo);
    19.         }
    20.         // 设定此Locale:
    21.         localeResolver.setLocale(request, response, locale);
    22.         logger.info("locale is set to {}.", locale);
    23.         // 刷新页面:
    24.         String referer = request.getHeader("Referer");
    25.         return "redirect:" + (referer == null ? "/" : referer);
    26.     }

    在页面设计中，通常在右上角给用户提供一个语言选择列表，来看看效果：

    i18n-en

    切换到中文：

    练习

    从国际化 - 图4下载练习： （推荐使用IDE练习插件快速下载）

    多语言支持需要从HTTP请求中解析用户的Locale，然后针对不同Locale显示不同的语言；

    读后有收获可以支付宝请作者喝咖啡：