前言:
最近园子里ABP炒的火热。看了几篇对于ABP的介绍后,深感其设计精巧,实现优雅。个人感觉,ABP或ABP衍生品的架构设计,未来会成为中型Net项目的首选架构模式。如果您还不了解ABP是什么,有什么特色,请移步:《ABP集合帖》——http://www.cnblogs.com/kebinet/p/5341663.html
项目背景介绍:
作者自参加工作以来,一直在法律圈打转。09-12年间,作者曾带团队用WebForm+N层架构实现了一个律师事务所的OA系统。时过境迁,现在在维护此系统时,发现了当初很多设计不合理的地方。所以本项目延续原OA系统的设计思路,以ABP为基础架构,进行彻底重构。
注意:本系列文章定位为开发笔记,不代表ABP的最佳实践。
一、ABP是什么,ABP.Zero又是什么?从哪里下载ABP项目模板?
ABP全称为:“ASP.NET Boilerplate Project (ASP.NET样板项目)”。顾名思义,ABP实质上是一个.Net开发的分层示例+各种开发辅助类库。ABP是一个以DDD设计模式为原则的Net项目分层示例+一大堆作者写的辅助类库。
ABP.Zero则是ABP的作者配合ABP框架写的一套用户模块。其本质是对ASP.NET Identity的二次封装。
ABP.Zero是一个独立模块。可用可不用。如果您的程序中,用户模块非常独特,建议您不要使用ABP.Zero模块,而是独立实现一套用户系统。在我们的示例项目中,用户模块也是非常独特的,作者会尽可能尝试用ABP.Zero去解决,如果实在无法适用,那么我们将做一套独立的用户模块去替代。
- ABP作者官网:http://www.aspnetboilerplate.com/
- GitHub地址: https://github.com/aspnetboilerplate/
(请默默感谢这两位主要维护人员。如此优秀的开源项目,值得32个赞)
如图所示,登录官网首页后,即可以下载ABP项目模板。这里,我们选择了使用.net framework4.5.2+mvc5的多页面实现。ORM我们选择了EntityFramework,并且选择使用ABP.Zero模块。(此处也可不选,日后需要时再安装)。注意最底部的【EasyFast】,此处是你的解决方案名称。下载并解压后,我们得到了如下文件:
我们将解决方案名称换成了中文【易迅律师事务所OA系统】。(作者手里有多份OA实现,为了防止歧义,才换了中文名称,此处改不改不会对项目本身造成任何影响)
二、ABP使用前的基本设置
2.1、程序包的还原与更新(必须)
我们下载回来的ABP不包含对应packages(例如Newtonsoft.Json、EntityFramework、Log4net等等)。所以在使用前,请先在解决方案上右键,然后选【还原NuGet包】,等全部包下载完成后,再在解决方案上右键,选择【管理解决方案的NuGet程序包】,看看是否有更新,如果有,请同步更新。
请注意:上图所示的包无法更新,会提示有冲突,请忽略,不用更新此包。
2.2、修改数据库连接字符串(非必须)
解决完包的问题后,我们来修改下数据库连接字符串ABP默认的数据库连接字符串名字叫【Default】。嗯,不够高大上,另此字符串的部分参数也不够合适,我们同步修改。此步骤一共需要修改三个文件:
- EasyFast.Web =>Web.config。——修改数据库连接字符串。name改为【AppDbContext】,内容改为用户名+密码连接方式
- EasyFast.EntityFramework=>EasyFastDataModule.cs 。——修改为:Configuration.DefaultNameOrConnectionString = "AppDbContext";
- EasyFast.EntityFramework.EntityFramework=>EasyFastDbContext.cs。——修改为:public EasyFastDbContext() : base("AppDbContext")
web.config修改前:
<connectionStrings> <add name="Default" connectionString="Server=localhost; Database=EasyFast; Trusted_Connection=True;" providerName="System.Data.SqlClient" /> </connectionStrings>
web.config修改后:
<connectionStrings> <add name="AppDbContext" connectionString="data source=(local); initial catalog=oa.easyfast.cn; user id=sa; password=info@123; MultipleActiveResultSets=True; App=EntityFramework" providerName="System.Data.SqlClient" /> </connectionStrings>
小知识——MultipleActiveResultSets=True & Trusted_Connection=True
当在数据库连接字符串中指定MultipleActiveResultSets=True时。可以在一个连接上执行多次查询。这样可大大减轻数据库压力,提高程序负载能力。强烈推荐开启。
当在数据库连接字符串中指定Trusted_Connection=True时,意味着这是一个可信连接。不需要输入用户名密码就可以登录数据库。在正式的生产服务器上,不推荐这么做。(启用该属性,实质上是使用windows账户进行数据库连接。在生产服务器上,windows账户和SQLServer账户应该设置为不同的账户以降低安全风险)
2.3、修改程序命名空间(非必须)
ABP默认使用了简化的命名空间。对于本项目来说,EasyFast.Application、EasyFast.Core、Easyfast.EntityFramework三个层统一使用了EasyFast作为命名空间。EasyFast.WebApi则使用了EasyFast.Api作为命名空间。对于Application、Core、EntityFramework三个层来说,随着项目越来越大,使用相同的命名空间容易引起歧义。所以我们做如下修改:
- EasyFast.Application——命名空间修改为EasyFast.Application
- EasyFast.Core——命名空间修改为EasyFast.Core
- Easyfast.EntityFramework——命名空间修改为Easyfast.EntityFramework
- EasyFast.Api——暂时保持不变
图示:在Application、Core、EntityFramework三个项目上右键,选择属性,将对应的默认命名空间分别修改为EasyFast.Application、EasyFast.Core、EasyFast.EntityFramework
注意:修改命名空间后,需同步修改相应的代码引用。否则程序无法编译通过。请慎重考虑此处是否修改。
2.4、修改启动项目(必须)
ABP的默认启动项目是Core层,这样每次调试时非常麻烦,我们将启动项目修改为【当前选定项】,这样我们在编辑完view页面时,直接按Ctrl+F5就可以直接查看效果。而不用每次都在页面上选择【使用浏览器查看】。修改方法:在解决方案上右键,选择属性,在新打开的窗口中将通用属性中的启动项目选项修改为【当前选定内容】
2.5、初始化数据库(必须)
ABP项目模板中,默认保留了大量model修改记录。在SQL2014环境下,初始化数据库可能会失败。解决办法:删除所有的model修改记录,重新初始化。请删除下图中数字开头的类文件。然后载程序包管理控制台执行【Add-Migration Init】、【Update-DataBase】。注意,在程序包管理控制台中,默认项目需选中EasyFast.EntityFramework。且在执行命令前,鼠标需先选中EasyFast.Web项目。
在执行Add和Update两个命令时,程序需先连接至数据库以确定到底需要更新什么(需要建立、更新、删除哪些表)。但是,在EasyFast.EntityFramework项目中,没有数据库连接字符串。所以程序会卡死一段时间。
解决办法1:在执行命令前,在【解决方案资源管理器】选中web项目(此项前提是上一步中,在解决方案属性中,将启动项目修改为【当前选中项目】)。如此操作,可以让VS知道通过web项目中web.config中的数据库连接字符串去连接数据库。
解决办法2:EasyFast.EntityFramework层中,修改App.config文件,将Web项目中web.config中的连接字符串复制到【<configuration>】节点后。
三、本章节所使用的源码
项目已开源,GitHub地址:https://github.com/easyfast/LawfirmOA