Hpy系统自助终端面开发流程和规范版.docx

Hpy系统自助终端面开发流程和规范版.docx

《Hpy系统自助终端面开发流程和规范版.docx》由会员分享，可在线阅读，更多相关《Hpy系统自助终端面开发流程和规范版.docx（22页珍藏版）》请在冰豆网上搜索。

Hpy系统自助终端面开发流程和规范版

终端页面开发流程和规范版

文件状态：

[√]草稿

[]正式发布

[]正在修改

文件标识：

当前版本：

撰稿人：

李水生

完成日期：

发布时间：

编号：

2005年12月23日

版本历史

版本/状态

作者

参与者

起止日期

备注

草稿

Hipay系统自助终端页面开发流程和规范

一：

Hipay页面开发

1目录结构：

：

顶层目录结构图

（1）所示

Applications:

目录里放着我们创建的应用板块。

Framework:

里是Hipay系统应用，包含实体和服务板块

Base:

里放着启动，容器和配置和组件加载等公共类。

Data:

是Hipay内建的数据库。

Logs:

是系统日志文件夹。

是启动文件。

图

（1）

：

applications目录图

（2）所示

Accounting:

帐务管理，支付信息，发票等。

Content:

内容管理，调查等。

Ecommerce:

电子商务应用。

Order:

订单管理。

Party：

人员组织管理

Securityext:

安全管理拓展

Product:

产品管理。

:

板块加载配置文件。

图

（2）

：

ecommerce目录图（3）所示

Src:

java源文件。

Config:

配置文件，主要是多语言的配置文件

Data:

系统运行时需要导入的数据文件

Script:

Hipay系统mini-lang文件（简单Java方法）

Templates:

模板页面

Webapp:

web服务需要用到的页面和脚本

Widget:

用xml描述的页面

:

用ant工具编译src文件夹的源文件生成的classes文件和jar包放在build中。

:

电子商务板块加载配置文件。

图（3）

：

webapp目录

Webapp下有一个应用文件夹为ecommerce，其目录结构如图（4）所示:

除了WEB—INF文件夹以外，其他的文件都是页面文件，页面文件都是以ftl为后缀的freemaker模板页面。

图（4）

：

WEB—INF目录如图（5）所示

Actions:

系统脚本文件夹，beanshell脚本

：

流程控制器

：

网站参数设置

图（5）

：

actions目录如图（6）

其文件结构和图（4）中的ftl页面结构是对应的。

比如说显示购物车信息的页面放在图（4）cart文件夹中，则对应的脚本放在图（6）的cart文件夹中，这样做不是必需的，但是是规范的，易于维护的。

图（6）

：

widget目录

Widget是把ftl页面和bsh脚本组合起来供前端显示的工具。

它用xml语言和特定标签描述页面和页面，页面和脚本之间如何组合和定制。

是公共模板定制页面

是购物车相关页面定制

是产品，目录的显示的页面定制

是有关调查，寻价和客户方面的页面定制

是跟内容管理相关的页面定制

是跟订单和支付相关的页面定制

是公共模板加载的脚本

图（7）

其他板块的目录结构和ecommerce是相似的。

2开发内容

：

对widget组合页面要熟练掌握。

WebWidget是轻量级的Web应用程序，为使用者提供一键式的服务。

它通常被设计为具有特定的功能，如提供天气、股票、拍卖等的信息。

它与网页一样，使用标准的Web技术开发，如XHTML，CSS，javascript等。

从这方面看，Widget是脱离浏览器UI运行的网页。

beanshell脚本准备数据，freemaker页面显示数据，而widget工具正是组合脚本和页面的，它规定了哪个脚本为哪个页面组织数据，即起到绑定脚本和页面的作用，同时也可以定义某些变量供页面使用，当然有些页面可以没有脚本，简单的来说，widget就是用户请求页面，它把变量，标签和freemaker模板语言组合生成HTML页面，当用户请求时就发送给用户浏览器。

Widget用到的标签在framework/widget/dtd里的xsd文件里，如图（8）

图（8）

在eclipse开发环境下，有代码预示的功能，如图（9）

图（9）

图（10）

图（10）的

--?

的内容是注释，从图中的注释清楚地介绍的用widget如何定制一个模板。

screen

Screen标签对应的是前端请求的页面，页面的名称name属性是必须的。

section

Screen下有一个唯一的section，

section下包含condition，actions，widgets和fail-widgets标签。

condition

如果condition存在，并且condition是true则页面显示widgets内容，否则显示fail-widgets。

如果condition不存在，则fail-widgets标签也就没有必要。

以下是对attrName非空的判断：

是检查当前用户是否拥有对order的VIEW（查看）的权限

