·软件知识库 ·模板素材库
注册 | 登录

您所在的位置: INDEX > eos > 构件包的资源文件配置与使用

构件包的资源文件配置与使用

许杰 Sun Jul 05 12:01:51 CST 2015 字号:

构件包的资源文件主要提供给异常和国际化使用。

异常资源文件是一个.preoperties类型的资源文件,由key=value这样的条目组成。Key表示异常的异常编码,value表示异常编码对应的异常消息内容。所有的异常编码需要在整个应用范围内考虑,保证整个应用范围内,所有的异常编码不能有重复。这需要在设计整个应用的时候为不同的构件包分配不同的异常编码字段区间,避免同一个应用中有不同的异常编码。
国际化资源文件,由一组.properties文件组成,由key=value这样的条目组成。Key表示需要国际化内容的key,value表示国际化内容。
所有的国际化资源需要遵守下面的命名规则:
"文件标示名称"+" _"+"Locale名称"+".properties"
举例:

i18n_en.properties 英文国际化文件
I18n_zh_CN.properties 中文国际化文件
国际化资源的key需要在构件包所属的应用中保持唯一。这需要在整个应用设计的时候,为不同的构件包分配不同的国际化key的字段区间,避免同一个应用中有不同的国际化key。

异常资源文件存放位置:构件包位置/配置/resources/exception/异常文件;
国际化资源文件存放位置:构件包位置/配置/resources/i18n/国际化资源文件。
场景描述

场景一:国际化场景
EOS6提供了页面流的功能,在页面流中提供了服务器端验证的功能。验证信息需要根据客户端请求的不同的Locale,返回不同Locale下对应的验证信息,此时需要使用EOS6提供的国际化资源配置功能。
验证用户登录的页面流,用户在登录页面传入用户名称,在服务器端校验用户传入的用户名称。如果用户名为null,则提示用户"用户名不能为空"。提示信息从国际化资源文件中获取。

场景二:异常场景
在构件包中开发业务逻辑,当发生特定的业务操作时候需要抛出特定的异常信息。逻辑流提供了异常抛出图元的操作,当发生任何异常操作的时候,都会将当前的异常信息放在逻辑流上下文的__exception节点中。在使用页面流调用逻辑流的情形下,会将当前的业务操作异常信息显示在系统设定的错误页面上,用户同样可以实现自己的异常错误页面,将异常信息根据自己业务的需要来实现。
处理客户订单,如果客户级别为A级,其订单的货物需要至少100份;否则处理该订单的时候抛出异常,提示用户"客户级别为A的客户,订货数量需要大于100"。

国际化的实现

开发一个页面流,用户需要在页面传入用户名称;EOS6的引擎会在服务器端校验用户提交的用户名,如果用户名为null,需要提示用户:"用户名不能为空"。
设置页面流的校验信息的国际化编码为"100001"。如下图所示。

 

设置国际化资源文件内容。可以直接配置构件包中"配置 -> resources -> i18n"下的i18n.properties文件,内容如下:
#I18N properties resource file.
#content format:
# code=message
#for example:
# 10000=name
100001=Name not null!
当使用国际化的key:100001的时候,将根据不同的Locale获取对应国际化文件中的国际化消息。

当用户请求页面流,并且没有填写用户名,经过服务器端校验后,将国际化的校验信息反馈给客户端,参见下图。

 

说明

更多关于国际化的使用说明请参考《EOS RichWeb开发指南》中基本页面标签"<b:message>"以及《EOS基础构件库参考》手册中的"EOS基础构件类国际化信息资源操作类ResourcesMessageUtil"的说明。

异常的实现......



『相关搜索』
版本信息:kms v1.3 鄂ICP备09005333号