aspnet-core-系列6-实战之-一个项目的完整结构

53次阅读

共计 2237 个字符,预计需要花费 6 分钟才能阅读完成。

0. 前言

在《asp.net core 系列》之前的几篇文章中,我们简单了解了路由、控制器以及视图的关系以及静态资源的引入,让我们对于 asp.net core mvc 项目有了基本的认识。不过,这些并不是 asp.net core mvc 项目的全部内容,剩下的内容我将结合实战项目为大家讲解其中的知识。现在,就让我们开始吧。

1. 项目构建

抛开之前的项目,现在跟着我重新创建一个项目,第一步依旧是先创建一个解决方案:

dotnet new sln --name Template

我先介绍一下这个项目(指整个项目,不是单独的 asp.net core 应用),这是一个后台管理的模板应用,提供了常见后台系统(管理员端)的功能,包括员工管理、部门管理、角色管理等功能。

现在回到项目中,通常一个项目需要一个模型层,一个数据提供层以及 web 展示层。然后,我们依次创建 Data、Domain、Web 三个项目,其中 Data 和 Domain 是 classlib,Web 是 mvc 项目。

# 确保当前目录与 Template.sln 处于相同的目录
dotnet new classlib --name Data
dotnet new classlib --name Domain
dotnet new mvc --name Web

添加三个项目到解决方案中:

dotnet sln add Data
dotnet sln add Domain
dotnet sln add Web

因为 Data 中存放着模型层,所以需要其他项目对它有一个引用:

cd Domain
dotnet add reference ../Data
cd ../Web
dotnet add reference ../Data

当然,实际开发中我们应当还有一个 Service 层,这一层用来存放业务代码,减少控制器里不必要的业务代码。那么继续:

# 回到项目的根目录
cd ..
dotnet new classlib --name Service
dotnet sln add Service

然后添加 Service 的引用:

cd Service
dotnet add reference ../Data

将 Service 的引用添加到 Web 里:

cd ../Web
dotnet add reference ../Service

现在一个大型工程基本都是面向接口编程,几个关键层应当都是接口层,我们实际上还缺少 Domain 的实现层和 Service 的实现层。

cd ..
dotnet new classlib --name Domain.Implements
dotnet new classlib --name Service.Implements

在对应的实现层中,引入它们实现的接口层,并引入 Data:

cd Domain.Implements
dotnet add reference ../Data
dotnet add reference ../Domain
cd ../Service.Implements
dotnet add reference ../Data
dotnet add reference ../Domain
dotnet add reference ../Service

这里在 Service 的实现层添加 Domain 接口层的引用,而不是实现层的引用。这是因为面向接口编程,我们需要对 Service 实现层隐藏 Domain 的实现,所以对于 Service 的实现层来说,不需要关心 Domain 层的实现逻辑。

在 Web 中添加新建的两个实现层的引用:

cd ../Web
dotnet add reference ../Domain.Implements
dotnet add reference ../Service.Implements

添加这两个实现层到解决方案中:

cd ..
dotnet sln add Domain.Implements
dotnet sln add Service.Implements

下图是到目前为止的项目结构图:

整体而言,Data 是各个层之间的数据流通依据,所以各个项目都依赖于此项目,各个接口层的实现层都只对 Web 可见,其他各层实际上并不清楚具体实现。

隐藏实现层有什么好处呢?

  • 调用方不知道实现方的逻辑,避免调用方对特定实现的依赖
  • 有利于团队协作,有的团队是针对模块划分,有的是针对分层划分,无论哪种,使用接口都是一个好的选择
  • 有利于后期优化,可以很方便的切换实现层,而不用重新编译过多的代码

当然,并不只有这些好处,不过这样有一个坏处,在 web 层调用 service 层时会更繁琐,不过这也不是不可解决的,后续的内容中会为大家介绍如何解决这个烦恼。

2. 项目补充

通常情况下,一个完整的项目还会有一个工具类项目和一个测试项目。所以,继续添加以下项目:

dotnet new classlib --name Utils

Utils 表示工具类,通常一个项目中工具类会比较多,所以就抽成了一个项目,单独列出来。

添加测试项目:

dotnet new nunit --name Test

这里使用的是 nunit 3 测试框架,当然还有另一个是 xunit 测试框架。

添加两个项目到解决方案里:

dotnet sln add Utils
dotnet sln add Test

3. 总结

本章内容旨在通过创建项目,让大家了解实际开发中项目的层级规划思想,这并不代表我的就是最优的,只是这是我总结出来相对方便的层级关系。这里并没有讲解如何通过 Visual Studio 或者 Rider 创建这样的一个项目,我希望大伙能够自己试试。

好了,希望大家能创建好项目,当然了后期我会给大家提供这个项目的源码的,地址暂时保密哦。

更多内容烦请关注我的博客《高先生小屋》

正文完
 0