App開(kāi)發(fā)規(guī)范和說(shuō)明

1、針對(duì)app開(kāi)發(fā)過(guò)程中的常用操作，進(jìn)行了規(guī)范整理，如下:一、常用工具介紹1、執(zhí)行命令在中定義了常用的命令調(diào)用接口，詳見(jiàn)定義，目前提供了四種命令，如下：、doCommand:執(zhí)行常規(guī)命令，主要應(yīng)該在列表操作中，對(duì)數(shù)據(jù)記錄的某些屬性進(jìn)行簡(jiǎn)單的修改操作，如啟用禁用、升序降序等。接口定義* 一般性的命令操作，用于GET式提交* url:調(diào)用的路徑* callback:執(zhí)行完成后的回調(diào)函數(shù)* alertmsg:執(zhí)行完成后是否彈出返回信息* /doCommand:function(url,callback,alertmsg)$.getJSON(url,function(data)if(alertmsg)$.

2、("提示",;if($.isFunction(callback)callback(data););調(diào)用方式if('1'=operation+='<ahref="javascript:void(0)"onclick="'$ctx/finedo/sysparam/updateStateparamid='+'&state=0',doSearch,true)">禁用</a>'elseoperation+='<ahref="j

3、avascript:void(0)"onclick="'$ctx/finedo/sysparam/updateStateparamid='+'&state=1',doSearch,true)">啟用</a>'、doSearch:執(zhí)行查詢(xún)命令，主要應(yīng)該在列表操作中，根據(jù)輸入的查詢(xún)參數(shù)執(zhí)行數(shù)據(jù)記錄的查詢(xún)。接口定義* 執(zhí)行命令* datagrid:指定查詢(xún)的數(shù)據(jù)列表對(duì)象* url:調(diào)用的路徑* data:查詢(xún)參數(shù)* /,doSearch:function(datagrid,url,param)$.post

4、(url,param,function(data)$('#'+datagrid).datagrid('loadData',data);,'json');調(diào)用方式functiondoSearch()varparam=paramname:$('#paramname').val();'datagrid','$ctx/finedo/sysparam/querysysparam',param);、doDelete:執(zhí)行刪除命令，主要應(yīng)該在列表操作中，對(duì)數(shù)據(jù)記錄進(jìn)行單條或批量刪除操作。接口定義* 刪除記錄的公用

5、方法* datagrid:指定被刪除的數(shù)據(jù)列表對(duì)象* action:指定刪除數(shù)據(jù)的處理方法* itemid:該值不為空時(shí)、則認(rèn)為是單項(xiàng)刪除* callback執(zhí)行完成后的回調(diào)函數(shù)* /,doDelete:function(datagrid,action,itemid,callback)varids=;varmessage="您確定刪除這些記錄嗎"if(itemid)(itemid);message="您確定刪除該記錄嗎"elsevarrows=$('#'+datagrid).datagrid('getSelections'

6、);for(vari=0;i<i+)(rowsi.optsn);if(ids="")$.("提示","請(qǐng)選擇要?jiǎng)h除的記錄！");return;$.('提示',message,function(which)if(which)$.getJSON(action+'&ids='+(','),function(ret)$.("提示",;$('#'+datagrid).datagrid('reload');););調(diào)用方式varope

7、ration='<ahref="javascript:void(0)"onclick="'datagrid','$ctx/finedo/sysparam/deleteSysParam',"+'',doSearch)">刪除</a>&nbsp;'、doSort:執(zhí)行排序命令，主要應(yīng)該在列表操作中，根據(jù)部分字段進(jìn)行數(shù)據(jù)記錄的排序顯示。接口定義/* 排序操作* datagrid:指定排序的數(shù)據(jù)列表對(duì)象* url:調(diào)用的路徑* data:排序參數(shù)* /,do

8、Sort:function(datagrid,url,param)$.post(url,param,function(data)$('#'+datagrid).datagrid('reload');,'json');調(diào)用方式functiondoSort()varparam=sortField:'paramname',sortType:'up''datagrid','$ctx/finedo/sysparam/sort',param);2、WEB控件參考“幫助組件使用示例”二、CRUD示

9、例以系統(tǒng)參數(shù)配置作為例子進(jìn)行講解。1.查詢(xún)視圖層：構(gòu)建數(shù)據(jù)列表及查詢(xún)參數(shù)數(shù)據(jù)列表：<fsdp:gridid="datagrid"url="$ctx/finedo/sysparam/querysysparam"title="當(dāng)前頁(yè)面：系統(tǒng)管理&gt；系統(tǒng)參數(shù)管理"toolbar="#tb"><fsdp:fieldcode=""name=""checkbox="true"></fsdp:field><fsdp:

10、fieldcode="configtypename"name="參數(shù)類(lèi)型"width="100"></fsdp:field><fsdp:fieldcode="paramname"name="參數(shù)名稱(chēng)"width="120"></fsdp:field><fsdp:fieldcode="paramvalue"name="參數(shù)值"width="159"></fsd

11、p:field><fsdp:fieldcode="datatype"name="數(shù)據(jù)類(lèi)型"width="80"></fsdp:field><fsdp:fieldcode="remark"name="描述"width="120"></fsdp:field><fsdp:fieldcode="operation"name="操作"width="200"format

12、ter="formatOperation"></fsdp:field></fsdp:grid>查詢(xún)工具架：<fsdp:toolbarid="tb"><fsdp:buttonbar><fsdp:buttoniconcls="icon-add"name="添力口"plain="true"onclick="='$ctx/fsdp/jsp/sysparam/'"></fsdp:button>

13、<fsdp:buttoniconcls="icon-remove"name="刪除"plain="true"onclick="'datagrid','$ctx/finedo/sysparam/deleteSysParam',null,doSearch)"></fsdp:button></fsdp:buttonbar><fsdp:searchbar><fsdp:textname="paramname"id=&qu

14、ot;paramname"style="width:120px;"label="參數(shù)名稱(chēng)"></fsdp:text>&nbsp;<fsdp:buttonname="查詢(xún)"iconcls="icon-search"onclick="doSearch()"></fsdp:button></fsdp:searchbar></fsdp:toolbar>定義查詢(xún)函數(shù)：functiondoSearch()varparam=p

15、aramname:$('#paramname').val();'datagrid','$ctx/finedo/sysparam/querysysparam',param);控制層：調(diào)用系統(tǒng)參數(shù)查詢(xún)服務(wù)，并組裝數(shù)據(jù)/*查詢(xún)系統(tǒng)參數(shù)paramrequestreturn*/RequestMapping("/querysysparam")ResponseBodypublicObjectquerySysParam(HttpServletRequestrequest)/添加系統(tǒng)參數(shù)param requestreturn#* 封裝查詢(xún)參數(shù)對(duì)

16、象*#* /SysConfigureparamparam=newSysConfigureparam();("paramname");/*#* 封裝查詢(xún)對(duì)象，查詢(xún)對(duì)象一般包含查詢(xún)參數(shù)對(duì)象及分頁(yè)對(duì)象*#* /SysConfigureParamQueryDomainquery=newSysConfigureParamQueryDomain();(param);allForPage("service/finedo/configure/querysysparam",query,;PageDomain<SysConfigureparam>page=();

17、List<SysConfigureparam>list=();/*#* 構(gòu)建組件需要的JSON寸象并返回*#* /return(list,();2.添加視圖層：構(gòu)建添加系統(tǒng)參數(shù)表單參考頁(yè)面定義規(guī)范/*控制層：調(diào)用系統(tǒng)參數(shù)添加服務(wù)并返回結(jié)果信息RequestMapping("/addSysParam")ResponseBodypublicObjectaddSysParam(HttpServletRequestrequest)throwsException/*#* 封裝系統(tǒng)參數(shù)對(duì)象*#* /SysConfigureparamparam=(request,;/*#*

18、封裝服務(wù)參數(shù)對(duì)象*#* /List<SysConfigureparam>list=newArrayList<SysConfigureparam>();(param);SysConfigureParamListDomaindomain=newSysConfigureParamListDomain();(list);/*#* 調(diào)用服務(wù)進(jìn)行數(shù)據(jù)保存，請(qǐng)返回消息給前臺(tái)*#* /ReturnValueDomain<SysConfigureparam>ret=ServiceCaller.call("service/finedo/configure/insert

19、sysparam",domain,;param=();returnret;3.修改視圖層：構(gòu)建修改系統(tǒng)參數(shù)表單參考頁(yè)面定義規(guī)范控制層：調(diào)用系統(tǒng)參數(shù)修改服務(wù)并返回結(jié)果信息/* 修改系統(tǒng)參數(shù)* paramrequest* return* throwsException* /RequestMapping("/modifySysParam")ResponseBodypublicObjectmodifySysParam(HttpServletRequestrequest)throwsException/*#* 封裝系統(tǒng)參數(shù)對(duì)象*#* /SysConfigureparampa

20、ram=(request,；/*#* 封裝服務(wù)參數(shù)對(duì)象*#* /List<SysConfigureparam>list=newArrayList<SysConfigureparam>();(param);SysConfigureParamListDomaindomain=newSysConfigureParamListDomain();(list);/*#* 調(diào)用服務(wù)進(jìn)行數(shù)據(jù)保存，請(qǐng)返回消息給前臺(tái)*#* /ReturnValueDomain<SysConfigureparam>ret=ServiceCaller.call("service/finedo/configure/updatesysparam",domain,;param=();returnret;4.刪除視圖層：調(diào)用刪除系統(tǒng)參數(shù)命令varoperation='<ahref="javascript:void(0)”onclick="'datagrid','$ctx/finedo/sysparam/d