ASP.NET Aries 开源开发框架：开发指南（一）

前言：

上周开源了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，如果点击登陆提示“please check web.config's httpmoudle!”。

login.html中的内容：

需要把关于httpmodule中关于Aries.Core的配置的注释打开（或关闭）

然后运行，就可以了。 

 

框架开发指南：

1：关于数据库：

开发： 

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

然后你有两种选择：

A：在原有的数据库里建表，开展业务（这时只有一个数据库）。

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

比如你有一个数据库名叫：MyDB，那么你就添加一条<add name="MyDBConn" connectionString="..." />

设计原理：

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

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

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

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

开发：

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

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

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

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

关于配置表头：列头里右键出来的（有人不知道哪出来）。 

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

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

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里相关的判断条件。

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

 

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

GetKeyValueConfig：返回配置表的数据（后台会有缓存），用于翻译和绑定下拉框。

GetHeader：返回列头信息（第一次不存在时，会读数据库的元数据，创建生成）

GetList：返回表的数据。

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

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

 

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

1：一个Ajax请求从页发起后：AR.Utility.Ajax.Post之后，所有的请求地址都是ajax.html。
2：然后到了UrlRewirte.cs，判断是ajax.html，就调用InvokeLogic
3：InvokeLogic会根据规则调用相应的Controller，处理流程如下：

A：如果有类名和文件名同名，就调用类名.cs

B：如果不存在A，则看有没和html所在文件夹名同名的，如果有，就调用文件夹名.cs（就像SysAdmin系统管理的请求都在SysAdminController处理）

C：如果B也不存在，则调用DefaultController.cs

所有的Controller入口，都继承自Aries.Core.Controller。

 

更多教程：https://www.cnblogs.com/cyq1162/category/828163.html

 

结束：

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

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