Web应用程序中ResourceBundle技术分析

本篇内容介绍了“Web应用程序中Resource Bundle技术分析”的有关知识,在实际案例的操作过程中,不少人都会遇到这样的困境,接下来就让小编带领大家学习一下如何处理这些情况吧!希望大家仔细阅读,能够学有所成!

专注于为中小企业提供网站建设、成都网站建设服务,电脑端+手机端+微信端的三站合一,更高效的管理,为中小企业白云免费做网站提供优质的服务。我们立足成都,凝聚了一批互联网行业人才,有力地推动了1000多家企业的稳健成长,帮助中小企业通过网站建设实现规模扩充和转变。

背景概述

世界经济日益全球化的同时,一个应用程序需要在全球范围内使用势在必然。传统的程序设计方法将可翻译信息如菜单按钮的标签,提示信息,帮助文档等文字信息硬编码在程序代码中,不能很好的适应全球化发展,程序的扩展性差,维护成本高。一个能支持全球化的应用程序,必须实现单一可执行的程序,动态地使用资源(Single  Source Single Executable),图1 是两种模型的对比图。

图 1. 传统的程序模型和支持全球化程序模型

Web应用程序中Resource Bundle技术分析

Web应用程序中Resource Bundle技术分析

对于一个能支持全球化的应用程序来说:

一方面需要考虑的是用户的语言环境(我们称作 Language  Locale):这里主要就是指翻译,在不同的国家用他们自己的语言正确运作软件,让客户感觉这个产品是为他们而设计的;

另一方面就是用户的文化环境(我们称作 Culture  Locale):主要处理的是多元文化的支持,包括货币、日历、时间、日期、排序、界面方向性(Bi-directional)  等符合各个国家自己习惯的显示方式。

图2 概述了如何使得一个应用程序(C/S 或者 B/S)支持全球化和本地化。

图 2. 全球化应用程序

Web应用程序中Resource Bundle技术分析Web应用程序中Resource Bundle技术分析

本文结合项目实践,总结了 web 应用程序中 Java,JSP,Dojo 和 HTML 四种不同语言是如何管理 Resource Bundle  的,实现单一可执行程序动态读取资源文件,从而支持全球化和本地化。主要从三个方面来阐述:资源文件存储和命名规则;用户语言区域信息的读取;如何取得对应语言的资源文件中的键值。

Java 程序中的 Resource Bundle 管理

ResourceBundle 是一个机制,主要用来根据用户的语言环境展示不同的界面文字给用户,让用户感觉这个应用程序为我而定制。

然而 Java 中的 ResourceBundle 是一个类,包含在标准的 Java 发行版中。图3总结了 Java 程序中 ResourceBundle  的管理机制。

图 3. Java 程序 Resource Bundle 管理流程

Web应用程序中Resource Bundle技术分析

Web应用程序中Resource Bundle技术分析

Java 程序中资源文件的存储和命名

在一个多模块的 Java 应用程序中,一般每个模块都有自己独立的资源文件(也叫 Resource Bundles),Resource Bundle  一般存储在对应模块的 src/resources/bundles/java/ 目录下面。通常的命名规则是:模块名_语言_国家  .properties({moduleName}_{language}_{country}.properties)。对应资源文件中的每一个  key,一般都是小写字母开头,用下划线表示这个 key 在程序中的层级结构,并且按照字母顺序排序,便于管理和查找,如清单1所示的例子。

清单 1. Java properties 文件示例

英文Properties 文件:     helloKey=Hello!     goodMorningKey=Good Morning!     goodEveningKey=Good Evening!      日语Properties 文件:     helloKey=\u3053\u3093\u306b\u3061\u306f!     goodMorningKey=\u304a\u306f\u3088\u3046!     goodEveningKey=\u3053\u3093\u3070\u3093\u306f!

Java 程序对资源文件的回滚机制:当对应翻译的资源文件不存在时,将使用"默认"的资源文件(通常为英文),图 4 是 Java  资源文件的组织方式。

图 4. Java 资源文件组织方式

Web应用程序中Resource Bundle技术分析

Java 中用户语言环境(Locale)和资源文件的读取

