国际化（i18n）、多语言、本地化

1、支持登录时，指定语言，或登录后进行语言切换（param_lang=en）

2、支持 Cookie 存储语言设置，没有 Cookie 的情况使用 Session 存储，支持移动端

3、支持 properties 文件、数据库存储译文，方便译文数据进行管理。

4、可翻译：固定数据（如：页面标题、标签、消息提示）、动态数据（如：菜单数据、字典数据等）

5、中文免写 zh_CN 译文，如：text(‘你好’)，找不到对应 key 直接原样输出 “你好”

6、支持 kay 和译文参数，如：text(‘今天第{0}天’, 3)，输出 “今天第3天”

注意此功能是专业版功能，只有专业版才能使用。

语言文件

后端语言文件

固定数据语言

不会变化的文字翻译，如：某个提示信息，字段 label，列表标题，按钮文字等，这些译文需要放到 properties 里。

文件目录结构，支持模块化分类语言文件结构，如下：

  1. /src/main/resources/messages/模块编码/i18n_语言编码.properties

例如：msg 模块 en 译文配置：

  1. /src/main/resources/messages/msg/i18n_en.properties

文件内容：

  • 文件内容采用 key=value 方式存储，如：你好=Hello
  • 若Key中包含空格，可使用“\”转义，如：提\ 交=Submit
  • 带参数的译文，如：今天第\ {0}\ 天。= Today is the {0} day. 在系统字典中维护新增加的语言：sys_lang_type，字典编码为语言编码；

动态数据语言

业务或管理员可通过数据库进行修改或配置的一些文字译文，如菜单名称，字典名称，字典值等。

这些可通过 system 账号登录，进入菜单 “系统管理 -> 系统设置 -> 国际化管理” 添加译文。

前端语言文件

根据需求自己扩展语言文件，例如：

  1. <script src="${ctxStatic}/modules/i18n/i18n_${lang()}.js" ></script>

举例内容如下：

  1. window.jeesiteMessage = $.extend({}, window.jeesiteMessage, {
  2.     '你好' : 'Hello',
  3.     '今天第 {0} 天' : ' Today is the {0} day.'
  4. });

语言调用方法

Java

1、获取语言名称：Global.getLang()

返回：en、zh_CN

2、获取语言编码译文：Global.getText(code)

例如：Global.getText(“你好”)

3、获取语言编码译文，支持参数：Global.getText(code, params…)

例如：Global.getText(“今天第{0}天”, 3)

4、在集成 BaseController 和 BaseService 的类里可直接通过

例如：text(code) 或 text(code, params…)

Beetl视图

1、获取语言名称：${lang()}

返回：en、zh_CN

2、获取语言编码译文：${text(code)}

例如：${text(“你好”)}

3、获取语言编码译文，支持参数：${text(code, params…)}

例如：${text(“今天第{0}天”, 3)}

JavaScript

1、获取语言名称：window.lang ‘zh_CN’

返回：en、zh_CN

2、获取语言编码译文：text(code)

例如：text(“你好”)

3、获取语言编码译文，支持参数： text(code, params…)

例如：text(“今天第{0}天”, 3)

常用语言编码

java.util.Locale ：

  1. public static final Locale ENGLISH = createConstant("en", "");
  2. public static final Locale FRENCH = createConstant("fr", "");
  3. public static final Locale GERMAN = createConstant("de", "");
  4. public static final Locale ITALIAN = createConstant("it", "");
  5. public static final Locale JAPANESE = createConstant("ja", "");
  6. public static final Locale KOREAN = createConstant("ko", "");
  7. public static final Locale CHINESE = createConstant("zh", "");
  8. public static final Locale SIMPLIFIED_CHINESE = createConstant("zh", "CN");
  9. public static final Locale TRADITIONAL_CHINESE = createConstant("zh", "TW");
  10. public static final Locale FRANCE = createConstant("fr", "FR");
  11. public static final Locale GERMANY = createConstant("de", "DE");
  12. public static final Locale ITALY = createConstant("it", "IT");
  13. public static final Locale JAPAN = createConstant("ja", "JP");
  14. public static final Locale KOREA = createConstant("ko", "KR");
  15. public static final Locale CHINA = SIMPLIFIED_CHINESE;
  16. public static final Locale PRC = SIMPLIFIED_CHINESE;
  17. public static final Locale TAIWAN = TRADITIONAL_CHINESE;
  18. public static final Locale UK = createConstant("en", "GB");
  19. public static final Locale US = createConstant("en", "US");
  20. public static final Locale CANADA = createConstant("en", "CA");
  21. public static final Locale CANADA_FRENCH = createConstant("fr", "CA");

语言代码表：http://www.lingoes.cn/zh/translator/langcode.htm