社保核心平台三版培训资料_页面开发指南.doc

社会保险管理信息系统核心平台三版社会保险管理信息系统核心平台三版 培训资料培训资料 页面开发指南页面开发指南 编制部门 社会保险管理信息系统核心平台三版项目组 编制人 技术支持组编制日期 2008 11 17 审核人 魏文麟审核日期 2008 12 15 批准人 批准日期 北京利博赛社保信息技术有限公司发布北京利博赛社保信息技术有限公司发布 文档编号 B10 TR C07 JB HXPT 01 版本号V1 0 发放号F01 受控状态受控 社会保险管理信息系统核心平台三版培训资料 第1 页 文档修改历史 版本版本修改记录修改记录修改日期修改日期修改人修改人 目目 录录 1 1概述概述 1 2 2JSPJSP 开发及典型页面开发及典型页面 1 3 3常用标签说明常用标签说明 7 3 1HTML 小标签 7 3 1 1基本标签 8 3 1 2显示标签 13 3 1 3录入标签 16 3 1 4选择标签 25 3 1 5查询标签 31 3 1 6 按钮标签 33 3 1 7 布局标签 34 3 1 8 图像标签 36 3 1 9 地区树标签 37 3 2其他 HTML 小标签 38 3 2 1 verifycodeinp 标签 38 3 2 2 verifycode 标签 38 3 2 3 继承 struts html 的小标签 39 3 3支持EL表达式的标签 39 3 4 大型标签 39 3 4 1 Grid 标签 39 3 4 2 说明 39 3 4 3 图示效果 40 3 4 4 标签特点 优点 40 3 4 5 样例 42 3 4 6 重点问题说明 47 3 4 7 注意事项 60 社会保险管理信息系统核心平台三版培训资料 第3 页 4JSP 标记标记 60 4 1JSP 标记简介 60 4 2JSP 标记的使用 60 4 2 1 tag 文件 61 4 2 2 JSP 引用 62 5附录 附录 62 5 1GRID常用 JS 说明 62 5 2MASK属性值列表 65 5 3TEXT CODESELECT标签中 DISABLE DISABLED READONLY说明 66 社会保险管理信息系统核心平台三版培训资料 第 1 页 1 1 概述概述 核心平台三板采用了 BSS 结构的模式进行开发 JSP 页面是系统最主要的 展示界面 直接影响用户对应用系统的接受度 因此需要规范来统一界面风格 提高代码的可维护性 1 11 11 1目标目标目标目标 本文档描述了核心平台三版的 JSP 书写规范及常用标签的用法 用于指导 JSP 页面的开发 1 21 21 2阅读对象阅读对象阅读对象阅读对象 本文适用于以下读者 在核心平台开发中承担开发工作的页面开发人员 在核心平台开发中承担任开发工作的系统开发人员 2 2 JSPJSP 开发及典型页面开发及典型页面 一般的 JSP 页面需要包括以下几部分 Attribute 区 主要通过 request getAttribute 从 Action 中得到相关参数 用于页面的控制 还有一些初始变量的定义 Head 区 在 html 标签之内 主要包含程序中即将应用的 css 和 js 文件 与页面显示标题 可选用 base 标签或 head 标签 Body 区 主要是 Html 代码 实现界面的显示 可选用 body 标签 Body 区的开发需要大量使用框架提供的 XartWebui 标签 Javascript 区 JS 逻辑代码 JSP 的模板代码如下 template jsp 社会保险管理信息系统核心平台三版培训资料 第 2 页 社会保险管理信息系统核心平台三版培训资料 第 4 页 编辑 删除 社会保险管理信息系统核心平台三版培训资料 第 6 页 修改 取消 插 入 取消 社会保险管理信息系统核心平台三版培训资料 第 7 页 b b 图示 图示 社会保险管理信息系统核心平台三版培训资料 第 19 页 如果在 text 测试日期 后的输入框里输入 2006 回车或焦点离开会 提示出错 如下所示 相关标签 相关标签 text eltext el 支持 支持 elel 表达式的表达式的 texttext 标签 如下所示 标签 如下所示 使用此标签请先熟悉 jstl 规范 说明说明 标签中加入新属性 弥补 codeselect 标签中无 readonly 属性 使用 useCode 属性后 可以显示代码表中对应的代码名称 并且在 actionForm 中传 递对应的代码值 涉及到的属性 涉及到的属性 属性取值类型是否必 填 描述 useCodeuseCodeString 否是否取得对应代码名称 默认为 null 当 为 true 时 显示代码表对应代码名称 codeNamecodeNameString 否自定义代码表中对应的代码名称字段名 默认从 property 中取得代码名称字段 textIdtextIdString 否使用 text 标签获取代码名称时 input 输入框的 id 如果为 null 或 默认为 32 位随机码 社会保险管理信息系统核心平台三版培训资料 第 20 页 3 1 3 3 textaera 标签与标签与 textareaeditor 标签标签 功能说明功能说明 textaera 标签产生 HTML 语句 XXXXX 指定多行文本 输入控件 textareaeditor 标签是带 label 的 textarea 标签 与 textarea 标签有如下属性 差异 属性取值类型是否必 填 描述 label 否文本标签显示标签标识 colspan 否标签所占一行中的列数 默认为 1 required 否最多能录入的字节数 disabled 否是否可用 属性说明属性说明 属性取值类型是否必 填 描述 propertypropertyEntityFiel d 否是该标签中输入框的 name 如果有 ActionForm property 属性也指定了与 Form 属性的绑定关系 idid 字符串否当同一页面 property 有重复的时候启用这 个 id 用于区别 rowsrows 正整数指显示的行数 若内容超过行数 则会显示 滚动条 说明说明 其他常见属性说明请参见 sicp3 类标签常用属性通用说明 参考案例参考案例 a a 代码 代码 社会保险管理信息系统核心平台三版培训资料 第 21 页 textarea例子 b b 图示 图示 3 1 3 4 Textbuttoneditor 标签标签 功能说明功能说明 带有按钮和label的输入框标签 图示效果图示效果 社会保险管理信息系统核心平台三版培训资料 第 22 页 属性说明属性说明 属性名称使用说明必需项备注 property 属性名是 onRbuttonclick 点击右边按钮触发的事件是 label label 名称否 disable 是否可用否 readly 是否只读否 value 初始值否 buttonwidthpercent 按钮宽度占用的百分比否 buttonTitle 按钮上文字显示标记否 说明说明 其他常见属性说明请参见 sicp3 类标签常用属性通用说明 3 1 3 5 Password 标签标签 功能说明功能说明 产生 HTML 语句 创建 与 INPUT type text 控件类似的单行文本输入控件 不过其中并不显示用户 输入的内容 参考案例参考案例 a a 代码 代码 b b 图示 3 1 3 6 Cardid 标签标签 功能说明功能说明 标签可自动得到身份证对应的出生日期和性别 用此 标签 需要在同一form中 有标识出生日期和性别的字段 社会保险管理信息系统核心平台三版培训资料 第 23 页 属性说明属性说明 属性名称使用说明必需项备注 property 属性名是 required 是否为必录项否 birthname 此处填写出生日期 id 值是 sexname 此处填写性别 id 值是 colspan 标签所占一行中的列数 默 认为 1 否 label 标签 Label 显示内容否 disabled 是否可见否 disable 是否可用否 maxlength 最大长度否 value 初始值否 id 标签唯一标识符否 说明说明 其他常见属性说明请参见 sicp3 类标签常用属性通用说明 参考案例参考案例 a a 代码代码 社会保险管理信息系统核心平台三版培训资料 第 24 页 在 身份证号 输入框输入号码后 焦点离开 会自动在出生日期和性别 输入框填入数据 b b 图示图示 3 1 3 7 file 标签标签 功能说明功能说明 创建文件上载控件 该控件带有一个文本框和一个浏览按钮 注 property 属性是必录项 size 属性用来控制输入框的长度 使用说明使用说明 要使得文件上载能够成功 要做到以下几点 该标签必须出现在 FORM 元素内 必须为该标签指定 property 标签属性的值 FORM 元素 METHOD 标签属性的值必须设置为 post FORM 元素 entype 属性的值必须设置为 multipart form data 不要 忘记哦 要处理上载到服务器的文件 服务器端进程必须可以处理 multipart form data 的提交 用户可以在文本框中输入文件路径或者单击浏览按钮在文件系统中浏览 参考案例参考案例 a a 代码 代码 社会保险管理信息系统核心平台三版培训资料 第 25 页 b b 图示 图示 属性说明属性说明 1 属性 功能说明 中为常用属性 更多属性请参考 sicp3 tld 文件 或 在写 jsp 时 用编辑器的帮助 查看调用 2 属性说明 请参考通用事件属性说明 和 通用其他属性说明 3 1 4 选择标签选择标签 4 1 4 1 codeselect 标签与标签与 codeselecteditor 标签标签 功能说明功能说明 Codeselect 和 codeselecteditor 标签主要是处理系统启动加载的代码表 框架在系统初始化时 加载代码表的内容 业务开发人员在开发页面时 可以 利用框架提供的标签库来实现 select 功能 Codeselect 也支持自定义数据源 如下所示 如果业务需要建立新的永久代码表 可以在 action 中将 TreeMap 类 型 list 放入 ServletContext 中 其 key 值是 type 值 如 aab001 这样 aab001 就成为代码了 codeselecteditor 是带 label 的 codeselect 标签 使用方法使用方法 1 无须指定数据源 数据源在 aa10 表中 2 自定义数据源 参考案例参考案例 a a 代码 代码 codeselecteditorcodeselecteditor 例子例子 codeselectcodeselect 例子例子 自定义数据源采用上述 codeselecteditor 例子的自定义 数据源 codeselect 可选 codeselect 不可选 codeselect 占多列 colspan加在所在列中 不加在标签本身 社会保险管理信息系统核心平台三版培训资料 第 28 页 codeselect 自定义数据 b b 图示 图示 codeselecteditorcodeselecteditor 图示图示 codeselectcodeselect 图示图示 属性说明属性说明 属性名称使用说明必需 项 备注 property 字段名称是 required 是否为必录项否须与 label 同时使用 label 中文信息否当 required true label 性别 且该输入框的值 为空时 提示 性别不能 为空 selecteditor 的 label 内 容会作为 label 显示在页 面上 disable 默认 false True 时需 要输入 value 值 回显 否 社会保险管理信息系统核心平台三版培训资料 第 29 页 数据 value 默认选中的代码值否用于回显 redisplay 为 true 时 回显代码否用于状态缓存 dataMeta Select 的数据源否使用自定义的数据源 emptyText 空值的显示文本 默认 为 请选择 isValue 说明说明 其他常见属性说明请参见 sicp3 类标签常用属性通用说明 相关标签 相关标签 select elselect el 支持 支持 elel 表达式的表达式的 selectselect 标签 属性同标签 属性同 selectselect 用法 用法 如下所示 如下所示 使用此标签请先熟悉 jstl 规范 同样 selecteditor el 支持 el 表达式的 selecteditor 标签 属性同 selecteditor 4 1 4 2 codelist 标签与标签与 codelisteditor 标签标签 功能说明功能说明 复杂的代码显示标签 可显示多列 使代码值与代码名称对应显示 codelisteditor 标签与 codelist 标签差别在于 codelisteditor 标签可以显 示 Lable 作为标签说明 常用属性说明常用属性说明 属性名称使用说明必需 项 备注 property 属性名是 id 标签唯一标识符是 mode 代码表模式否Mode multi 为双列 其他为单列 默认为单列 selectedValue 选中值否代码值 社会保险管理信息系统核心平台三版培训资料 第 30 页 dropDownStyle 是否可录入否0 只能选择 1 可键盘录入 合法值 2 可键盘录入非法 值 autoFilter 是否自动过滤否 width 标签宽度否 使用方法使用方法 a a 代码 代码 b b 图示 图示 Mode multi Mode multi 社会保险管理信息系统核心平台三版培训资料 第 31 页 ModeMode 默认样式 默认样式 说明说明 使用次标签时 需要在页面上引入 combobox css 样式 3 1 5 查询标签查询标签 3 1 5 1 query 标签标签 功能说明功能说明 查询容器标签 可支持嵌套 text texteditor 等标签 该标签内置 查询 Q 和 重置 R 按钮 内置格式包含 和 editlayout 标签 社会保险管理信息系统核心平台三版培训资料 第 32 页 补充补充 重置重置按钮 如果查询条件有缺省值不用清除 则实现如下的 js 方法即可 function resetForm obj 方法签名不能改变 var aryDef new Array aryDef 0 aaa100 使用缺省值的输入框的名字 aryDef 1 aaa101 使用缺省值的输入框的名字 clearForm obj aryDef 调用 clearForm 方法 此方法一定要在引入 base 标签的后面 使用方法使用方法 c c 代码 代码 text 输入框不设长度 text 输入框自定义长度 d d 图示 图示 社会保险管理信息系统核心平台三版培训资料 第 33 页 QueryQuery 样式 样式 属性说明属性说明 属性名称使用说明必需 项 备注 topic 主题信息否 action 查询的 action是 notitle 是否有标题否 editorMeta 查询条件数据集否 hiddenMeta 用于提取隐藏域列 表的 key 值 否输入为 input type hidden 的格式 doAjax 是否是 ajax 请求否为 true 是 ajax 请求 可 与 grid 形成联动 默认是 false ajaxAction ajax true 时提交 的查询请求 否 bottonvalign 查询条件的垂直对 齐方式 否可选择 top bottom formId 查询 form 标识符否默认为 queryForm columSum 每行多少个输入框否默认为 2 个 说明说明 其他常见属性说明请参见 sicp3 类标签常用属性通用说明 3 1 6 按钮标签按钮标签 3 1 6 1 button 标签与标签与 buttons 标签标签 使用方法使用方法 社会保险管理信息系统核心平台三版培训资料 第 34 页 创建一个普通按钮 1 单独的 button 标签 a a 代码 代码 b b 图示 图示 2 buttons 标签嵌套 button 标签 a a 代码 代码 b b 图示 图示 3 1 7 布局标签布局标签 3 1 7 1 editlayout 标签 标签 使用方法使用方法 社会保险管理信息系统核心平台三版培训资料 第 35 页 功能说明功能说明 格式化控件布局的标签 放在之后 会将所在 table 默认分成宽度 相等的 6 列 如下图所示代码 c 代码代码 d d 图示图示 属性说明属性说明 属性名称使用说明必需项备注 cols 分为几列否 3 1 7 2 groupbox 标签标签 功能说明功能说明 把页面信息进行分类 属性说明属性说明 属性名称使用说明必需项备注 title 该信息块的 title是 参考案例参考案例 代码代码 社会保险管理信息系统核心平台三版培训资料 第 36 页 图示 3 1 8 图像标签图像标签 3 1 8 1 image 标签 标签 功能说明功能说明 标签产生 HTML 代码 ImgTag 产生 HTML 语句 用于动态的改变页面 风格 实质为改变页面所用的相关图片 在 jsp 页面中用到的地方 相当于使用 html 语句 属性说明属性说明 属性取值类型是描述 社会保险管理信息系统核心平台三版培训资料 第 37 页 否 必 填 srcsrc 图片路径否设置或获取要由对象装入的 URL altalt 替代文本否设置或获取用于替代图像的文本 ismapismapboolean 否设置或获取图像是否为服务器端图 像映射 usemapusemap 图像映射的 URL 否设置或获取用于客户端图像映射的 URL 通常带有一个书签扩展 name 更多属性请参考 sicp3 tld 文件 或在写 jsp 时 用编辑器的帮助 查看调用 参考案例参考案例 a a 代码 代码 b b 图示 图示 社会保险管理信息系统核心平台三版培训资料 第 41 页 3 1 9 地区树标签地区树标签 3 1 9 1 treeinput 标签标签 功能说明功能说明 为地区树标签 可根据自定义 actionUrl 属性请求获得 所需地区树 还可自定义显示文字等 属性说明属性说明 属性取值类型是否 必填 描述 maskmask 根据不同的 值判断显示 什么树 否 mask region 为地区树 mask group 为机构树 isPopedomisPopedom 是否过滤数 据权限 否true 为不过滤 全部显示 默认 为过滤 actionUrlactionUrl 请求树的 action 否 showTextshowText 树的下拉列 表头及树的 根节点显示 文字 否 1 更多属性请参考 sicp3 tld 文件 或在写 jsp 时 用编辑器的帮助 查 看调用 2 更多属性说明 请参考通用事件属性说明 和 通用其他属性说明 参考案例参考案例 c c 代码 代码 所属行政区划 d d 图示 图示 3 23 23 23 2 其他其他其他其他HTMLHTMLHTMLHTML小标签小标签小标签小标签 3 2 1 verifycodeinp 标签 标签 功能说明功能说明 校验码录入框标签 属性说明属性说明 说明说明 其他常见属性说明请参见sicp3类标签常用属性通用说明 3 2 2 verifycodeverifycode 标签 标签 功能说明功能说明 校验图片标签 属性说明属性说明 属性名称使用说明必需项备注 id 标签唯一标识符否 社会保险管理信息系统核心平台三版培训资料 第 43 页 说明说明 Unix 系统中 没有图形环境的 server 图形校验码会显示不出来 需要在 启动脚本 statrWeblgoic sh 里面加 Djava awt headless true Djava awt headlesslib true 3 2 3 继承继承 struts html 的小标签 的小标签 Sicp3 标签库中包括 struts html 中的 xhtml cancel multibox select option options optionsCollection frame javascript link messages reset rewrite submit 标签 标签用法与 struts html 中相同 3 33 33 33 3 支持支持支持支持elelelel表达式的标签表达式的标签表达式的标签表达式的标签 在使用此标签时要熟悉 jstl 规范 支持 el 表达式的标签 有 text el texteditor el select el selecteditor el 其使用方法和属性同对应 的普通标签一样的 参见 text texteditor select selecteditor 标签 3 43 43 43 4 大型标签大型标签大型标签大型标签 大型标签库是为了更好地实现页面显示效果而开发的一套重级的 功能强 大的标签库 这些标签实现都比较复杂 功能繁多 当需要在同一页面上使用 多个大型标签时 需要小心不要引起性能问题 3 4 1 Grid 标签标签 3 4 23 4 2 说明 说明 该标签相当于以前的 table 标签 但是比 table 标签更灵活 样式更多变 而且提供了很多最佳实践式的例子以供参考 在开发的过程中可以直接在这些 例子上进行修改后已达到自己业务编码的需要 这些例子可以在 poc 所提供的 专业的网站上进行查看并且可以得到最佳实践的源代码 社会保险管理信息系统核心平台三版培训资料 第 44 页 3 4 33 4 3 图示效果 图示效果 3 4 43 4 4 标签特点 优点 标签特点 优点 3 4 4 1 多种数据请求方式多种数据请求方式 ClientClient 一次请求获得所有的数据 然后在页面上通过 js 控制数据的组织 显示 CallbackCallback 通过 callback 请求参数向后台发出请求以获取数据 然后在页 面上显示 比如翻页等操作 ServerServer 通过刷新整个页面达到向后台发送请求获取数据的目的 得到数 据后在页面上重新组织 显示 3 4 4 2 页面元素的控制页面元素的控制 Grid 标签基本上可以控制页面上所有元素的显示方式 格式 位置 css 控制 模版控制等 在这里边有其要说明的是模版定制 可以显示出非常优美 丰富 意想不 社会保险管理信息系统核心平台三版培训资料 第 45 页 到的页面 例如 数据显示 在上图中第一列 thread 实际上查出来的数据只有黑体的部分 可是通过模 版可以使第一列显示的数据变丰富 大家可以看到第一页中现在不仅显示了应 该显示的黑体 而且还显示了图片 这些图片根据数据的不一样而有所变化 和 by 信息 分页控件显示 社会保险管理信息系统核心平台三版培训资料 第 46 页 滚动条 3 4 53 4 5 样例样例 3 4 5 1 样例一样例一 样例图示 样例图示 样例说明 样例说明 Grid 标签属性很多 虽然灵活但使用起来效率不是很高 有鉴于此 标签中引入了 tagTemplateId 这个属性 该属性值所代表的是一系列属性的集合 这一系列属性是在一个 xml 文档中定义的 代码样例 代码样例 声明标签 声明标签 社会保险管理信息系统核心平台三版培训资料 第 47 页 GridGrid 标签 标签 查询结果 社会保险管理信息系统核心平台三版培训资料 第 48 页 Edit Delete Update Cancel Insert Cancel Loading 社会保险管理信息系统核心平台三版培训资料 第 49 页 代码说明 代码说明 上例中标签 grid 跟 gridlevel 中都引用了 tagTemplateId 属性 该属性大大简 化了代码量 如果该 tagTemplateId 定义的属性跟页面中的属性重复的话以页 面的属性为准 但是请注意要使用 tagTemplateId 请务必预先定义 tagPropertyInitConfig 文件 并在 web xml 中声明该引用 部分模板定义的部分模板定义的部分模板定义的部分模板定义的 gridgridgridgrid 标签属性及标签说明 标签属性及标签说明 标签属性及标签说明 标签属性及标签说明 runningMode 指明请求的方式 tagTemplateId grid 中默认定义为runningMode Callback requestURI 标签请求的URI地址 如翻页或局部刷新时 当数据源为xls时 请求为 mygridservlet ds editing dataCallbackMode 当请求为数据库数据源时 请求为 Action do method 请求此grid的真实方法 如query标签的action请 求 pagerStyle 明翻页控件的显示方式 Slider Numbered tagTemplateId grid 中默认定义为pagerStyle slider loadingPanelClientTemplateId 该id指明了显示的模版内容 dataMember 声明该gird显示的数据内容 如果是框架的数据则不需写这项或者为querydata tagTemplateId grid 中默认定义为dataMember querydata sicp3 gridcolumn 声明要显示的列的信息 dataField 字段标识 headingText 明字段显示在页面上的别名 dataCellClientTemplateId 页面上显示该列时所引用的模版 Visible 性用于表示该列是否显示 社会保险管理信息系统核心平台三版培训资料 第 50 页 dispalyWhenEditing为true并且visible false 时表示该列虽然在查询结果 的列表中不显示 但是会在修改时显示 sicp3 clienttemplate 定义以上代码所引用的模版 3 4 5 2 样例样例二二 样例说明 样例说明 该样例的数据源是 excel 样例 Excel 数据 queryhs data xlsqueryhs data xls aac002aac003 100000000001wang 100000000001zhao 100000000001li 100000000001sun 100000000001kong 样例代码 样例代码 社会保险管理信息系统核心平台三版培训资料 第 51 页 3 4 63 4 6 重点问题说明重点问题说明 以下实例代码只说明重点 即基本的代码框架跟本文当 5 1 4 样例的代码 近似 只交代不同之处 3 4 6 1 查询查询 实例详见本文档 5 1 4 中样例代码 关于通用分页查询关于通用分页查询 这里所指的通用查询是指通过继承类 CommonQueryAction 并且通过 init HttpServletRequest req ActionForward forward String hql boolean isGetAll 实现的分页功能 对于这种情况 在标签 grid 中要着重注意属性 requestURI 该属性用来 设置哪个类方法来处理 grid 的分页请求 对于这种情况 请务必按照以下格式 书写 xxx Action do method queryMethod queryMethod 为获得 grid 数据的 真实请求方法 红色部分是必须的 关于数据集分页查询关于数据集分页查询 这里所指的数据集分页查询是指通过继承类 ListPageQueryAction 实现的 分页功能 对于这种情况 在标签 grid 中需要注意的问题有以下几个方面 如果可以转换成 1 5 1 1 所描述的通用的分页查询 请转换 如果数据不多 可以设置 grid 属性 runningMode 为 client 社会保险管理信息系统核心平台三版培训资料 第 52 页 继承 ListPageQueryAction 之后 需要重写方法 protected final List fetchPageData HttpServletRequest req ActionForm actionForm ReturnInfoDTO returnInfoDTO throws Exception 这个方法返回的数据是分页时所能显示的数据 也就是你在点击页面上的 下一页的时候你想要显示的那些数据 对象 ReturnInfoDTO 包含了 grid 标签的 一些基本数据对象 PageQueryInfo 该对象包含有分页信息 比如当前页面共 有多少条 当前是哪一页 总共多少页等等 你可以设置这些数据实现数据分 页显示 PageQueryInfoPageQueryInfo q q returnInfoDTO getPageQueryInfo returnInfoDTO getPageQueryInfo 页数页数 q getPageCount q getPageCount 每页数据每页数据 q getPageSize q getPageSize 当前页当前页 q getCurPageNo q getCurPageNo 具体使用方法 请参考 sys 工程中 工程演示 sicp3ui 示例 grid 样例 list for callback 样例一 二 3 4 6 2 增加增加 页面写法 页面写法 引用 js 方法 在添加 clientSideOnInsert onInsert 属性 该属性 可有可无它是指在提交您添加的数据之前触发的方法 可以用来加一 些数据校验等等 在标签中添加类似 sicp3 gridcolumnalign Center 该代码用于在 grid 表格中添加一列用于显示添加标记 其中 EditTemplate 标记是列所显示的内容模版 id 如 sicp3 clienttemplateid EditTemplate aEdit Edit aDeletenager logonHistoryAction do method delete Delete 在标签中添加属性 insertCommandClientTemplateId InsertCommandTemplate 该模版用于 添加时显示的列信息 sicp3 clienttemplateid InsertCommandTemplate aInsertistoryAction do method delete Insert aCancelhref javascript Grid1 EditCancel Cancel insertRowinsertRow 方法是自己在页面上自定义的 js 用于定义添加数据时后台执行的 url functionfunction insertRow actionUrl insertRow actionUrl Grid1 EditComplete null actionUrl Grid1 EditComplete null actionUrl Grid1 Table AddRow 方法用于触发添加方法 其中 Grid1 是指您的 grid 标签的标识 id 社会保险管理信息系统核心平台三版培训资料 第 54 页 ActionAction 写法 写法 RoleDTORoleDTO rdrd newnew RoleDTO RoleDTO BeanHelper copyProperties this getAddBean BeanHelper copyProperties this getAddBean rd rd this getAddBean 是框架中封装的一个方法 该 bean 中的数据是前台您 添加时提交的数据 通过 BeanHelper copyProperties 方法即可以把该数据转 化到自己的 Dto 中去 供自己调用 3 4 6 3 修改修改 页面写法 页面写法 在添加 clientSideOnUpdate onUpdate 属性 该属性可 有可无它是指在提交您修改的数据之前触发的方法 可以用来加一些 数据校验等等 在标签中添加类似 sicp3 gridcolumnalign Center 该代码用于在 grid 表格中添加一列用于显示添加标记 其中 EditTemplate 标记是列所显示的内容模版 id 如 sicp3 clienttemplateid EditTemplate aEdit Edit a Deletenager logonHistoryAction do method delete Delete 社会保险管理信息系统核心平台三版培训资料 第 55 页 在标签中添加属性 editCommandClientTemplateId EditCommandTemplate 该模版用于添加 时显示的列信息 sicp3 clienttemplateEditCommandTemplate aHistoryAction do method update UpdateUpdate aCancelhref javascript Grid1 EditCancel Cancel editRoweditRow 方法是自己在页面上自定义的 js 用于定义修改数据时后台执行的 url functionfunction editRow actionUrl editRow actionUrl Grid1 EditComplete null actionUrl Grid1 EditComplete null actionUrl ActionAction 写法 写法 RoleDTORoleDTO rdrd newnew RoleDTO RoleDTO BeanHelper copyProperties this getUpdateBeanBeanHelper copyProperties this getUpdateBean rd rd this getUpdateBean 是框架中封装的一个方法 该 bean 中的数据是前 台您修改时提交的数据 通过 BeanHelper copyProperties 方法即可以把该数 据转化到自己的 Dto 中去 供自己调用 3 4 6 4 删除删除 页面写法 页面写法 在添加 clientSideOnDelete onDelete 属性 该属性可 有可无它是指在提交您删除的数据之前触发的方法 可以用来加一些 社会保险管理信息系统核心平台三版培训资料 第 56 页 数据校验等等 在标签中添加类似 sicp3 gridcolumnalign Center 该代码用于在 grid 表格中添加一列用于显示添加标记 其中 EditTemplate 标记是列所显示的内容模版 id 如 sicp3 clienttemplateid EditTemplate aEdit Edit aDeleteogonHistoryAction do method delete Delete deleteRowdeleteRow 方法是自己在页面上自定义的 js 用于定义删除数据时后台执行的 url functionfunction deleteRow rowId actionURI deleteRow rowId actionURI Grid1 Delete Grid1 GetRowFromClientId rowId null actionURI Grid1 Delete Grid1 GetRowFromClientId rowId null actionURI ActionAction 写法 写法 RoleDTORoleDTO rdrd newnew RoleDTO RoleDTO BeanHelper copyProperties this getDeleteBeanBeanHelper copyProperties this getDeleteBean rd rd 社会保险管理信息系统核心平台三版培训资料 第 57 页 returnreturn this createGridXml mapping this createGridXml mapping actionForm actionForm req req res res this getDeleteBean 是框架中封装的一个方法 该 bean 中的数据是前 台您删除时提交的数据 通过 BeanHelper copyProperties 方法即可以把该数 据转化到自己的 Dto 中去 供自己调用 3 4 6 5 批量提交批量提交 配置配置 gridgrid 标签参数标签参数 allowBatchUpdate 1 allowBatchUpdate 1 默认为 默认为 0 0 配置配置 gridlevelgridlevel 标签参数标签参数 selectorCellsTypeselectorCellsType 参数默认配置为空 此时批量提交的是整页所有的数据 当参数配置为 checkbox 时 会在 grid 左边显示一列 checkbox 框供选择 注意 该 参数应该与 showSelectorCells 配合使用 当 showSelectorCells 值为 true 时才会出现多选框 页面设置隐藏域页面设置隐藏域 在页面标签中设置隐藏区域 用于获得页面需要批量提交 的数据 leaf formmethod post leaf hidden 在提交方法中 先取得页面批量提交的数据 然后赋值给隐藏域 VarVar para Grid1 Table GetRowBatchUpdate para Grid1 Table GetRowBatchUpdate Obj tempdata value para Obj tempdata value para Grid1 为 grid 的 ID obj 为隐藏域所在的 form 对象 提交时 使用 标签进行提交 Obj action Obj action leaf rewrite 社会保险管理信息系统核心平台三版培训资料 第 58 页 后台取数据后台取数据 在 Action 中 先获得隐藏域的值 根据隐藏域的值获得批量的数据集合 StringString tempdata req getParameter tempdata tempdata req getParameter tempdata CollectionCollection inCollinColl BeanHelper getCollection newBeanHelper getCollection new SubmitDataMap req SubmitDataMap req dtos getClass dtos getClass 保存时 使用 updateObjs Object objs 方法 把 inColl 转换为对象 Platform getPersistence updateObjs inColl toArray Platform getPersistence updateObjs inColl toArray 3 4 6 6 Grid 与与 query 标签实现联动标签实现联动 query 的查询按钮负责向后抬请求 grid 的数据 这里使用了技 术 ajax 也就是说 query 标签不会刷新整个页面 在 query 标签请 求后台完毕之后 可以动态的刷新对应的 grid 具体实现如下 配置配置 queryquery 标签标签 属性 doAjax 为 true 时表示该 query 标签是动态局部刷新的 属性 ajaxAction 的值是一个 js 方法 它用来设置 query 的 查询按钮被按下时所触发的方法 这个方法可以自定义 但 是要实现局部刷新对应的 grid 则该方法必须得调用 Grid1 AjaxCallback param1 方法 该方法的参数是要提交 的查询条件 例如 getFormValue document all Form Grid1 AjaxCallback param Grid1 AjaxCallback param sicp3 queryajaxAction ajaxJS gridgrid 标签中标签中 requestURIrequestURI 属性属性 使用 AjaxCallback 方法请求后台数据时请设置 grid 的属性 requestURI 确保该属性为您真实请求的后台方法 这点有别于使用 1 5 1 介绍的通用查询的配置 ActionAction 中中 initinit 方法 方法 Grid 标签与 query 联动时 action 请求中 使用 init HttpServletRequest req HttpServletResponse res ActionForward forward HQLInfo hqlInfo 方法 即参数列表中务必加 上 HttpServletResponse 参数 3 4 6 7 单页面显示多单页面显示多 grid 确定每个 gridlevel 标签中的属性 pageQueryData 值彼此不 同 grid 的属性 requestURI action 中 init 方法与 grid query 联动时设置相同 社会保险管理信息系统核心平台三版培训资料 第 60 页 同时请求显示多同时请求显示多 gridgrid 在 action 中 StringBufferStringBuffer hql1hql1 newnew StringBuffer StringBuffer request setAttribute dataMember request setAttribute dataMember querydata querydata request setAttribute pageQueryData request setAttribute pageQueryData bbb bbb init req init req res res af af hql1 toString hql1 toString false false StringBufferStringBuffer hql2hql2 newnew StringBuffer StringBuffer req setAttribute dataMember req setAttribute dataMember query query req setAttribute pageQueryData req setAttribute pageQueryData aaa aaa init req init req res res af af hql2 toString hql2 toS