国际化支持(I18N)
本章译者:@nixil
使用国际化支持(I18N)能够使你的应用根据用户所在地区的不同选择不同的语言。下面介绍如何在引用中使用国际化。
只允许使用UTF-8
Play只支持UTF-8一种字符编码.这是因为多编码会导致十分诡异难以处理的问题,所以我们决定仅支持一种。UTF-8编码涵盖了所有语言的所有字符。
确认你的应用程序的每个角落都是使用UTF-8编码,也就是说:
- 所有的源文件都要用UTF-8来编写
- HTTP头中也要使用UTF-8
- 把所有HTML页面的meta标签都设置为UTF-8
- 如果使用了数据库的话,将数据库的字符集也设置为UTF-8, 并且数据库连接也要使用UTF-8
提示
因为想要一致使用UTF-8编码,所以Play的大多数配置文件都没有被命名为@xxx.properties@,虽然事实上他们就是properties文件。这是因为Java强迫规定了properties文件必须使用**ISO-8859-1**编码,而Play喜欢UTF-8,懂啦?
外部化Message
支持I18N的第一步是将所有的message(也就是你想要国际化的信息)都提取到外部资源文件中。
在应用的conf目录下创建一个名为messages的文件,它其实就是一个Java properties文件的格式。
hello=Hello!
back=Back
然后,你就可以为每种语言创建一个对应的message文件,其扩展名为ISO标准的语言代码
例如,包含了中文翻译的资源文件应该被命名为conf/messages.zh,其中的内容可能是
hello=你好!
back=回退
定义程序支持的语言类型
在application.conf文件中加入要支持的语言种类。例如application.langs=fr,en,ja
当用户第一次向发来请求时,Play会通过解析http头中Accept-language的值来猜测用户的想要的语言, 并以@PLAY_LANG@作为键值保存在cookie中,这样下一次请求发来的时候将使用同样的语言。
如果有需要的话,可以通过en_US,en_GB或zh_CN,zh_TW这样的扩展名来区别支持同一语言的不同变种。然而值得注意的是某些用户可能只会提供语言信息而不提供所在国家的信息,因此,你总是应该提供一个扩展名中不包含国家代码的资源文件。
例如,如果你大部分的用户是来自美国,而你想要支持英式英语,推荐的做法是使用messages.en来支持作为默认的美式英语资源文件的扩展名,而使用en_GB来支持英式英语。
在程序代码中,你可以通过访问play.i18n.Lang对象来获取当前使用的语言
String lang = Lang.get();
如果想要永久性的改变用户的语言,可以使用change()方法:
Lang.change("ja");
新的language值将会保存在用户的cookie中
利用locale设置日期格式
可以在配置文件中通过设置“date.format”的值来指定默认的日期格式
对于特定地区,可以通过设置date.format.{locale}来指定针对该地区的日期格式,如
date.format.fr=dd/MM/yyyy
获取本地化消息
消息参数
在程序代码中可以使用@play.i18n.Messages@对象来获取定义在资源文件中的message。
public static void hello() {
renderText(Messages.get("hello"));
}
我们支持使用标准的@java.util.Formatter@的‘‘Format string syntax’,你可以在message中定义需要动态替换的内容
hello=Hello %s!
where %s
represents a message argument that will be output as a String
. Message arguments are provided by additional (varargs) arguments to Messages.get
:
这里@%s%代表一个字符串类型的占位符。用来替换值作为@Message.get@方法的额外参数来传入。
public static void hello(String user) {
renderText(Messages.get("hello", user));
}
在模板中输出消息参数
在模板中你可以使用特殊的@&{...}@语法来显示本地化消息
<h1>&{'hello'}</h1>
或者像这样使用有动态替换的消息参数
<h1>&{'hello', params.user}</h1>
多参数
你可以在一条message中定义多个参数,例如下面这个,就使用了两个‘数字类型’的参数
guess=请输入一个介于%d和%d中间的数字
这两个参数将按照传入的顺序分别替换message中的两个占位符
bc.
&{‘guess’, low, high}
参数索引
消息参数的索引默认与其顺序相同,你也可以显示的指定索引,从而指定参数顺序。例如下面这个英文message的定义中有两个参数:
guess.characteristic=Guess %s’s %s.
模板中像这样使用:
<p>&{'guess.characteristic', person.name, 'age'}</p>
而对应的法语翻译文件中,这两个参数的位置却是相反的,所以这时候我们需要显示的为法语资源文件的参数指定顺序。
guess.characteristic=Devinez %2$s de %1$s.
这里我们使用了@%2$s@来输出**第二个**十进制整形参数
最后,我们想要为这个本地化文件加入一个特有的“age”,于是我们修改一下输出,来使用消息的key@person.age@,将这个message在英语和法语中的定义修改为:
guess.characteristic=Guess %s’s &{%s}.
person.age = age
和
guess.characteristic=Devinez &{%2$s} de %1$s.
person.age = l’age
这里@&{%s}@的作用是使用参数值来作为消息的key,在资源文件中进行匹配。
Continuing the discussion
Next: Cache.
国际化支持(I18N)的更多相关文章
- Java国际化(i18n)
Java国际化(i18n) 最近在做一个网站国际化的功能.用Java做开发,使用spring+velocity. Java提供了对i18n的支持,spring对其做了集成,可以很方便的配置.主要思想就 ...
- SpringMVC国际化支持
这周公司领导希望我对一个项目,出一个国际化的解决方案,研究两个小时,采用了SpringMVC的国际化支持,在此记录下. 原理: 在DispatchServlet中注册localeResolver(区域 ...
- 使用JSP的fmt标签实现国际化支持 - smart-framework ; smart-plugin-i18n
使用JSP的fmt标签实现国际化支持 Smart-framework框架使用smart-plugin-i18n插件来完成国际化处理,原理相同,使用过滤器进行参数设置. ============== ...
- 配置CLion管理Qt项目国际化支持
随着Qt 6的发布,cmake也正式宣告接管qmake的工作了. 在之前的一篇博客里我介绍了如何使用cmake管理你的qt项目,不过有一点我没有讲,那就是对国际化(i18n)的处理. 今天我们就来介绍 ...
- 【SpringBoot基础系列】手把手实现国际化支持实例开发
[SpringBoot基础系列]手把手实现国际化支持实例开发 国际化的支持,对于app开发的小伙伴来说应该比价常见了:作为java后端的小伙伴,一般来讲接触国际化的机会不太多,毕竟业务开展到海外的企业 ...
- iOS国际化支持
写给自己看: 1.先创建一个国际化文件,用于描述在不同的区域环境,显示不同的value.文件名必须是Localizable.strings,文件的内容稍后再写.
- Spring ApplicationContext的国际化支持
ApplicationContext接口继承MessageSource接口,因此具备国际化功能.下面是MessageSource接口定义的三个国际化方法. >String getMessage( ...
- java框架篇---Struts2 本地化/国际化(i18n)
国际化(i18n)是规划和实施的产品和服务,使他们能很容易地适应特定的本地语言和文化的过程中,这个过程被称为本地化.国际化的过程有时也被称为翻译或本地化启用.国际化是缩写i18n,因为我和两端用n字打 ...
- 【Spring学习笔记-3】国际化支持
[Spring]国际化支持 一.总体结构: 两个国际化资源中的内容: 二.程序 2.1 配置Spring上下文 beans.xml文件 <?xml version="1.0" ...
随机推荐
- 关于Thread.currentThread()和this的差异
重新来看多线程时,被这结果搞懵逼了.不多说,直接上代码: public class MyThread02 extends Thread { public MyThread02() { System.o ...
- Sql Server 的本地时间和UTC时间
一,本地时间和UTC时间 本地时间 世界的每个地区都有自己的本地时间,整个地球分为二十四时区,每个时区都有自己的本地时间. UTC时间 在国际无线电通信中,为统一而普遍使用一个标准时间,称为通用协调时 ...
- CSS中的::after ::before
利用::after和before来清除浮动 <!DOCTYPE html> <html lang="en"> <head> <meta c ...
- JavaScript垃圾回收(三)——内存泄露
一.JavaScript内存监测工具 在讨论内存泄露之前,先介绍几款JavaScript内存监测工具. IE的sIEve与JSLeaksDetector(这两个可以在下面的附件中下载),firefox ...
- G++ 参数介绍(转载)
g++参数介绍 From: http://www.cnblogs.com/lidan/archive/2011/05/25/2239517.html gcc and g++分别是gnu的c & ...
- 吐槽坑爹的微软win store app审核
从学习win store app 开发到做出第一个应用 博客园cnblogs 花了一个多月的全部业余和上班空闲时间, 上周在端午节放假期间终于完成了计划的全部开发和测试, 6月10号怀着无比激动的心情 ...
- Windows Azure Cloud Service (37) 浅谈Cloud Service
<Windows Azure Platform 系列文章目录> 最近在和一些客户聊天,常常被遇到这样的问题: 1.问题一:我在创建一个新的Windows Azure Virtual Mac ...
- path入门 20141102-1405
那Python有哪些缺点呢? 第一个缺点就是运行速度慢,和C程序相比非常慢, 第二个缺点就是代码不能加密. Python是解释型的 不是编译型的 Python解释器-CPython 命令行: 只需要在 ...
- Elasticsearch 安装与启动
平台支撑 ES支持在不同的平台上运行,下面这幅图中,对号标记的是经过测试的平台,其他的也可以运行,但是可能会出现BUG. 下载与安装 在官网下载地址就可以进行下载. 然后解压,进入bin目录,运行下面 ...
- Elasticsearch——使用_cat查看Elasticsearch状态
Elasticsearch通过使用JSON来作为沟通的数据格式,这对于开发者来说很友好,因为很多程序都支持JSON格式.比如js就不说了,Java也有fastjson,ruby什么的都自带json. ...