苏宁连锁发展业务需求中共通模块的概要设计说明书Word格式文档下载.docx

1、GT0203提交域检查检查text，textarea,redio,checkbox,select内容。包括：必输项，类型。5. 画面迁移图无6. 画面功能说明6.1. GT0101 附件上传图 GT0101_1 附件上传图 GT0101_2 附件浏览I动作描述动作动作描述关联数据表初期化（init） 根据传入的参数初始化附件分类和已上传附件列表。参数一览：1. 附件主类型编号参数：form.attMainType2. 关联主键（最多5个）form.referenceKey，以逗号分隔3. 附件子类型编号（可选）form.attSubType4.编辑模式（可选） 参数：form.viewMode

2、 值：true：查看模式；false：编辑模式（默认值:false）附件表，附件分类明细表上传（upload） 判断必须输入项 前台判断文件大小，如果操作1M（配置文件配置），报错。 检查文件类型判断上传的附件的后缀名与该附件类型都应的类型是否一致，如果不一致，报错。 利用Struts2的文件上传机制，上传文件，保存数据库。1.保存文件到服务器目录 文件路径：文件基本路径+关键主键 文件名：”F”+系统时间.后缀（如：F20100825021311870.bmp）2.如果是图片文件（如：gif,jpg,png,bmp），利用jdk中的rt.jar包中的Image包生成缩略图。缩略图的路径同上。

3、文件名：”B”+系统时间+”PNG”。（如：B20100825021311870.PNG）3.保存数据库。附件表返回 关闭窗口删除（delete） 删除选择的文件。 如果有缩略图，需要删除缩略图。 删除DB中相应的数据。文件名链接 调用GT0102下载附件功能6.2. GT0102附件下载I功能描述功能功能描述 下载页面：根据附件表的主键下载附件。利用Struts2的下载机制。地址：GT0102_download.doform.rowId6.3. GT0103图片浏览初期化 根据传入的参数取得附件值并显示第一张图片。1.附件类型（主）编号2.关联主键（最多5个）排序规则：附件名称显示内容：图片

4、，附件名，文件描述左侧图片链接 显示选择的图片及该图片对应的附件名，文件描述使用说明6.4. GT0201 动态表单利用JS实现表格的TR域的新增和内容的复制。增加行 函数：function addLine（tableId）内容：1. 根据传入的表格编号，取得表格对象。2. 新增一个表格行并拷贝第一行的所有单元格到该行。删除行function deleteLine（tableId, checkboxName）1. 根据checkbox名取得checkboxlist的值。2. 遍历该list，删除选中的行。保存 利用Struts2的表单上传。动态表单JS：根目录resourcejsautoTr.

5、js项目中引用时放在body中.script language=javascript src=%=basePath%resource/jsautoTr.js/script/body/添加行操作function addLine（a,b,c,d,e） 具体实现省略，JS中有完备注解为了方法更全面，灵活性更高，参数需要设定5个a:需要被插入table对象的ID；b:需要插入的数据（数据按照”,”作为分隔符。）；c:子checkbox的name；d:主checkbox的ID号；e:每行SELECT标签的个数/删除行操作function deleteLine（a,b,c）a: table对象的ID； 子

6、checkbox的name；c：主checkbox的ID号/全选行function checkAllbox（a,b,c）/置换select方法function select_id（a,b）具体实现省略，JS中有完备注解定义第一数字参数项目的select数目； table对象的IDselect id改写标准 select_同行同数_同行唯一数建议使用时参阅示例程序，示例程序在目录 SUNINGLF2SVNSUNINGLF2_DOC02 DesignDoc02 BasicDesign共通和系统框架 下6.5. GT0203 提交域检查通过配置输入表单的属性，检查表单内容是否符合规范。支持表单： t

7、ext，textarea,redio,checkbox,select检查输入域规范 增加表单的属性canNull1：可空；0：不可空。typeValue 1：数字；2：浮点型；3：英文； 4：英文和数字； messageName 表单名称（报错时使用） 遍历整个document，根据各个表单域的属性配置，检查必输项，类型。如果不符合规范，更改表单的class为错误样式并报第一个表单域的错误信息。Message内容如下：必输项：表单域（表单名称）是必须填写项，请确认是否填写。类型：表单域（表单名称）只能输入英文，请确认是否填写正确。以上蓝色内容，请换成属性配置内容。注意：后一次检查正确时，需要把

