首页 > 代码库 > ASP.NET Aries 3.0发布(附带通用API设计及基本教程介绍)

ASP.NET Aries 3.0发布(附带通用API设计及基本教程介绍)

主要更新:

1:升级处理机制(js请求由同步变更为异步)

2:优化前端JS:包括API和配置方式。

3:增加InputDialog功能。

4:增远远程验证功能。

5:优化权限安全机制。

6:增加一次请求多个方法的功能。

7:优化支持文本数据库(为了演示Demo,节省我服务器的资源)

从旧版本升级的注意事项:

Config_Grid表的字段变更:

viewname字段,变更为Rules,长度为250。

MergeIndexed,改名为:MergeIndex。

开源地址:

GitHub:https://github.com/cyq1162/Aries

Demo演示:http://aries.cyqdata.com/login.html (已经把Demo挂回自己的VPS,同时用上了文本数据库)

JS API通用设计思维介绍:

1:名称空间:

AR.DataGrid:操作表格和树形表格(需要实例化)。

AR.Upload:操作文件上传(需要实例化,如:导入按钮(点击的时候弹出上传Excel文件功能))。

AR.Form:操作表单页面(如普通的编辑或新增页面)。

AR.Combobox:操作下拉框对象。

AR.Utility:通用工具类:如AR.Utility.Ajax类就在这里面。

AR.Global:全局对象。

2:通用事件与属性:

1:对象(包括按钮)都有$target,获取JQ对象。

2:对象(包括按钮)都有isHidden属性,可以按钮显示或隐藏。

3:对象(包括按钮)都有三个事件(不管是按钮还是对象的初始化):

onBeforeExecute

onExecute(默认都执行这个)

onAfterExecute

处理时,根据业务,找到对应的对象,处理该事件即可。

4:有些对象有Items属性(dg.Search.Items、dg.PKColumn.Items、AR.Global.DG.Items)

5:有些对象有add方法。

AR.DataGrid 简单介绍:

1:支持类型(普通表格(datagrid)和树形表格(treegrid)):

2:示例代码:

var dg=new AR.DataGrid(objName,tableName,id,type);

//这里可以控制参数。

dg.bind();//绑定表格

3:呈现的效果:

技术分享

或者是:(树形菜单默认是通过右键菜单控制操作)

技术分享

4:表格常用内部对象:

1:dg.ToolArea:包括搜索(Search)和工具条(ToolBar)。

2:dg.Search:搜索区

3:dg.ToolBar:按钮工具条

4:dg.PKColumn:主键列区

5:dg.HeaderMenu:列头右键菜单

6:dg.ContextMenu:行数据的右键菜单

5:前端JS API编程示例(结合通用对象通用事件,很容易知道在哪处理你要扩展的事件):

比如:你想在点击查询追加条件,那么代码就是:

dg.Search.BtnQuery.onBeforeExecute=function(para){在这里追加条件。}

比如:你想隐藏重置按钮,那么代码是:

dg.Search.BtnReset.isHidden=false;

比如:你想给查询条件某个框赋值,那么代码是:

dg.Search.onAfterExecute=function(para){dg.Search.Items["列名"].val(123);};

也可以在页面加载后处理:

dg.options={

onLoadSuccess:function(){dg.Search.Items["列名"].val(123);}

}

其它细节,在源码Demo里有介绍,这里就点到为止了。

表单:Input相关的配置介绍:

1:远程验证数据是否存在:

 <input name="UserName"  class=‘easyui-validatebox‘ data-options="validType:‘exists[UserName]‘"  />

效果:(框架内部隐式的条件参数包括:页面传递的id,AR.Form.tableName)

技术分享

2:InputDialog

<input name="F4" dialog="Demo_TestA" multiple="true" editable="true" />

单选效果:(第一次运行时,需要配置下表头,隐藏不需要呈现的列,然后调一个搜索框出来)

技术分享

多选效果:

技术分享

选择后,是个下拉,还可以再小操作:

技术分享

3:关于下拉框的具体配置,在Demo里有详细,所以不详说,只上一张图:

技术分享

配置表头的配置规则(即由viewname变名的Rules字段)

技术分享

效果:

技术分享

本配置用于控制搜索区,目前支持$1和$2配置,规则为:

$1:{}处理非下拉:

如果是日期或数据,默认变成区间查询(如上图中的F4字段配置),即默认clone:true,示例配置:

$1:{title:"my title",width:200,clone:false}

$2:{} 处理下拉:

可设按钮宽度,是否多选,是否选择,是否呈现请选择,是否选择时引发查询,示例配置:

$2:{width:200,height:30,isQuery:false,mutiple:true,defaultitem:false}

AR.Utility.Ajax:一次请求多个方法,返回结果合集:

框架里的示例代码:

 $Core.Utility.Ajax.post("GetInitConfig,GetKeyValueConfig", null, null, null, null, function (result) {        $Core.Global.Variable = result.GetInitConfig;        $Core.Global.Variable.isLoadCompleted = true;        $Core.Global.Config = result.GetKeyValueConfig;    });

结果集按方法组合成Json返回。

其它:参考框架Demo,或/Web/SysAdmin/系统系统功能的用法:

技术分享

总结:

1:本版本亲自操刀前端API(之前版本的前端是交另一个同事编写)。

由于操刀前端,最近每天都折腾到深夜3-4点:

技术分享

2:提升了性能(之前的同步导致界面1-2秒空白的卡,速度体验感不好)。

3:提升了安全性(之前版本有一定的权限安全问题)。

4:增强前端使用体验。

ASP.NET Aries 3.0发布(附带通用API设计及基本教程介绍)