根据用户使用的区域信息来决定从哪个 Resource Bundle 里面读取对应的 key 值。Java 语言通过 java.util.Locale  类来表示区域,一个 Locale 实例就代表了一个特定的区域。在实际的项目中,通常将读取资源文件包装成一个类,方便后续代码的重用和管理,如清单 2  的示例所示。

清单 2. Java 中 ResourceBundleService 使用

public class LocalizedPropertyResources extends MessageResources {  private static final String MODULE_NAME = "resourceBundle.module.name";  public String getProperty(String key, Object... parameters) {  Locale locale = getUserLocale();  String value = getProperty(key, locale, parameters);  Return value;  }  public String getProperty(String key, Locale locale, Object... parameters) {  ResourceBundle resourceBundle = ResourceBundle.getBundle(MODULE_NAME, locale);  String value resourceBundle.getString(key, parameters);  return value;  }  }

JSP 中的 Resource Bundle 管理

资源文件管理:JSP 是基于 Java 技术,所以 Java 中的 ResourceBundle 机制也可以应用于 JSP,同样以 .properties  形式存储资源文件,资源文件的命名规则、资源文件的存储结构,key 的命名规则等都可以遵循 Java 程序中的 Resource Bundle 管理机制。

用户语言环境的设定:HTTP 协议通过 Accept-Language 请求头将本地化信息从浏览器传递至服务器, JSTL fmt  库中的定制标记又会利用这些方法来自动地确定用户的语言环境,从而相应地调整它们的输出。同时用户也可以通过 来设置用户语言环境。

对于 JSP 中资源文件的读取有以下三种情况:

1、使用 fmt 消息标签:JSP 标准标签库(JSP Standard Tag Library,JSTL)中的  fmt标签支持通过资源文件(ResourceBundle)对文本内容进行本地化,该功能可以对一个特定的语言请求作出相应的响应,它使用了 J2SE 的  ResourceBundle 来保持各种翻译过的语言编码。另外用来设置地区,比如,这等于设定了语言和国家代码。默认 JPS 将读取  Accept-Language 信息。还可以指定 ResourceBundle,比如: 。一旦设定了 locale(地区)或  ResourceBundle,就可以使用 来把原文进行相应的转化,同时还可以使用<  fmt:requestEncoding/>来设定请求的字符编码。如清单3 示例所示:

清单 3. JSTL fmt 标签示例

//myTest.jsp <%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt" %>          JSTL fmt: Localized tag testing                         
       
    //也可以通过下面的方式获取资源文件         …     
     
      …    

2、被 Spring 管理的 JSP,通常 JSP 中有这样的 taglig"",这种情况下可以使用 Spring message 标签。

<%@ taglib prefix="spring" uri="http://www.springframework.org/tags" %>  

3、对于由 Struts 操作类提供的JSP,可以使用 Struts bean 消息标签:

<%@ taglib uri="/tags/struts-bean" prefix="bean" %>  

Dojo 中的 Resource Bundle 管理

Dojo 是一个 JavaScript 库,提供了一个有用的工具来创建丰富的 Web 客户端界面。同时 Dojo 也提供了 API  支持全球化功能,如翻译资源包,函数的格式化和解析日期、数字和货币,Dojo 对全球化的支持主要基于 CLDR (Common Locale Data  Repository) 和 ICU 的使用。 这一小节总结了 Dojo 中资源文件的管理,用户区域信息(locale)和资源文件的读取,如图5所示。

图 5. Dojo 中资源文件管理

Web应用程序中Resource Bundle技术分析

Web应用程序中Resource Bundle技术分析

Dojo 中资源文件的存储和命名

UTF-8 是 Dojo 程序编码的先决条件,Dojo 脚本一般将使用 HTML,JSP,Servlet,js等编写,所以这些文件必须以 UTF-8  编码。Dojo 用 JSON 格式来组织资源文件,首先在 /nls 目录下有一个主资源文件(一般是英文),主资源文件中定义了支持的区域,区域的值设置为 true  或者 false,如清单4所示。

清单 4. Dojo 主资源文件的定义

define({       root: {         OK: "Ok",         CANCEL: "Cancel",         OK_CANCEL: "${OK}, ${CANCEL}"       },       "ko": true,       "ja": true,       "ru": false,       "zh-cn": true     });

