基于ASP.NET Core 6.0的整洁架构

背景

最近尝试录制了一个系列视频:《ASP.NET Core 6.0+Vue.js 3 实战开发》,本节是视频内部整洁架构的理论和实战的文字稿。因为在录制之前,我通常会编写完整的文字内容作为视频文案,这里分享给大家,希望对你有所帮助。如果您能捧个人场,订阅我的视频,感激不尽。
虽然是收费的视频,但是我的分享不会止步,再次感谢您的阅读。

视频地址

点击跳转: https://appstv6elnt7382.h5.xiaoeknow.com/

文章主题

本章将介绍基于ASP.NET Core的整洁架构的设计理念,同时基于理论落地的代码模型,包括文件夹、文件、项目的组织形式以及项目的依赖关系,为企业级可扩展的架构奠定基础。
本章学习主题包括:

  • 整洁架构介绍

  • 核心层

  • 基础设施层

  • 表示层

  • 测试管理

  • 构建整洁架构解决方案

3.1 整洁架构介绍

很多公司系统多样,每个系统的分层结构各不相同,这给开发和未来的运维带来了巨大的成本,分层架构看似很简单,但保证整个研发中心都使用统一的分层架构就不容易了。
那么如何保证整个研发中心都使用统一的分层架构,以达到提高编写代码效率、保证工程统一性的目的?
我们推荐行业内目前比较流行的整洁架构。
整洁架构是什么?简而言之,它是组织软件体系结构的原则,可以轻松面对未来的不确定性,方便代码的重构。同时,它可以帮助我们为特定的领域模型构建服务,从而为将来可能的微服务体系结构做好准备。
我们看下整洁架构的洋葱示意图:
0711be5e7e1f6acf3476063322c56039.png

在整洁架构中,领域层(Domain)和应用层(Application)是架构的核心层。领域层包含实体、枚举和常量设置等,应用层则包含数据传输对象(DTO)、接口、映射、异常、行为和业务逻辑。
整洁架构和传统三层架构的不同之处在于依赖的不同,因为企业的核心逻辑是可以跨系统共享的,而应用逻辑或业务逻辑是特定的。所以为了复用,现在,我们不再让核心层依赖数据访问和基础设施,而是颠倒这些依赖关系。如上图所示,表示层和基础设施层现在是依赖于我们的核心层,但核心层对任何一层都没有依赖性。
这种架构必须通过在应用层内添加抽象或接口来实现,这些抽象或接口是在应用层之外的其他层实现的。例如,如果我们想要实现存储库模式(Repository),我们一般会在应用层添加一个IRepository接口,而实现放在基础设施层。
有了这个设计原则,所有依赖项都指向圆的重心,而最内部的领域层对其他层没有任何依赖性。随后,表示和基础设施层依赖于核心层,而不是彼此依赖。这一点非常重要,因为我们希望确保该系统的逻辑保留在核心内,这样我们就可以重用业务逻辑。我们举个反例,如果表示层依赖基础设施层,那么在发生短信通知的时候,这个逻辑就会停留在表示层中,因为它必须协调表示层和基础设施层之间的交互,如果是这样,未来我们就很难重用这种逻辑。
如果洋葱示意图不好理解,我们可以结合下面扁平化的示意图来理解。

扁平示意图:
2d85f7755987a10a4416414058833ff4.png

我们看到我们的应用层处在最底下,它没有任何依赖项。基础设施层依赖于应用层,最后整个应用程序变得高度可测试,我们可以快速编写单元测试、集成测试和功能测试。
下面,我们将把每一层的职责逐步展开介绍,最后我们会通过代码(基于.NET 6.0)把整洁架构这套理念落地到我们的解决方案当中。

  • 核心层(Core)将包含应用项目和领域项目;

  • 基础设施层(Infrastructure)将包含数据和共享项目;

  • 展示层(Presentation)将包含一个WebApi项目。
    以上就是基于NET Core解决方案的项目设置和文件夹安排。

3.1.1 核心层(Core)

核心层是整洁架构的中心,因为它本身不会依赖于其他层。核心层包含两个项目,分别是.Domain和.Application,下面展开描述:
1)领域层(Domain)项目
.Domain项目是一个.NET Standard 2.1类库,它包含实体、接口、枚举、DTO等。
领域项目必须有一个空的项目引用,这表明它对任何项目都没有依赖关系。
2)应用层(Application)项目
.Application项目也是一个.NET Standard 2.1类库,它定义了接口,但实现不在这一层。该项目还具有CQRS模式的命令和查询、MediatR的行为、AutoMapper对象映射、异常、模型等。

思考:
如果我们要构建微服务,并意识到核心层中有代码会在其他服务中重用,该怎么办?
答案:
我们可以抽象出一个共享项目(.Shared),可以作为一个NuGet包,在微服务中共享代码。

