I18N

i18n: internationalization,国际化

usage

  // key 为 a.b.c.d 形式
  I18N.translate(key);

  I18N.translate(key, locale);

例如,我们要支持一个app.title的国际化,在英文环境为My Application,在中文环境显示我的应用,那么只需要在资源目录的i18n下的任意目录中建一套资源:app.yml,app_en_US.yml,app_zh_CN.yml

Note

此案例使用yml文件进行示例,也支持properties文件

app.yml

# 默认
app:
  title: My Application

app_en_US.yml

# 英文环境
app:
  title: My Application

app_zh_CN.yml

# 中文环境
app:
  title: 我的应用

代码中使用

    System.out.println(I18N.translate("app.title"));

不同的语言运行环境可以获取到不同的值。

说明

coodex-utitlites提供了一个实现作为I18N默认行为,基于Profile的国际化

  • i18n资源文件放在resources/i18n下,ProfileBasedTranslateService会自动检索,减少配置工作量
    • 资源文件支持yaml(依赖snakeyaml)和properties
    • 资源文件命名规范为namespace(_language)(_COUNTRY).yml|yaml|properties
      • namespace可以是多级,例如a.b.c,表明此命名空间下的i18n资源可在此文件中查找,资源内容中应该包含a.b.c.**
      • language可选,参考java.util.Locale.getISOLanguages(),大小写不敏感,推荐小写
      • country可选,参考java.util.Locale.getISOCountries(), 大小写不敏感,推荐大写
    • 检索优先级
      • 文件系统 高于jar包,方便资源修改
        • 名称不同的,越长越优先(匹配度越高)
        • 名称相同的,目录越深越优先
        • 深度相同的,按包字典序
        • 有language优先
        • 有country优先
        • 按profile支持的文件扩展名顺序

concrete-core中也提供了一个实现,基于jdk的ResourceBundles,已不推荐使用,保留对之前版本concrete的兼容性。

i18n还提供了一个扩展点org.coodex.util.DefaultLocaleProvider,用于获取默认的Locale,默认是根据当前运行的语言环境获取Localeconcrete-core中提供了一个基于ConcreteService调用者的语言环境作为默认环境的DefaultLocaleProvider,从而达到一套服务对多语言客户端的I18N.

(ɔ) coodex.org 2016 - 2020            修订时间: 2020-03-09 02:48:11

results matching ""

    No results matching ""