基线版本二次开发规范指导文档

中电长城发卡机基线版本二次开发规范

v1.0

拟制：

审核：

批准：

中电长城（长沙）信息技术有限公司

应用开发团队

2015年03月03日

版本记录

目录

1. 概述 (3)

2. 遵循的原则 (3)

3. 一级目录结构介绍 (3)

3.1. Core目录 (3)

3.2. Base目录 (3)

3.3. App目录 (4)

4. 平台资源加载优先级 (4)

5. 二级目录 (4)

5.1. Flash主框架背景目录 (4)

5.2. Css样式目录 (5)

5.2.1. 命名 (5)

5.2.2. 引用 (6)

5.3. Local资源目录 (7)

5.3.1. 介绍 (7)

5.3.2. 目录结构 (7)

5.3.3. 资源分类 (7)

5.3.3.1. Image目录(动画、图片) (7)

5.3.3.2. Report目录 (8)

5.3.3.3. Sound目录 (8)

5.4. Mock目录 (8)

5.5. Tpl目录 (8)

5.6. Trans目录 (8)

6. 配置中的命名规则 (9)

6.1. Flexview.xml中name属性命名 (9)

6.2. action.xml中name属性命名 (9)

6.3. tran.xml中TranNO 属性命名 (10)

7. 常量定义 (10)

8. Session命名空间 (10)

9. 统一的session、application变量及页面参数访问 (10)

10. 平台组件参数初始化（JA V A类调试） (11)

1.概述

二次开发指在现有平台基线版本上，进行具体银行应用项目的具体业务代码实现或者通过评估后，对基线版本中的功能进行丰富和积累。

2.遵循的原则

遵循的原则主要有三点：

1、Core目录下的变更修改，由平台开发人员进行，应用开发者不能进行修改；

2、Base目录下的变更修改，有基线版本人员在机构讨论确认后，进行积累修改，应用开发者不能进行修改；

3、App目录下的变更修改，则有应用开发人员根据实际需要或从基线中将实际用到的功能模块提取拷贝到app下（实际中，如果功能不变，那么只需要拷贝具体模块下的flexviews.xml文件，目录结构和base目录结构保持一致）；或新增新的功能模块。

3.一级目录结构介绍

3.1.Core目录

在实际开发过程中，我们常关注的主要是tpl目录和script目录。

1、tpl目录下主要是我们常常使用到的JSP模板（在编写flexview.xml时会使用到）；

2、script目录主要是平台的封装的JS，涉及到主要有OCX控件的调用（如二代证，摄像头等），JS界面效果（如信息提示框），以及一些经常用到的JS对象方法。

3、CSS目录主要是核心提供给模板的css样式。

3.2.Base目录

该目录中主要是基线版本整理出来的常用业务功能。我们主要关注的是cfg目录、css 目录、local目录。

1、cfg目录下是平台基线版本的业务功能模块和相关的参数配置信息。

2、Css基线版本中页面样式设置，该目录下的样式文件，大量用途功能模块中的通用页面

设置上。

3、Local目录下主要是媒体资源文件

4、Tpl目录主要是进行基线版本开发时，早core目录下的模板无法满足需要，而自己进行模板编写放在该目录下。

5、Trans目录主要是基线版本开发中使用到的子JS或是子JSP，放到该目录下。

3.3.App目录

该目录主要是在具体的银行项目开发中使用，除了script目录使用较少外，其他都需要根据实际情况进行编写。

4.平台资源加载优先级

在实际银行项目开发过程中，我基于平台基线版本进行二次开发，可大大节省重复的开发工作，主要原因是基线中已经提供了实现好的功能模块，我们只需要在流程配置中加载进去即可，但由于各个银行的界面元素风格不同，因此需要进行flexview.xml、css、rpt模板、图片动画等等资源文件按照基线版本中的命名保持一致进行修改，从而达到在不改变功能实现上，通过替换来实现风格的转换。

因此，在app和base两个目录下的资源存在一个优先级别的关系，具体如下：

App/cfg下具体功能模块资源

(最高)App下全局资源

(次之)

Base/cfg下具体功

能模块资源

(再次之)

Base下全局资源

(最低)

1、App目录下功能资源文件，最高，例如：app/cfg/autocfg/业务功能，下的资源文件；

2、App目录下全局资源文件，次之，例如：app/css；

3、Base目录下功能资源文件，再次之，例如：base/cfg/autocfg/业务功能，下的资源文件；

4、Base目录下全局资源文件，最低，例如：base/css；。

资源加载，是由高到底进行，如果最高级有，则使用最高的，没有在降一级加载。以此类推。

5.二级目录

5.1.Flash主框架背景目录

该目录主要是在app一级目录下，有两个文件在不同项目中需要被替换

VTM.swf

Bg.jpg：背景图片

5.2.Css样式目录

该目录主要是应用的css样式目录，主要有文件：

Manage.css：主要是后台管理的通用按钮布局样式，及其他。

Common.css：主要是flexview.xml中的标签通用属性布局、样式。

Newcard.css：主要是发卡的通用按钮布局样式，及其他。

Style.css：平台提供的模板样式。

5.2.1.命名

Manage.css、Common.css、Newcard.css 下的样式命名，原则使用.文件名_开头，例如：1、Manage.css使用的是：

/** 界面显示3个按钮布局样式位置

.mag_3_butt_+编号（例如 .mag_3_butt_1,表示从左往右数，左边第一个按钮位置,

.mag_3_butt_0默认表示按钮隐藏不显示）

**/

.mag_3_butt_0{

top:840;

left:250;

}

.mag_3_butt_1{

top:840;

left:200;

}

.mag_3_butt_2{

top:840;

left:515;

}

.mag_3_butt_3{

top:840;

left:824;

}

2、Common.css使用的是：

/** fontName属性字体设置 **/

.common_fontName{

fontName:微软雅黑;

}

3、Newcard.css使用命名是：

/** 界面显示3个按钮布局样式位置

.newcard_3_butt_+编号（例如 .newcard_3_butt_1,表示从左往右数，左边第一个按钮位置,

.newcard_3_butt_0默认表示按钮隐藏不显示）

**/

.newcard_3_butt_0{

top:840;