3.1.2 基础设施层

基础设施层包含应用层中定义的接口的实现,内部还包括SMTP、文件系统或web服务等资源,都在这一层中实现。
该层是解决方案中的另一个文件夹目录,内部包括多个项目,比如数据层和共享层,另外我们还可以添加Identity的项目进行身份验证(这里暂时省略)。

1)数据(Data)项目
数据项目是一个NET 6.0类库项目,用于数据库持久化,内部包括仓储类、实体类、数据迁移等内容。

2)共享(Shared)项目
共享项目也是一个NET 6.0类库项目,该项目包含了不同服务之间的共享代码,比如电子邮件、短信或日期等。

3.1.3 展示层

展示层是构建web应用程序的地方,我们可以使用ASP.NET Core MVC、ASP.NET Core Web API、单页应用程序(SPA)或移动应用程序。
1)Web API项目
本视频会使用一个Web API项目和一个网站作为案例演示。
WebApi是基于.NET 6.0构建的一个ASP NET Web API项目,可与任何客户端应用程序交互,例如web、移动、桌面和物联网(IoT)。
此外,WebApi依赖于应用层和基础设施层。
2)客户端项目
客户端项目用于用户界面的展示,我们将采用Vue.js 3进行搭建(在第11节介绍),它也将被归类在展示层。

3.1.4 测试管理

测试管理项目并不是整洁架构原则的一部分,但是这里也一并介绍。因为,基于测试驱动的开发是一种好的编程习惯,这里的测试包括单元测试、功能测试、集成测试和负载测试等。
1)单元测试项目
单元测试是测试代码的小部分代码,比如特定的方法或者服务。可以使用XUnit、NUnit或MSTest项目创建此项目。

2)集成测试项目
集成测试是测试类库或组件是否能在一起工作。可以使用XUnit、NUnit或MSTest项目创建此项目。

现在,我们已经完成整洁架构的整体介绍,是时候编码实现了。

3.2 构建整洁架构解决方案

本小节将通过代码落地一个基于整洁架构的物联网解决方案。该项目的目标是适用大部分物联网场景,管理员可以在其中添加、删除、更新和读取物模型。
本视频的所有命令行都可以在我的博客上获得,不想敲命令的同学可以自行获取。
开始之前,请先打开终端并导航到项目文件的目录中。
我这里使用的Hyper终端,对于Windows用户,请使用PowerShell或Git Bash终端。如果使用PowerShell,请记住使用反斜杠而不是正斜杠。
创建解决方案如果使用IDE(比如Visual Studio 2022)会简单很多,这里使用命令行有个用意,一个是尝鲜,了解命令的构建方式;另一个是考虑将来可能的CI/CD,为自动化开发做准备。
1)创建解决方案
我们运行以下命令创建一个iot文件夹:
mkdir iot
然后进入该目录:
cd iot
使用dotnet CLI创建一个解决方案:
dotnet new sln
该命令默认使用目录名称iot作为解决方案的名称。
接着,在iot目录中创建一个src文件夹:
mkdir src
现在,进入src目录,并分别创建三个目录:

cd srcmkdir 1.coremkdir 2.infrastructuremkdir 3.presentation

2)创建core文件夹
一级目录和文件夹创建完成后,我们进入core文件夹:
cd 1.core
在core目录中,我们将创建两个项目Iot.Domain和Iot.Application:

dotnet new classlib -f net6.0 --name Iot.Domaindotnet new classlib -f net6.0 --name Iot.Application
以上两个项目都是基于.NET 6.0,现在进入Iot.Application目录并创建对Iot.Domain的依赖关系:
cd Iot.Application
dotnet add reference ../Iot.Domain/Iot.Domain.csproj

3)创建infrasturcture文件夹
接下来,我们转入infrasturcture目录:
cd ../../2.infrastructure
在该目录中,我们创建两个基于.NET 6.0的项目,分别是Iot.Data和Iot.Shared:

dotnet new classlib -f net6.0 --name Iot.Datadotnet new classlib -f net6.0 --name Iot.Shared
接下来,进入Iot.Data目录:

cd Iot.Data
创建对Iot.Domain和Iot.Application的依赖

dotnet add reference ../../1.core/Iot.Domain/Iot.Domain.csprojdotnet add reference ../../1.core/Iot.Application/Iot.Application.csproj
现在,转到Iot.Shared目录:

cd ../Iot.Shared
创建对Iot.Application的依赖
dotnet add reference ../../1.core/Iot.Application/Iot.Application.csproj

4)创建presentation文件夹
转到presentation目录:
cd ../../3.presentation
创建WebApi项目,并转入到Iot.WebApi:

dotnet new webapi --name Iot.WebApicd Iot.WebApi

创建对Iot.Application和Iot.Data的依赖

dotnet add reference ../../1.core/Iot.Application/Iot.Application.csprojdotnet add reference ../../2.infrastructure/Iot.Data/Iot.Data.csproj

接下来,创建对Iot.Shared的依赖:
dotnet add reference ../../2.infrastructure/Iot.Shared/Iot.Shared.csproj
5)注册项目到解决方案
转到解决方案所在的根目录:
cd ../../../
注册所有的项目到解决方案,注册顺序依次:

dotnet sln add src/1.core/Iot.Domain/Iot.Domain.csprojdotnet sln add src/1.core/Iot.Application/Iot.Application.csprojdotnet sln add src/2.infrastructure/Iot.Data/Iot.Data.csprojdotnet sln add src/2.infrastructure/Iot.Shared/Iot.Shared.csprojdotnet sln add src/3.presentation/Iot.WebApi/Iot.WebApi.csproj

至此,我们已经通过.NET CLI完成了我们解决方案的实现,接下来我们关闭终端并使用Visual Studio 2022打开我们的解决方案,如下图所示:

整洁架构的解决方案示意图:
a37ccf116be38d8b90501df885ac5dac.png

3.3本节总结

通过本节的学习,我们了解了什么是整洁架构,整洁架构的模块内容以及依赖关心,以及它将如何帮助开发人员构建可扩展、可演化、可测试的应用程序,比如为将来从单体向微服务演化打下一定的基础。
另外,我们还学习了如何在整洁架构中构造测试,最后,如何通过dotnet CLI构建ASP.NET Core的解决方案。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/283128.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

大并发数据队列

图解#include<stdio.h>#include<stdlib.h>#include<memory.h>#define N 100#define mytype intstruct MyQueue{mytype data[N];//数组存储队列int front;//拉屎int rear;//吃东西};typedef struct MyQueue myQ;//初始化void init(myQ *p){p->front p->…

java单精度实型_Java的八种基本类型及其各种数据类型的相互转换

