WebApp开发规范和说明.docx

针对webapp开发过程中的常用操作，进行了规范整理，如下：一、常用工具介绍1、执行命令在finedo.js中定义了常用的命令调用接口，详见FINEDO.Action定义，目前提供了四种命令，如下：1.1、doCommand:执行常规命令，主要应该在列表操作中，对数据记录的某些属性进行简单的修改操作，如启用禁用、升序降序等。 接口定义/* * 一般性的命令操作，用于GET方式提交 * url:调用的路径 * callback:执行完成后的回调函数 * alertmsg:执行完成后是否弹出返回信息 */doCommand:function(url,callback,alertmsg)FINEDO.Mode.create();$.getJSON(url, function(data)FINEDO.Mode.destroy();if(alertmsg)$.messager.alert(提示,data.resultdesc);if($.isFunction(callback)callback(data);); 调用方式 if(1=row.state)operation += 禁用;elseoperation += 启用;1.2、doSearch:执行查询命令，主要应该在列表操作中，根据输入的查询参数执行数据记录的查询。 接口定义 /* * 执行命令 * datagrid:指定查询的数据列表对象 * url:调用的路径 * data:查询参数 */,doSearch:function(datagrid,url,param)FINEDO.Mode.create();$.post(url,param,function(data)FINEDO.Mode.destroy();$(#+datagrid).datagrid(loadData,data); ,json); 调用方式 function doSearch() var param = paramname: $(#paramname).val();FINEDO.Action.doSearch(datagrid,$ctx /finedo/sysparam/querysysparam,param); 1.3、doDelete:执行删除命令，主要应该在列表操作中，对数据记录进行单条或批量删除操作。 接口定义 /* * 删除记录的公用方法 * datagrid:指定被删除的数据列表对象 * action:指定删除数据的处理方法 * itemid:该值不为空时，则认为是单项删除 * callback:执行完成后的回调函数 */,doDelete:function(datagrid,action,itemid,callback)var ids = ;var message = 您确定删除这些记录吗?;if(itemid)ids.push(itemid);message = 您确定删除该记录吗？;elsevar rows = $(#+datagrid).datagrid(getSelections);for(var i=0; irows.length; i+)ids.push(rowsi.optsn);if(ids=)$.messager.alert(提示,请选择要删除的记录！);return;$.messager.confirm(提示, message, function(which) if (which) FINEDO.Mode.create(); $.getJSON(action+&ids=+ids.join(,), function(ret) FINEDO.Mode.destroy();$.messager.alert(提示,ret.retmsg);$(#+datagrid).datagrid(reload); ); ); 调用方式 var operation = 删除  1.4、doSort:执行排序命令，主要应该在列表操作中，根据部分字段进行数据记录的排序显示。 接口定义 /* * 排序操作 * datagrid:指定排序的数据列表对象 * url:调用的路径 * data:排序参数 */,doSort:function(datagrid,url,param)FINEDO.Mode.create();$.post(url,param,function(data)FINEDO.Mode.destroy();$(#+datagrid).datagrid(reload); ,json); 调用方式 function doSort() var param = sortField: paramname,sortType:up;FINEDO.Action.doSort(datagrid,$ctx /finedo/sysparam/sort,param); 2、WEB控件参考“帮助组件使用示例”。二、CRUD示例以系统参数配置作为例子进行讲解。1. 查询 视图层：构建数据列表及查询参数数据列表：查询工具架：   定义查询函数：function doSearch() var param = paramname: $(#paramname).val();FINEDO.Action.doSearch(datagrid,$ctx /finedo/sysparam/querysysparam,param); 控制层：调用系统参数查询服务，并组装数据 /* * 查询系统参数 * param request * return */RequestMapping(/querysysparam)ResponseBodypublic Object querySysParam(HttpServletRequest request) /*# *封装查询参数对象 *# */SysConfigureparam param = new SysConfigureparam();param.setParamname(request.getParameter(paramname);/*# *封装查询对象，查询对象一般包含查询参数对象及分页对象 *# */SysConfigureParamQueryDomain query = new SysConfigureParamQueryDomain();query.setSysconfigureparam(param);/ 设置查询参数对象query.setPageparam(PageUtil.getPageParam(request);/ 设置分页参数/*# *调用服务类，获取数据列表 *# */ReturnValueDomainPageDomain ret = ServiceCaller.callForPage(service/finedo/configure/querysysparam, query,SysConfigureparam.class);PageDomain page = ret.getObject();List list = page.getDatalist();/*# *构建组件需要的JSON对象并返回 *# */return PageUtil.build(list, page.getRowcount();2. 添加 视图层：构建添加系统参数表单参考页面定义规范 控制层：调用系统参数添加服务并返回结果信息 /* * 添加系统参数 * param request * return * throws Exception */RequestMapping(/addSysParam)ResponseBodypublic Object addSysParam(HttpServletRequest request) throws Exception/*# *封装系统参数对象 *# */SysConfigureparam param = FormUtil.request2Domain(request,SysConfigureparam.class);/*# *封装服务参数对象 *# */List list = new ArrayList();list.add(param);SysConfigureParamListDomain domain = new SysConfigureParamListDomain();domain.setConfigureparamlist(list);/*# *调用服务进行数据保存，请返回消息给前台 *# */ReturnValueDomain ret = ServiceCaller.call(service/finedo/configure/insertsysparam, domain,SysConfigureparam.class);param = ret.getObject();return ret;3. 修改 视图层：构建修改系统参数表单参考页面定义规范 控制层：调用系统参数修改服务并返回结果信息 /* * 修改系统参数 * param request * return * throws Exception */RequestMapping(/modifySysParam)ResponseBodypublic Object modifySysParam(HttpServletRequest request) throws Exception/*# *封装系统参数对象 *# */SysConfigureparam param = FormUtil.request2Domain(request,SysConfigureparam.class);/*# *封装服务参数对象 *# */List list = new ArrayList();list.add(param);SysConfigureParamListDomain domain = new SysConfigureParamListDomain();domain.setConfigureparamlist(list);/*# *调用服务进行数据保存，请返回消息给前台 *# */ReturnValueDomain ret = ServiceCaller.call(service/finedo/configure/updatesysparam, domain,SysConfigureparam.class);param = ret.getObject();return ret;4. 删除 视图层：调用删除系统参数命令var operation = 删除  控制层：调用系统参数删除服务并返回结果信息 /* * 删除系统参数 * param request * return * throws Exception */RequestMapping(/deleteSysParam)ResponseBodypublic Object deleteSysParam(HttpServletRequest request) throws Exception/*# *封装系统参数对象 *# */SysConfigureparam param = FormUtil.request2Domain(request,SysConfigureparam.class);/*# *封装服务参数对象 *# */List list = new ArrayList();list.add(param);SysConfigureParamListDomain domai