8、前一次错误的class恢复。 （1）.对于Text,TextArea表单，canNull，messageName，typeValue均有效。 （2）.对于redio,checkbox,select表单，只有canNull，messageName有效。 并且，这3个表单的上级表单，必须为，且同组的redio,checkbox必须处于同一DIV下。 另外，属性配置需要配置在DIV中。 例如： 6.6. 导航栏导航栏是通过JS实现导航栏的初始化，增加链接等操作。初始化函数：function initNavigation（navigList）功能说明：1. 遍历参数navigList，取得画面编号，画

9、面名，URL并存入导航栏数组中2. 生成导航栏。增加function addNavigation（navig）1. 遍历导航栏数组，查找传入的画面是否存在。如果存在，则删除该数组后面的所有值。如果不存在，则增加传入参数到导航栏数组最后。生成导航栏function makeNavigation（）1. 遍历导航栏数组，拼出导航栏的HTML代码。2. 将拼出的导航栏HTML代码射到导航栏的Table域中。在jsp页面添加以下代码：1. 导入jssrc=%=request.getContextPath（）%/resource/js/guide.js2. 初始化navigation,方法名可自定义，方

10、法体必须调用updateNavigation（）,传入4个参数，前两个为固定值，navigat，navigatStr，第三个为该页面中文名，第四个访问改页面的url,例如以下：/初始化Navigation function initKF0511Navigation（） updateNavigation（navigat, navigatStr备选址信息编辑,KF0511_init.do）; 3. 添加页面隐含域s:hidden name=form.navigatStr id=navigatStr /4.添加以下tabletable width=99% border=0 cellpadding=

11、cellspacing= style=margin-top:5px align=centertrtd id=navigat class=navigationBardiv id=/td/tr/table6.7. 字典表数据加载该功能要求系统启动时，字典表里的数据就自动加载， 随着用户系统的启动，加载字典表里的数据信息在web.xml中的servlet配置项中，增加关于加载字典表数据的信息，调用字典表数据加载类，以便系统一启动时关于字典表数据的信息可以立即加载。 如果处理失败，系统后台出现错误信息数据字典表6.8. Log机制本项目log处理采用的是log4j。共分为5个等级，分别如下：Error

12、：发生错误。如：页面加载失败，文件上传下载失败，程序发生异常等。Info：系统运行,页面加载，页面动作。系统启动，系统结束等。Debug：调试信息。本次log，按照log等级来分文件输出。单个文件最大大小为10M，备份次数为100次。Log输出格式为：等级 时间 输出类（行数）-log内容。info 20100722112201000 com.snlf2.biz.develop.action.KF0501Action（30）-页面初始化开始。6.9. 异常处理机制本项目采用Struts2的异常处理机制。利用拦截器对所有页面及操作进行拦截，在发生异常时，输出log并迁移到错误画面。捕捉的异常主要

13、分为下面几类：异常种类异常说明java.sql.SQLExceptionSQL异常com.webpump.sdk.exception.FwSessionExceptionSession异常com.webpump.sdk.exception.FwSystemExceptionURL异常org.Smon.exception.DataNotExistException数据不存在异常java.lang.Exception其他异常错误页面 根据异常，取得相应的错误Message并输出Message配置文件重新登陆 跳转到登陆页面6.10. 权限机制本项目权限管理涉及系统菜单控制和业务数据控制两个部分。本

14、共通针对系统菜单控制权限进行说明，业务数据权限控制在各个页面的业务中进行描述。页面加载 根据用户角色编号检索角色菜单表和菜单表，取得该角色所拥有的所有菜单。 按照菜单表定义的菜单顺序加载菜单。角色菜单表，菜单表 6.11. POPUP共通POPUP共通分父页面与子页面两个部分。本共通针对如何使用POPUP共通进行说明。备注父页面调用 引用共通js：common.js 书写回调函数：function XXX（paramResult）；参数paramResult为子页面的返回值。 实装POPUP：var url = jsp/hr/hrsearch.jsp;/设定URLsetCallBackFunN

15、ame（ XXX /设定回调函数名var popupWindow = popup（url）;/POPUP子页面popupWindow.focus（）;/子页面focusPopup的参数：URL，弹出窗口名，弹出窗口宽度，弹出窗口高度除URL外，其它参数默认值在common.js内定义子页面调用 在初始化js中追加：getParentCallBackName（）;/获得回调函数名 实装事件js：var param = new PopupResult（）;/初始化返回值param.staffInfo.add（/Arry类型的追加param.staffNo=/普通类型的设定param.callBack（）;/回调PopupResult中的项目需要在common.js内定义。注：详细可参见jsp_snlf2/develop/KF0101.jsp与jsp/hr/hrsearch.jsp7. 接口一览8. 接口详细 各页面与FW工作流的接口，由FW的工作流驱动业务流。