App開發(fā)基礎(chǔ)規(guī)范和說(shuō)明

1、針對(duì)app開發(fā)過(guò)程中旳常用操作，進(jìn)行了規(guī)范整頓，如下：一、常用工具簡(jiǎn)介1、執(zhí)行命令在finedo.js中定義了常用旳命令調(diào)用接口，詳見(jiàn)FINEDO.Action定義，目前提供了四種命令，如下：1.1、doCommand:執(zhí)行常規(guī)命令，重要應(yīng)當(dāng)在列表操作中，對(duì)數(shù)據(jù)記錄旳某些屬性進(jìn)行簡(jiǎn)樸旳修改操作，如啟用禁用、升序降序等。接口定義/* * 一般性旳命令操作，用于GET方式提交 * url:調(diào)用旳途徑 * callback:執(zhí)行完畢后旳回調(diào)函數(shù) * alertmsg:執(zhí)行完畢后與否彈出返回信息 */doCommand:function(url,callback,alertmsg)FINEDO.Mod

2、e.create();$.getJSON(url, function(data)FINEDO.Mode.destroy();if(alertmsg)$.messager.alert(提示,data.resultdesc);if($.isFunction(callback)callback(data););調(diào)用方式 if(1=row.state)operation += 禁用;elseoperation += 啟用;1.2、doSearch:執(zhí)行查詢命令，重要應(yīng)當(dāng)在列表操作中，根據(jù)輸入旳查詢參數(shù)執(zhí)行數(shù)據(jù)記錄旳查詢。接口定義 /* * 執(zhí)行命令 * datagrid:指定查詢旳數(shù)據(jù)列表對(duì)象 * u

3、rl:調(diào)用旳途徑 * data:查詢參數(shù) */,doSearch:function(datagrid,url,param)FINEDO.Mode.create();$.post(url,param,function(data)FINEDO.Mode.destroy();$(#+datagrid).datagrid(loadData,data); ,json);調(diào)用方式 function doSearch() var param = paramname: $(#paramname).val();FINEDO.Action.doSearch(datagrid,$ctx /finedo/syspar

4、am/querysysparam,param); 1.3、doDelete:執(zhí)行刪除命令，重要應(yīng)當(dāng)在列表操作中，對(duì)數(shù)據(jù)記錄進(jìn)行單條或批量刪除操作。接口定義 /* * 刪除記錄旳公用措施 * datagrid:指定被刪除旳數(shù)據(jù)列表對(duì)象 * action:指定刪除數(shù)據(jù)旳解決措施 * itemid:該值不為空時(shí)，則覺(jué)得是單項(xiàng)刪除 * callback:執(zhí)行完畢后旳回調(diào)函數(shù) */,doDelete:function(datagrid,action,itemid,callback)var ids = ;var message = 您擬定刪除這些記錄嗎?;if(itemid)ids.push(itemid

5、);message = 您擬定刪除該記錄嗎？;elsevar rows = $(#+datagrid).datagrid(getSelections);for(var i=0; irows.length; i+)ids.push(rowsi.optsn);if(ids=)$.messager.alert(提示,請(qǐng)選擇要?jiǎng)h除旳記錄！);return;$.messager.confirm(提示, message, function(which) if (which) FINEDO.Mode.create(); $.getJSON(action+&ids=+ids.join(,), function

6、(ret) FINEDO.Mode.destroy();$.messager.alert(提示,ret.retmsg);$(#+datagrid).datagrid(reload); ); ); 調(diào)用方式 var operation = 刪除; 1.4、doSort:執(zhí)行排序命令，重要應(yīng)當(dāng)在列表操作中，根據(jù)部分字段進(jìn)行數(shù)據(jù)記錄旳排序顯示。接口定義 /* * 排序操作 * datagrid:指定排序旳數(shù)據(jù)列表對(duì)象 * url:調(diào)用旳途徑 * data:排序參數(shù) */,doSort:function(datagrid,url,param)FINEDO.Mode.create();$.post(ur

7、l,param,function(data)FINEDO.Mode.destroy();$(#+datagrid).datagrid(reload); ,json);調(diào)用方式 function doSort() var param = sortField: paramname,sortType:up;FINEDO.Action.doSort(datagrid,$ctx /finedo/sysparam/sort,param); 2、WEB控件參照“協(xié)助組件使用示例”。二、CRUD示例以系統(tǒng)參數(shù)配備作為例子進(jìn)行解說(shuō)。查詢視圖層：構(gòu)建數(shù)據(jù)列表及查詢參數(shù)數(shù)據(jù)列表：系統(tǒng)參數(shù)管理 toolbar=#tb

8、 查詢工具架： 定義查詢函數(shù)：function doSearch() var param = paramname: $(#paramname).val();FINEDO.Action.doSearch(datagrid,$ctx /finedo/sysparam/querysysparam,param); 控制層：調(diào)用系統(tǒng)參數(shù)查詢服務(wù)，并組裝數(shù)據(jù) /* * 查詢系統(tǒng)參數(shù) * param request * return */RequestMapping(/querysysparam)ResponseBodypublic Object querySysParam(HttpServletReque

9、st request) /*# *封裝查詢參數(shù)對(duì)象 *# */SysConfigureparam param = new SysConfigureparam();param.setParamname(request.getParameter(paramname);/*# *封裝查詢對(duì)象，查詢對(duì)象一般涉及查詢參數(shù)對(duì)象及分頁(yè)對(duì)象 *# */SysConfigureParamQueryDomain query = new SysConfigureParamQueryDomain();query.setSysconfigureparam(param);/ 設(shè)立查詢參數(shù)對(duì)象query.setPagepa

10、ram(PageUtil.getPageParam(request);/ 設(shè)立分頁(yè)參數(shù)/*# *調(diào)用服務(wù)類，獲取數(shù)據(jù)列表 *# */ReturnValueDomainPageDomain ret = ServiceCaller.callForPage(service/finedo/configure/querysysparam, query,SysConfigureparam.class);PageDomain page = ret.getObject();List list = page.getDatalist();/*# *構(gòu)建組件需要旳JSON對(duì)象并返回 *# */return Page

11、Util.build(list, page.getRowcount();添加視圖層：構(gòu)建添加系統(tǒng)參數(shù)表單參照頁(yè)面定義規(guī)范控制層：調(diào)用系統(tǒng)參數(shù)添加服務(wù)并返回成果信息 /* * 添加系統(tǒng)參數(shù) * param request * return * throws Exception */RequestMapping(/addSysParam)ResponseBodypublic Object addSysParam(HttpServletRequest request) throws Exception/*# *封裝系統(tǒng)參數(shù)對(duì)象 *# */SysConfigureparam param = FormU

12、til.request2Domain(request,SysConfigureparam.class);/*# *封裝服務(wù)參數(shù)對(duì)象 *# */List list = new ArrayList();list.add(param);SysConfigureParamListDomain domain = new SysConfigureParamListDomain();domain.setConfigureparamlist(list);/*# *調(diào)用服務(wù)進(jìn)行數(shù)據(jù)保存，請(qǐng)返回消息給前臺(tái) *# */ReturnValueDomain ret = ServiceCaller.call(servic

13、e/finedo/configure/insertsysparam, domain,SysConfigureparam.class);param = ret.getObject();return ret;修改視圖層：構(gòu)建修改系統(tǒng)參數(shù)表單參照頁(yè)面定義規(guī)范控制層：調(diào)用系統(tǒng)參數(shù)修改服務(wù)并返回成果信息 /* * 修改系統(tǒng)參數(shù) * param request * return * throws Exception */RequestMapping(/modifySysParam)ResponseBodypublic Object modifySysParam(HttpServletRequest req

14、uest) throws Exception/*# *封裝系統(tǒng)參數(shù)對(duì)象 *# */SysConfigureparam param = FormUtil.request2Domain(request,SysConfigureparam.class);/*# *封裝服務(wù)參數(shù)對(duì)象 *# */List list = new ArrayList();list.add(param);SysConfigureParamListDomain domain = new SysConfigureParamListDomain();domain.setConfigureparamlist(list);/*# *調(diào)用

15、服務(wù)進(jìn)行數(shù)據(jù)保存，請(qǐng)返回消息給前臺(tái) *# */ReturnValueDomain ret = ServiceCaller.call(service/finedo/configure/updatesysparam, domain,SysConfigureparam.class);param = ret.getObject();return ret;刪除 視圖層：調(diào)用刪除系統(tǒng)參數(shù)命令var operation = 刪除;控制層：調(diào)用系統(tǒng)參數(shù)刪除服務(wù)并返回成果信息 /* * 刪除系統(tǒng)參數(shù) * param request * return * throws Exception */RequestMap

16、ping(/deleteSysParam)ResponseBodypublic Object deleteSysParam(HttpServletRequest request) throws Exception/*# *封裝系統(tǒng)參數(shù)對(duì)象 *# */SysConfigureparam param = FormUtil.request2Domain(request,SysConfigureparam.class);/*# *封裝服務(wù)參數(shù)對(duì)象 *# */List list = new ArrayList();list.add(param);SysConfigureParamListDomain domain