翻译的资源文件应放在/ nls / 目录中,目录的命名需要符合下面的规范:

  • 目录的名称必须要全部小写

  • 用横线(而不是下划线)分割语言和国家,比如 zh-cn,zh-tw 等,如清单5所示。

清单 5. 翻译资源文件的目录结构

/src/web/js/nls/menu.js       ... 主资源文件,用于默认的消息显示     /src/web/js/nls/ko/menu.js    ... 韩语的翻译文件                     /ja/menu.js    ... 日语的翻译文件                     /ru/menu.js    ...俄语的翻译文件                      /zh-cn/menu.js  ...简中的翻译文件                     ...

Dojo 资源文件的回滚机制为:在 / nls 目录的根目录下如果检测到区域设置,但 nls  目录中不存在特定于区域设置的资源,则将使用主包;当主资源文件中某个语言设置为 false 时,即使该语言的资源文件存在,也将使用主包。

Dojo 中用户语言环境(Locale)和资源文件的读取

Dojo 和 Java 以相同的方式支持用户区域信息,但 Dojo 和 Java 实现之间存在微小差异。

  • "Dojo 和 Java 对区域设置命名约定有一些区别,Dojo 使用" - "(连字符)作为连接语言代码,国家代码和变体的分隔符,而 Java  使用"_"(下划线)。例如,Java 中的 "zh_CN" 与 Dojo 中的 "zh-cn" 相似。

  • 像 Java 中的默认用户语言区域一样,Dojo 有一个全局变量 dojo.locale 用来存储默认 locale 值,但是我们不能直接修改  dojo.locale,可以通过 dojoConfig.locale 来对 dojo.locale 做初始化工作。

  • 如果 dojoConfig.locale 未定义,Dojo 使用浏览器的显示语言作为用户区域设置。另外 dojoConfig.locale  的设定需要在加载 dojo.js 之前,这样设置的 dojoConfig.locale 才会起效果。如清单 6 是一个示例将用户的 locale 信息保存在  sessionScope,然后传递给 dojoConfig。

清单 6. 将用户 locale 保存在 sessionScope 传递给 dojoConfig

var dojoConfig = {             async: 'sync',             baseUrl: '',             locale: '${sessionScope.userLanguageLocale}',                           bindEncoding: "utf-8",                 …         };

userLanguageLocale:是应用程序中用户所设定的 locale,每个应用程序可能不太一样。

Dojo 中有两种方式读取资源文件:

方式 1:又叫 AMD 方式,通过 dojo/i18n! 这个插件加载资源文件,首先检测 dojoConifg.locale 是否设置,如果设置了就读取  dojoConfig.locale,否则就会使用浏览器的显示语言读取对应的翻译资源文件。清单 7 是 dojo/i18n! 的使用示例。

清单 7. Dojo/i18n!使用示例

...    ...

方式 2: 使用 dojo.requireLocalization 加载资源文件,dojo.i18n.getLocalization  读取资源文件,这个是旧的资源加载方式,新的 Dojo 版本都将采用 AMD 的方式,不过这种方式用户可以指定 locale 信息,缺省 locale  的时候,采用和 AMD 同样的 locale 解析方式。清单8 是一个示例。

清单 8. Dojo. requireLocalization 使用示例

  ...

HTML 中的 Resource Bundle 管理

HTML 中的硬编码(Hard Code)通常分为两种情况:一种情况是 HTML 页面不涉及任何编程逻辑,这时候可以翻译整个 HTML  文件(这种方式在开发过程中不需要特殊处理),或者将 HTML 变更为 JSP,这样就可以利用 JSP 中 fmt 标签将 Hard Code 提取出来,如清单  9 示例所示。

清单 9. HTML 更改为 JSP