是把变量跟某个常量进行比较，操作包括lessgreaterequalsless-equalsgreater-equalsnot-equalscontains,分别表示，小于大于等于小于等于大于等于不等包含。

是把两个变量进行比较,type类型值可以为FloatDoubleIntegerLongBooleanStringPlainStringDateTimeTimestamp和Object，如果没有type默认为String。

and是对多个条件进行与操作or或操作xor异或not非

<条件1>

<条件2>

<条件1><条件2>

其他的标签请查看图（8）所示的文件中内容。

actions

actions是加载页面之前的动作。

常用的动作是：

set:

set定义一个变量并赋值field的值就是变量名value是变量值；

script:

script加载一个beanshell脚本文件，location是脚本的位置，

位置以”xyz/”开头，意思是在xyz这个板块下，xyz是在Hipay的安装目录下的applications和framework下的第一层子目录文件夹，如图

（2）得文件夹都可以作为这里的xyz。

property-map:

property-map加载一个属性文件，resource的值是文件的名称，文件后缀为properties,可省略不写，对于多语言，比如要加载简体中文配置文件和美国英语配置文件，并把配置文件的键值对放在一个Map即uiLabelMap中，作为全局变量是用，只需要这样一行代码：

这行代码会加载所有各种语言的配置文件，然后根据用户的locale，读取当时当地的语言配置。

还有一点需要注意，如果uiLabelMap在中找不到键值，它会去查找，如果没找到，则继续查找，如果仍然没有值则返回键本身，如果有则返回文件中定义的值；

widgets

Widgets是对页面的加载和布局。

常用的加载页面的方法包括

1：

platform-specific

为要加载的文件路径和名称。

即TMSBase这个板块下webapp文件夹的子文件夹TMSBase下的子文件夹includes下的文件。

2：

include-screen

这行代码的意思是加载一个页面，这个页面是在TMSBase这个板块下的widget文件夹下的文件里定义的abc页面。

abc是screen的name的值。

3：

decorator

另外，模板常用到这行代码，

意思是页面的body部分是空的，其他页面使用以下代码使用这个模板，

main-decorator是模板的名称（screen的name的值）

则其他页面的内容出现在body部分。

4：

container

Widget中可以加载容器容器里面可以加载其他页面，这类似于HTML中的DIV层。

以下代码是合法的：

和效果是等同的，其他类似。

5：

widget中的section

widgets中可以放置多个section

6：

其他

加载一个图片可以使用

页面上显示一行文字可用

其他的标签请查看图（8）所示的文件中内容。

fail-widgets

等同于widget标签，是条件不满足时给用户显示的页面。

：

对freemaker模板语言的熟练掌握

2.2.1：

各页面功能及存放位置

页面文件后缀为ftl，存放在图（4）所示的目录中，即webapp下的应用文件夹中

图（4）

自助终端目前用到的页面中有图（4）中的部分页面：

是主页面，用户返回时会到此页面，该页面左边显示分类，右边显示推广产品。

框架页面分三个部分框架上面部分占%是用户操作的业务页面，框架中间占%，是用来加载终端插件，框架下部是用来加载加密插件和进行加密验证的。

是语言选择页面。

是用户刷卡登陆页面。

cart下的页面（购物车页面）

catalog下的（终端屏幕的左边目录翻页页面）

customer下的（调查页面即用户的密码，号码输入页面）

error下的（错误页面）

includes下的：

模板头部导航栏加载样式表定制页面超时脚本

模板底部留个按钮

加载终端插件，是页面底部框架固定不动的部分，对于不同的终端，申明和条用插件的方式可能不同，此时需要编写多个厂家的底部框架页面。

工行自助终端用到的加密插件页面。

order下的

该页面显示正在支付中，请用户等候，该页面向后台传递了用户的支付方式，货物的运送方式，联系方式等等重要信息，不可或缺。

该页面是支付完成页面，显示支付结果，成功则用户可以选择打印凭条。

另外还用到了order板块的webapp下ordermgr的字文件夹entry的catalog的部分文件，如图（11）

图（11）

是天一终端的IE浏览器在进行银行卡打电话业务时显示的页面。

是芙蓉终端mozzila浏览器银行卡打电话页面

是显示产品分类的页面其指向categorydetail

是产品分类的详细信息页面其指向

是某一个分类下所有产品的简要介绍页面，在终端上就是显示在屏幕右边的四个按钮上的内容。

是产品页面其指向页面

页面是根据对产品的配置的详情页面来展示产品。

比如银行卡打电话这个产品就是配置成了,如果没有配置则默认显示页面

2.2.2：

常用的页面标签

以下例子中可以见到常用到了页面标签。