一、八种基本类型1、六种数字类型(四个整数型&#xff0c;两个浮点型)字节型byte 8位-2^7到2^7短整型short 16位整型int 32位 长整型long 64位单精度float 32位 双精度double 64位2、一种字符类型字符型char 8位3、还有一种布尔型。布尔型&#xff1a;boolean 8位 可存储&q…

geotrellis使用(二十九)迁移geotrellis至1.1.1版

目录 前言升级过程总结一、前言 由于忙着安装OpenStack等等各种事情&#xff0c;有半年的时间没有再亲密的接触geotrellis&#xff0c;甚至有半年的时间没能畅快的写代码。近来OpenStack折腾的稍见成效&#xff0c;历经九九八十一Failure后成功的在16台服务器上搭建了云平台&am…

python中的logger模块详细讲解

logger 提供了应用程序可以直接使用的接口handler将(logger创建的)日志记录发送到合适的目的输出filter提供了细度设备来决定输出哪条日志记录formatter决定日志记录的最终输出格式 logging模块介绍 Python的logging模块提供了通用的日志系统&#xff0c;熟练使用logging模块可…

总在用户态调试 C# 程序,终还是搭了一个内核态环境

一&#xff1a;背景 一直在用 WinDbg 调试用户态程序&#xff0c;并没有用它调试过 内核态&#xff0c;毕竟不是做驱动开发&#xff0c;也没有在分析 dump 中需要接触用内核态的需求&#xff0c;但未知的事情总觉得很酷&#xff0c;加上最近在看 《深入解析 Windows 操作系统》…

CentOS搭建Sqoop环境

Sqoop是一个用来将Hadoop&#xff08;Hive、HBase&#xff09;和关系型数据库中的数据相互转移的工具&#xff0c;可以将一个关系型数据库&#xff08;例如&#xff1a;MySQL ,Oracle ,Postgres等&#xff09;中的数据导入到Hadoop的HDFS中&#xff0c;也可以将HDFS的数据导入到…

bat kafka启动_windows下搭建Kafka,并通过命令窗口收发消息

参考网址&#xff1a;前提条件&#xff1a;windows环境需要安装jdk2.由于Kafka依赖于zookeeper&#xff0c;所以也需要下载zookeeper,可以通过官网下载http://zookeeper.apache.org/3.安装zookeeper将压缩包解压后&#xff0c;到bin目录下&#xff0c;启动zkServer.bat即可注意…

异常处理、socke基于TCP协议编程

一、异常处理 1、错误和异常 1.程序中难免出现错误&#xff0c;而错误分成两种 &#xff08;1&#xff09;语法错误&#xff08;这种错误过不了Python解释器的语法检测&#xff0c;必须在程序执行前改正&#xff09; #语法错误示范一 if#语法错误示范二 def test:pass#语法错误…

getComputedStyle方法的那些事

一、getComputedStyle是&#xff1f;getComputedStyle是一个可以获取当前元素所有最终使用的CSS属性值。返回的是一个CSS样式声明对象([object CSSStyleDeclaration])&#xff0c;只读。 getComputedStyle() gives the final used values of all the CSS properties of an elem…

maven正确的集成命令-U-B

http://healthandbeauty.iteye.com/blog/1618501 在持续集成服务器上使用怎样的 mvn 命令集成项目&#xff0c;这个问题乍一看答案很显然&#xff0c;不就是 mvn clean install 么&#xff1f;事实上比较好的集成命令会稍微复杂些&#xff0c;下面是一些总结&#xff1a; 不要忘…

如何避免 .NET 中 HttpClient 的 DNS 失效问题?

HttpClient 可以用来发送 HTTP 请求。HttpClient 可以设置为单例并在整个生命周期中重复使用。这是因为&#xff0c;HttpClient 有一个“连接池”来重用连接并减少 TCP 连接的数量。因此&#xff0c;如果您向同一主机发送多个请求&#xff0c;它们将重用相同的连接。这样&#…

POJ 1159 Palindrome(字符串变回文:LCS)

POJ 1159 Palindrome(字符串变回文:LCS) http://poj.org/problem?id1159 题意: 给你一个字符串, 问你做少须要在该字符串中插入几个字符能是的它变成一个回文串. 分析: 首先把原字符串和它的逆串进行匹配, 找出最长公共子序列. 那么最长公共子序列的字符串肯定是一个回文串. 所…

java excutorthread_Java中ThreadPoolExecutor的参数理解

一、使用Executors创建线程池之前创建线程的时候都是用的Executors的newFixedThreadPool(),newSingleThreadExecutor(),newCachedThreadPool()这三个方法。当然Executors也是用不同的参数去new ThreadPoolExecutor1. newFixedThreadPool()创建线程数固定大小的线程池。 由于使用…

yii1.0性能调优之改善并发数

开启YII的APC缓存 在config/main.php components 组件下添加&#xff1a; apccache>array(class>system.caching.CApcCache), 下载php_apc.dll&#xff0c;文件放到php/ext 下&#xff0c;搜索时可能会比较麻烦.... 在php.ini 中添加php_apc扩展&#xff1a; extension…

windows下apache报错The requested operation has failed解决方法

2019独角兽企业重金招聘Python工程师标准>>> Apache报错The requested operation has failed&#xff0c;基本上是因为端口被占用。解决方法如下&#xff1a; 第一步&#xff0c;运行cmd&#xff0c;cd 定位到Apache安装目录的bin目录下&#xff0c;输入httpd.exe -…

stm32 usmart使用

我直接用正点原子给的&#xff0c;步骤如下 先添加三个.c进工程&#xff0c;添加两个头文件的编译路径 #include "usart.h"#include "usmart.h" main函数里添加如下 NVIC_PriorityGroupConfig(NVIC_PriorityGroup_2);// 设置中断优先级分组2 uart_init(960…

Scylla——开源免费的优秀代理 IP 池:自动验证、JSON API、基于 React 的 Web UI、Docker 支持...

GitHub&#xff1a;github.com/imWildCat/s… 中文文档&#xff1a;scylla.wildcat.io/zh/latest/ 自己是一个爬虫爱好者&#xff0c;有时候爬虫写的太过强大了被目标网站封了&#xff08;笑&#xff09;。所以就萌生了用代理 IP 的想法。很可惜很多开源代理 IP 池都是没有持续…

vs2015提示中文

解决方案&#xff1a;1.找到这个目录C:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework 进入 \v4.0\zh-Hans的目录&#xff0c;全部复制&#xff0c;覆盖掉\v4.5\zh-Hans就行了

Istio 1.15 发布,支持 arm64 架构处理器

Istio 是基于容器的云原生技术栈的三大核心技术之一&#xff0c;另外两个是 Kubernetes 和 Knative。其中 Kubernetes 和 Knative 早已支持了 arm64 架构&#xff0c;甚至连 Istio 的数据平面 Envoy 早在 1.16 版本 [1] 就已支持 arm64 架构&#xff08;2020 年 10 月&#xff…

TP框架表单验证 【包含ajax方法】

之前的表单验证都是用js写的&#xff0c;这里也可以使用tp框架的验证。但是两者比较而言还是js验证比较好&#xff0c;因为tp框架验证会运行后台代码&#xff0c;这样运行速度和效率就会下降。  自动验证是ThinkPHP模型层提供的一种数据验证方法&#xff0c;可以在使用create创…