开发规范(rxc).doc

1 1 平台使用向导 命名规范 单元编号?单元编号尽量精简?组编号:子系统英文简称+ 功能名英文简称例如: cmis P roI nfo (或者简称 cmisPI ) 承包商项目信息?组下单元编号:子系统英文简称+ 功能名英文简称+[_ 功能后缀( form , list , query ) (英文单词,同时为 java 的包名) ]+[1,2,3,4 …] 后两项为可选项; 如果单元是简单父单元,也就是说,这个父单元是用来组织其他子单元的,那么该父单元编号不需要增加功能后缀;如: cmis P roI nfo ; 如果有多个这样的简单父单元的话,那么需要增加 a,b,c,d 等序号区分,如 cmis P roI nfo 1, cmis P roI nfo 2…; 否则,单元编号需要增加功能后缀,如 cmis P roI nfo _list , cmis P roI nfo _query ,如果组下有多个 list 或 query 或 form 时,则需要增加 1,2,3,4 等序号区分,如 cmis P roI nfo _list1, cmis P roI nfo _list2 …。注:子系统承包商管理系统,对应的子系统编号和英文简称如下: 承包商管理系统: cmis 风险评估系统: r mis 事故调查子系统: amis 提示消息?前台显示错误提醒,错误信息尽量详细,例如:输入不合法,开始日期必须在结束日期之前,等?业务编号: msg+ ”.”+ 消息类型( e: ERROR;w: WARNING;i: INFO )+”.”+ 模块单元编号例: ?平台编号: FU+ 六位编号例: ?统一向共通组申请,由共通组提供编号,申请同键值申请流程(即提供预想消息代码),此类消息代码前缀为“ msg ”?消息内容包括:编号及正文(编号同去掉 msg 的键值代码,正文中编号为大写) ?平台自己的提示需要加入编号。错误编号用括号”[]”与中文分割。注:消息分为三类: ERROR, WARNING, INFO. E RROR :系统显示为红色。内容为系统提示错误信息。(例:数值、英字符、日期等输入检验,业务相关检验, DB 异常,并发处理等)。 WARNING :系统显示为黄色。内容为系统提示的警告或提示信息。(例:对数据库进行增,删,改时的前台提示确认信息)。 INFO :系统显示为绿色。内容为系统提示处理成功信息。(例:操作数据库更新成功, ( XXX 行)数据导出成功等信息)。 2 Js 创建?子系统名+ 业务名称+ 两位编号例如: ?通用 JS 中间+Cmn 例如: ?注:编码格式为 UTF-8 注: 针对于列表,单选或多选未选中情况下进行提交时, 使用 js 前台检查,共通的 js 已经创建在 fastuni t /domain/cmn/ 下 调用方法 deleteCheck('url','unitID') 。 Js 编写规范?编写 js 时应注意 IE 兼容性问题,建议使用 ( )平台已经将 引入到单元中。例如: 获取当前页面 ID 为” aa “的元素?正常可以写为 ( ‘ aa ’); ? mootools 可写为$(‘ aa ’); 表 表创建?所有的业务表创建在 app 域下;当在其他域中引用表时,表达式为 app|tableName 。 表管理?通常不在平台中创建表,而是在数据库中创建表之后导入平台;输入表名,如果导入的表不是来自其他的数据库则数据源为空,点击导入(不能导入相同的表名)。下图为 OUNTRECV_TB 导入平台;需要注意以下几点。?数据类型: 必须与数据库字段类型保持一致。?值生成器:例如 createdate 创建时间,选择值生成器是为了不必程序处理,平台提供赋值功能,但数据类型是时间戳,值生成器也必须是时间戳,否则不会自动赋值。?生成规则:选择值生成器后,要选择生成规则,例如,创建时间生成规则选为新增; 表示在新增时才可按值生成器赋值。修改时间选择全部;表示新增、修改数据时都将按值生成器赋值。?版本字段:选择 updatecount 更新次数,唯一用来控制并发字段。 3 2 后台开发向导 命名规范 Package 命名 Package 的名字统一用小写英文单词书写? Package 的名字= 包前缀+ 包名?包前缀如下: +