文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

如何手工搭建ABP框架Web项目

2023-06-04 11:20

关注

本篇文章为大家展示了如何手工搭建ABP框架Web项目,内容简明扼要并且容易理解,绝对能使你眼前一亮,通过这篇文章的详细介绍希望你能有所收获。

ABP是 ASP.NET Boilerplate Project 的简称。ABP是基于DDD(领域驱动设计)的框架。ABP包含众多组件,包括依赖注入、动态API、审计日志、权限控制等等。在大部分的ABP教材中,会推荐使用模板(https://aspnetboilerplate.com/Templates)来创建ABP工程。然而在实际使用中(至少在我的情况里)一般都需要手工搭建框架而非使用模板。手工搭建有下面几个好处:

  1. 模板创建的工程有很多不需要的东西需要调整或删除,手工搭建免去了这些麻烦;

  2. 手工搭建框架能更自由地根据实际需求进行自定义配置和扩展;

  3. 手工搭建能帮助你更深入地理解ABP框架。

由于手工搭建ABP框架材料较少,我搭建时踩了不少坑。所以在这里记录一下搭建框架的核心步骤,以免以后重新摸索。下面我们以开发一个简单的微博应用为例来展示如何使用ABP框架。

新建VS项目

用VS新建Web MVC项目,项目名称为MyTweet.Web。同时新建解决方案,解决方案名称为MyTweet。要注意的一点是ABP只支持.NET 4.6以上版本,所以新建项目时记得选.NET Framework 4.6以上的版本

接下来,我们遵循DDD的原则,新建以下几个层次的项目:

  1. 展现层(Presentation),负责长沙网站建设用户界面与用户交互。在我们这个应用中,展现层是.NET MVC,包括Controller以及前端代码,实现在项目MyTweet.Web中。

  2. 应用层(Application),负责展现层与领域层之间的协调。实现在项目MyTweet.Application中。

  3. 领域层(Domain),负责业务对象与业务逻辑。实现在项目MyTweet.Domain中。

  4. 基础设施层(Infrastructure),提供一些通用的方法。实现在项目MyTweet.Infrastructure中。

新建好项目后,还需要设置引用依赖关系。在此不再赘述。

安装ABP相关的NuGet包

安装Abp包到所有项目。

安装Abp.Web.Mvc和Abp.Web.Api到MyTweet.Web。

创建模块

ABP提供了模块系统。使用模块能方便地管理各个组件的初始化与依赖关系。一般来说,每个项目都会建一个模块。由于本篇只用到了MyTweet.Web和MyTweet.Application,所以先只新建这两个模块。

在MyTweet.Application目录下新建类MyTweetApplicationModule,并继承自AbpModule。

模块中的Initialize方法定义了模块初始化时执行的操作。目前只做了IoC依赖注入的操作。

另外,在MyTweet.Web/App_Start目录下新建类MyTweetWebModule,同样也需要继承自AbpModule,并且,这个模块还需要依赖AbpWebApiModule(WebAPI需要这个模块),MyTweetApplicationModule。

最后,为了让程序运行时能识别并执行模块,需要修改入口方法。.NET MVC的入口方法在Global.asax.cs文件中,如下图,MvcApplication修改为继承AbpWebApplication<MyTweetWebModule>,并相应地修改Application_Start方法。

WebAPI

我们使用WebAPI的方式定义前后端交互的接口。当然,直接使用MVC的方法也是可以的。这里只是单纯为了试用ABP动态WebAPI的用法而使用的WebAPI。

我们将实现两个接口:

  1. GetTweets接口,GET方法,用于查询出所有微博。

  2. CreateTweet接口,POST方法,用于新增一条微博。

因为我们还没实现数据库访问功能,所以现在还不会真正实现这两个接口,这两个接口现在只让它们返回一些测试数据。

在ABP框架下实现WebAPI十分方便,ABP能够使用反射的方法自动从应用层AppService的public方法生成WebAPI接口。只需在MyTweetModule的初始化方法添加代码定义动态ApiController生成规则。

这些代码会在MyTweetApplicationModule的程序集中,将所有IApplicationService的实现类动态生成ApiController,并且根据方法名对public方法绑定相应的HTTP Method动词。
比如,GetTweets绑定为GET方法,PutTweet绑定为PUT方法,其他名称的方法像CreateTweet绑定为POST方法。
(这里有一个例外,Get开头的方法如果参数是一个object——一个DTO的话,那这个方法会被绑定为POST方法。)
生成的WebAPI接口的访问路径为/api/services/MyTweet/{AppSvcName}/{ActionName},其中{AppSvcName}是IApplicationService实现类的类名(去掉后缀AppService),{ActionName}是方法名。

接下来我们实现GetTweets和CreateTweet两个接口

现在只是简单的让这两个接口随便返回一些结果。GetTweets是接收一个字符串参数的GET接口,CreateTweet是接收一个字符串s、一个整数s的POST接口(C#与JavaScript对大小写的编码规范不同是一件很烦人的事,幸好ABP框架做了自动转换)。这两个接口的路径分别为/api/services/MyTweet/MyTweet/GetTweets和/api/services/MyTweet/MyTweet/CreateTweet。

最后测试一下,运行MyTweet.Web项目,GET接口直接在浏览器就能访问。

POST接口可以用Postman工具来访问

大功告成!

你访问API的时候可能会出现"Empty or invalid anti forgery header token"的错误,这是因为某些ABP版本默认开启了CSRF防御。在MyTweetWebModule的PreInitialize方法加上下面这行代码关闭CSRF防御就可以了。

Configuration.Modules.AbpWeb().AntiForgery.IsEnabled = false;

Abp Module

最后简要介绍下ABP的模块系统。更详细的讲解可查阅官网的文档https://aspnetboilerplate.com/Pages/Documents/Module-System。

模块主要用来管理系统初始化和关闭时要执行的操作。ABP在系统初始化和关闭时根据模块间依赖关系执行相应的操作。

定义一个模块只需要继承AbpModule。我们可以用DependsOn标签来声明模块间的依赖关系(ABP框架会自动解析依赖关系,但建议使用显式的声明)。

一个模块会有如下方法,我们可以重载这些方法来定义模块初始化/关闭时要做的操作:

应用启动时会根据模块的依赖顺序进行初始化。比如有模块A和模块B,模块A依赖模块B,那么初始化的执行顺序为:

  1. B的PreInitialize

  2. A的PreInitialize

  3. B的Initialize

  4. A的Initialize

  5. B的PostInitialize

  6. A的PostInitialize

关闭则按照依赖相反顺序:

  1. A的Shutdown

  2. B的Shutdown

ABP框架解析MyTweetModule所依赖的模块,按顺序初始化这些模块(包括MyTweetModule)。

上述内容就是如何手工搭建ABP框架Web项目,你们学到知识或技能了吗?如果还想学到更多技能或者丰富自己的知识储备,欢迎关注编程网行业资讯频道。

阅读原文内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     807人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     351人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     314人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     433人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     221人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-后端开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