第十一章 ireport 5.5教程之国际化.pdfVIP

ireport5.5教程之国际化 国际化意味着报表可以根据不同的地区显示不同的语言文字。报表所要显示 的不同的语言文字是存储在资源文件里。在本章中我们将介绍怎样使用内置函数 msg()来处理国际化问题。 资源文件 当我们想让一个报表实现国际化功能时 ，我们需要定位所资源文件里的名称 字符串，就是label或者叫key，key与value是一对字符串，中间用 “=”连 接。如： Title_username=用户名 Title_phone=电话号码 保存这些key与value对的文件以 “.properties”为后缀。在运行期间， 报表引擎将会在classpath里查找以 “.properties”结尾的资源文件。如果文件 找到了 ，那么就从文件里读取相应的资源信息。资源文件的指定是通过报表属性 窗口的 “i18n”来实现的。 一般来说 ，一个资源文件名的组成包括三个部分 ：一个是资源文件名 ，一个 是国家地区代码（与文件名之间以 “_”连接），最后就是文件的扩展名 “.properties”。对于默认的资源文件名来说是没有国家地区代码的。完整的 资源文件的格式如下： resourcebundlebasename[_languagecode[_country code[_othercode]]].properties 比如： I18nReport_fr_CA_UNIX.properties I18nReport_zh_CN.properties I18nReport_en.properties I18nReport.properties 前面格式里提到的 “othercode” （比如上面的“_UNIX”）一般不去指 定它。 在iReport中，它有能力自己去管理资源文件 ，资源文件我们需要把它和报 表文件(jrxml文件)放在同一目录，并且资源文件的名称也要与报表文件的名称 保持一致。 我们可以从主菜单的 “EditàInternationalication”的 “Localizationfiles” 打开资源文件管理窗口。如下图： 我们可以通过 “Create NewLocale”按钮创建一个新的资源文件。 创建时我们需要指定文件名及国家代码 ，创建完成之后我可以通过“Modify file”按钮来对资源文件的内容做相应的修改。 获取本地化字符串 得到资源文件里的key所对应的vlaue我们可以通过下面的方法实现：一 种是使用JasperReports 内部的表达式str( “keyname”) ，或者是使用表达式 $R{keyname} ： $R{test.name} 在JasperReport中的国际化我们可以使用函数msg，通过使用msg函数 我们可以对取到的国际化的值做相应的格式化处理。比如我们的资源文件中一个 key/value对为： title=my nameis{0} 此时我们需要为{0}指定具体的值 ，通过使用msg函数我们可以对这里的{0} 进行填值处理： msg($R{title},gaojie) 这样在报表生成后最终的值就是：mynameisgaojie 我们有三种方式来使用msg函数： PublicStringmsg(Stringpattern,Objectarg0) PublicStringmsg(Stringpattern,Objectarg0,Objectarg1) PublicStringmsg(Stringpattern,Objectarg0,Objectarg1,Object arg2) 在iReport中我们可以指定所在地区，这样我们就可以控制显示的语言。点 击主菜单 “Buildàsetreportlocalor BuildàSettimezone” ，在弹