ASP.NET Aries 开源开发框架:开发指南(一)

时间:2022-05-12 14:33:02

前言:

上周开源了Aries开发框架后,好多朋友都Download了源码,在运行过程里,有一些共性的问题会问到。

所以本篇打算写一下简单的开发指南,照顾一下不是太看的懂源码的同学,同时也会讲解一下框架原理。

开源的文章或源码获取地址见上一篇文章:开源:ASP.NET Aries 开发框架

关于框架:

首先,这是一套开发框架,它类同于WebForm、MVC、.NET Core。

相比webform,mvc,.NET Core 它简化了后端很多东西,它也加强了前端一些功能,默认集成的功能和界面,使得框架更倾向某种场景的开发。

在.NET的世界里,开发框架的选择,不应该只有微软系列,还可以有第三方系列。

框架运行指南:

1:Download 源码:

见上篇文章结尾处:http://www.cnblogs.com/cyq1162/p/5487796.html

2:创建数据库:

源码下载后其中一个文件夹:Aries.DataBase

可以选择Mssql或Mysql文件夹下的:数据表脚本(执行创建表),数据脚本(执行创建数据)。

3:配置Web.config:

配置框架初始数据库链接后,执行F5,如果点击登陆提示undefine,需要把关于httpmodule的注释打开。

ASP.NET Aries 开源开发框架:开发指南(一)

然后运行,就可以了。

框架开发指南:

1:关于数据库:

开发:

框架有初始的数据库:其中有一个:Sys_UserInfo 这个表是可以修改扩展用户信息的。

然后你有两种选择:

A:在原有的数据库里建表,开展业务(这时只有一个数据库)。

B:创建新的数据库,开展业务(这时有N个数据库,需要在Web.config添加对应的数据库链接语句,只有一个注意,Key的命名为:数据库名称Conn)。

设计原理:

关于数据库设计这一块,是支持多数据库,同时跨各种数据库类型的,可以各种混搭,只要不存在表名相同,在使用过程中就不用管它属于哪个数据库。

设计原来是这样的:搜集数据库链接(以Conn结尾的)=》搜索所有数据库表及对应的数据库。所以反之根据表名就可以找到对应的库。

如果遇到不同数据库有相同的表名:则需要在前端使用时用:数据库名.表名。(因为按查找规则只会找到第一个出现的表名对应的库)

2:关于增删改查导入导出:

开发:

1:如果你是单表:通过配置菜单就可以搞定了。

2:如果你要呈现的是复杂的多表联合,你有两种选择:

A:在数据库里创建视图,然后把它当单表一样通过配置菜单就可以搞定了。

B:将视图语句,通过文件形式放在App_Data目录下的SQLCode目录下(按指定格式)即可,然后配置菜单就可以搞定了。

关于配置表头:列头里右键出来的(有人不知道哪出来)。 

配置表头里集成了很多常见功能,动动手就可以看出效果了,如把搜索项打勾,就会出来搜索条件框。

ASP.NET Aries 开源开发框架:开发指南(一)

视图语句放在文件的,通过点击查看脚本时,可以在线编辑。

ASP.NET Aries 开源开发框架:开发指南(一)

3:关于格式化:

A:数据库里存档的是0,1,2这种数字,呈现是中文翻译,所以有配置表,在配置表里增加配置项后,在格式化里填写#配置键 就可以了。

B:如果有些数据是动态的,单独有表存放的,就需要写SQL语句放在App_Data\SQLCode目录下的Sql_Combobox.sql文件里(按约定格式),然后把名字配上去。

C:这些弄好的名字,除了格式化,还可以使用在下拉框:configkey取的是配置表的,objName取的是数据库语句的。

<input configkey="性别“.../>

<input objName="C_SYS_Role" .../>

这样就会自动格式好下拉框。

设计原理:

对于这一块的东西,前端发起的各种请求:ajax.html?sys_method=xxxx&sys_objname=xxxx 到最后都会定位到Core项目里的AjaxBase.cs处理(这里集成了核心的操作)

对于ajax.html这个文件是不存在的,只是一个虚拟地址,作为标识判断条件而已,在Core项目里UrlRewrite里相关的判断条件。

一个页面:通常会发起四个请求:

ASP.NET Aries 开源开发框架:开发指南(一)

GetInitConfig:返回ui(子应用程序部署时的目录),actionkeys(当前页面的功能权限),mid(菜单ID)。

GetKeyValueConfig:返回配置表的数据(后台会有缓存),用于翻译和绑定下拉框。

GetHeader:返回列头信息(第一次不存在时,会读数据库的元数据,创建生成)

GetList:返回表的数据。

如果界面有对于自定义语句的的下拉数据绑定,则会多一个请求:

ASP.NET Aries 开源开发框架:开发指南(一)

GetCombobox是动态发起请求,获取自定义SQL语句的数据,然后绑定下拉框数据。

4:关于请求的处理流程:

1:一个Ajax请求从页发起后:AR.Utility.Ajax.Post之后,所有的请求地址都是ajax.html。
2:然后到了UrlRewirte.cs,判断是ajax.html,就调用InvokeLogic
3:然后到了Aries.Logic项目里Handler文件夹下的类,具体调用哪个类,处理流程如下:

A:如果有类名和文件名同名,就调用类名.cs

B:如果不存在A,则看有没和html所在文件夹名同名的,如果有,就调用文件夹名.cs(就像SysAdmin系统管理的请求都在SysAdminHandler处理)

C:如果B也不存在,则调用DefaultHandler.cs

所有的Handler入口,都继承自AjaxBase。

结束:

本篇先介绍到这里,其它内容,另外再写文分享,谢谢各位支持点赞的朋友,还有各位给我打赏让我买水喝的朋友。 

作为.NET战线上的十年的一名老战士,衷心希望.NET的明天会更好,为了这份更好,贡献自己目前为止的最优作品。