//Index.html        window.location = "/login.do";     Welcome Page       …      //将 Index.html 更改为 Index.jsp,这样就可以利用 JSP 中 fmt 标签  <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>  <%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>        …     <fmt:message key="common_welcome" /></ title>  </head>  <body>  …  </body>  </html>  //test.properties  Common_welcome=Welcome Page  …</pre><p>//将 Index.html 更改为 Index.jsp,这样就可以利用 JSP 中 fmt 标签</p><p>另外一种情况是 HTML 作为 Dojo widget 模板文件,这种情况下可以使用 dojo API 的 i18n 库来处理硬编码消息,其处理方式和  Dojo 很类似,模板 HTML 文件中使用的 Key 需要在 Widget 的 js 文件中定义和获取。下面将通过示例介绍 HTML 作为 Dojo  模板文件时,如何抽取当中的 hard code 信息。通常分三个步骤完成模板 HTML 文件中的字符串抽取。</p><p>***步: 将 HTML 中的字符串放到一个资源文件如 message.js 中,资源文件的组织方式和 Dojo 是一样的;</p><p>第二步: 在 Dojo widget 的 js 文件中使用 Dojo Resource Bundle 获取资源文件,定义变量获取对应的Key值;</p><p>第三步: 在HTML模板文件中使用 Dojo .js 文件中定义的变量。如清单 10 所示。</p><p><strong>清单 10. HTML 作为 Dojo Widget 模板</strong></p><pre>Test.html  <div dojoAttachPoint="testNode" style="display:inline">  <table style="position: relative; margin: 20px 0 0 120px; padding: 0;">  <tr>  <td style="text-align: right;">Username:</td> //原来的 hard code  <td style="text-align: right;">${usernameLabel}</td> //Resource out 之后的变量引用  ….  </tr>  </div>  Test.js  dojo.requireLocalization("js", "message");  dojo.declare("Test") {  templatePath: dojo.moduleUrl("common", " /html/Test.html"),  usernameLabel: "",  postMixInProperties: function(){  this.inherited(arguments);  var resources = dojo.i18n.getLocalization("js", "message");  this.usernameLabel = resources.labels.username; //获取资源文件  }  }</pre><p>清单 11. HTML 中特殊硬编码处理</p><pre>// Hard Code  <html>  <body>  <select id="Product">  <option>Is Not</option>  <option>Is</option>  </select>  </body>  </html>  //处理后的 HTML  <html>  <body>  <select id="Product">  <option value="Is Not"> ${ Label.IS_NOT}</option> <option value="Is">${Label.IS}</option>  </select>  </body>  </html></pre><p>“Web应用程序中Resource Bundle技术分析”的内容就介绍到这里了,感谢大家的阅读。如果想了解更多行业相关的知识可以关注创新互联网站,小编将为大家输出更多高质量的实用文章!</p>            
            
                                <br>
                    当前文章:Web应用程序中ResourceBundle技术分析                    <br>
                    浏览路径:<a href="http://csdahua.cn/article/jpcgdi.html">http://csdahua.cn/article/jpcgdi.html</a>
                </div>
                <div class="view-qrocde cl">
                    <div class="m z"><img src="/Public/Home/images/ew.jpg"/></div>
                    <div class="text">
                        <h6>扫二维码与项目经理沟通</h6>
                        <p>我们在微信上24小时期待你的声音</p>
                        <p>解答本文疑问/技术咨询/运营咨询/技术建议/互联网交流</p>
                    </div>
                </div>
                <div class="othernews cl">
                    <h3>其他资讯</h3>
                    <ul>
                        <li><a href="/article/hpdigi.html">go语言提升资源 go语言优化</a></li><li><a href="/article/hpdihj.html">ztreejava代码 ztree java</a></li><li><a href="/article/hpdihg.html">php面试数据库 php基础面试</a></li><li><a href="/article/hpdijs.html">vb.net遍历选项卡的简单介绍</a></li><li><a href="/article/hpdiji.html">平时怎么使用mysql 平时怎么使用网络</a></li>                    </ul>
                </div>
            </div>
        </div>
        <div class="sidebar">
            <div class="tuijian">
                <a href="#">
                    <h2 class="cl"><span>行业动态</span></h2>
                    <h3>企业网站建设的重要性!</h3>
                    <p>现在虽然是移动互联网时代,但企业网站依然重要,包含PC站点,移动站。可以说企业网站关系企业的未来发展和前途,尤其对中小企业更是如此,一些中小企业老板,对自己的名片很在乎,因为这是个门面。...</p>
                </a>
            </div>
            <div class="ser sidesub">
                <h2>服务项目</h2>
                <ul class="ebox">
                    <li class="sub sub-1">
                        <div>
                            <h3>网站建设</h3>
                            <p></p>
                            <a class="btn" href="/serve/website/">查看详情</a>
                        </div>
                    </li>
                    <li class="sub sub-1">
                        <div>
                            <h3>移动端/APP</h3>
                            <p></p>
                            <a class="btn" href="/serve/moblie/">查看详情</a>
                        </div>
                    </li>
                    <li class="sub sub-1">
                        <div>
                            <h3>微信/小程序</h3>
                            <p></p>
                            <a class="btn" href="/serve/small/">查看详情</a>
                        </div>
                    </li>
                    <li class="sub sub-1">
                        <div>
                            <h3>技术支持</h3>
                            <p></p>
                            <a class="btn" href="/serve/tech/">查看详情</a>
                        </div>
                    </li>
                    <li class="sub sub-1">
                        <div>
                            <h3>其它服务</h3>
                            <p></p>
                            <a class="btn" href="/serve/othe/">查看详情</a>
                        </div>
                    </li>
                    <li class="sub sub-5">
                        <div>
                            <h3>更多服务项目</h3>
                            <p> <a>用我们的专业和诚信赢得您的信赖,从PC到移动互联网均有您想要的服务!</a></p>
                            <a class="btn" href="/serve/">获取更多</a>
                        </div>
                    </li>
                </ul>
            </div>
            <div class="contact" id="fix">
                <h2 class="cl"> <span>联系吧</span> <a href="https://map.baidu.com/" class="ditu" rel="nofollow" target="_blank">在百度地图上找到我们</a> </h2>
                <h3>电话:13518219792</h3>
                <p>如遇占线或暂未接听请拨:136xxx98888</p>
                <div class="qq"> <a href="//wpa.qq.com/msgrd?v=3&uin=244261566&site=qq&menu=yes" rel="nofollow" target="_blank">业务咨询</a> <a href="//wpa.qq.com/msgrd?v=3&uin=244261566&site=qq&menu=yes" rel="nofollow" target="_blank">技术咨询</a> <a href="//wpa.qq.com/msgrd?v=3&uin=244261566&site=qq&menu=yes" rel="nofollow" target="_blank">售后服务</a> </div>
            </div>
        </div>
        <script>
            //固定滚动
            (function () {
                var oDiv = document.getElementById("fix");
                var H = 120,
                    iE6;
                var Y = oDiv;
                while (Y) {
                    H += Y.offsetTop;
                    Y = Y.offsetParent
                };
                iE6 = window.ActiveXObject && !window.XMLHttpRequest;
                if (!iE6) {
                    window.onscroll = function ()
                    {
                        var s = document.body.scrollTop || document.documentElement.scrollTop;
                        if (s > H) {
                            oDiv.className = "contact  fixed";
                            if (iE6) {
                                oDiv.style.top = (s - H) + "px";
                            }
                        } else {
                            oDiv.className = "contact ";
                        }
                    };
                }

            })();
        </script>
    </div>
    <div class="footer">
        <div class="wp">
            <div class="wpss cl">
                <dl class="about">
                    <dt>网站制作</dt>
                    <dd><a href="http://m.cdcxhl.cn/mobile/" target="_blank" title="手机网站制作">手机网站制作</a></dd><dd><a href="http://www.cqcxhl.com/" target="_blank" title="网站制作">网站制作</a></dd><dd><a href="http://www.cdxwcx.cn/" target="_blank" title="成都网站制作">成都网站制作</a></dd><dd><a href="https://www.cdxwcx.com/wangzhan/shop.html" target="_blank" title="成都商城网站制作">成都商城网站制作</a></dd>                </dl>
                <dl class="about">
                    <dt>网站建设</dt>
                    <dd><a href="http://chengdu.cdcxhl.cn/shop/" target="_blank" title="成都商城网站建设">成都商城网站建设</a></dd><dd><a href="http://www.kswsj.com/" target="_blank" title="成都网站建设">成都网站建设</a></dd><dd><a href="http://www.kswcd.com/service/" target="_blank" title="高端网站建设">高端网站建设</a></dd><dd><a href="http://chengdu.cdweb.net/" target="_blank" title="成都网站建设">成都网站建设</a></dd>                </dl>
                <dl class="about">
                    <dt>网站设计</dt>
                    <dd><a href="http://www.cdkjz.cn/" target="_blank" title="高端网站设计">高端网站设计</a></dd><dd><a href="http://www.ybwzjz.com/" target="_blank" title="宜宾网站设计">宜宾网站设计</a></dd><dd><a href="http://www.abwzjs.com/" target="_blank" title="阿坝网站设计">阿坝网站设计</a></dd><dd><a href="http://www.cdxwcx.cn/sheji/" target="_blank" title="企业网站设计">企业网站设计</a></dd>                </dl>
                <dl class="contact">
                    <dt>联系我们</dt>
                    <dd>电话:13518219792</dd>
                    <dd>邮箱:631063699@qq.com</dd>
                    <dd>地址:成都青羊区锦天国际1002号</dd>
                    <dd>网址:www.csdahua.cn</dd>
                </dl>
                <dl class="flow">
                    <dt></dt>
                    <div class="ma cl">
                        <div class="m"> <img src="/Public/Home/images/ew.jpg" />
                            <p>微信二维码</p>
                        </div>
                    </div>
                </dl>
            </div>
        </div>
        <div class="footer-link wp">
            <ul class="wpss cl">
                <li class="fisrt">友情链接</li>
                <li><a href="http://www.rxlvshi.com/" title="成都法律咨询" target="_blank">成都法律咨询</a></li><li><a href="http://www.cxhljz.cn/wechat/" title="微信公众号开发" target="_blank">微信公众号开发</a></li><li><a href="http://www.cxjianzhan.com/seo/" title="seo关键词优化" target="_blank">seo关键词优化</a></li><li><a href="http://m.cdcxhl.cn/qiye/
" title="企业网站建设公司" target="_blank">企业网站建设公司</a></li><li><a href="http://www.cqcxhl.com/" title="重庆做网站" target="_blank">重庆做网站</a></li><li><a href="http://www.cdtuopan.cn/" title="成都木托盘" target="_blank">成都木托盘</a></li><li><a href="http://www.lszwz.com/" title="乐山网站建设" target="_blank">乐山网站建设</a></li><li><a href="https://www.xwcx.net/zuyong.html" title="租用服务器" target="_blank">租用服务器</a></li><li><a href="http://www.cdxwcx.cn/tuoguan/xiyun.html" title="成都西云机房" target="_blank">成都西云机房</a></li><li><a href="http://www.pcwzsj.com/" title="平昌做网站" target="_blank">平昌做网站</a></li>            </ul>
        </div>
    </div>
    <div class="bot-footer">
        <div class="wp">
            <p class="wpss"> <em>Copyright © 2002-2023 www.csdahua.cn 快上网建站品牌 QQ:244261566 版权所有</em> <em>备案号:<a href="http://beian.miit.gov.cn/" rel="external nofollow">蜀ICP备19037934号</a></em>
            </p>
            <p class="wpss" style="line-height:30px !important;"> </p>
        </div>
    </div>
    <div class="footer-kefu">
        <ul>
            <li class="qq"><a href="https://wpa.qq.com/msgrd?v=3&uin=244261566&site=qq&menu=yes"><em></em>在线咨询</a>
            </li>
            <li class="tel"><a href="tel:13518219792" target="_blank"><em></em>13518219792</a></li>
            <li class="wx"> <em></em>
                <div class="code"> <img src="/Public/Home/images/ew.jpg" />
                    <p>微信二维码</p>
                </div>
            </li>
            <li class="m"> <em></em>
                <div class="code"> <img src="/Public/Home/images/ew.jpg" />
                    <p>移动版官网</p>
                </div>
            </li>
            <li class="top"><em></em></li>
        </ul>
    </div>
    <script src="/Public/Home/js/all.js"></script>
</body>
</html>
<script>
    $(".cont img").each(function(){
        var src = $(this).attr("src");    //获取图片地址
        var str=new RegExp("http");
        var result=str.test(src);
        if(result==false){
            var url = "https://www.cdcxhl.com"+src;    //绝对路径
            $(this).attr("src",url);
        }
    });
    window.onload=function(){
        document.oncontextmenu=function(){
            return false;
        }
    }
</script>