【asp.net core 系列】6 實戰之 一個專案的完整結構
阿新 • • 發佈:2020-06-06
# 0. 前言
在《asp.net core 系列》之前的幾篇文章中,我們簡單瞭解了路由、控制器以及檢視的關係以及靜態資源的引入,讓我們對於asp.net core mvc專案有了基本的認識。不過,這些並不是 asp.net core mvc專案的全部內容,剩下的內容我將結合實戰專案為大家講解其中的知識。現在,就讓我們開始吧。
# 1. 專案構建
拋開之前的專案,現在跟著我重新建立一個專案,第一步依舊是先建立一個解決方案:
```bash
dotnet new sln --name Template
```
我先介紹一下這個專案(指整個專案,不是單獨的asp.net core 應用),這是一個後臺管理的模板應用,提供了常見後臺系統(管理員端)的功能,包括員工管理、部門管理、角色管理等功能。
現在回到專案中,通常一個專案需要一個模型層,一個數據提供層以及web展示層。然後,我們依次建立 Data、Domain、Web 三個專案,其中Data和Domain 是 classlib,Web是mvc專案。
```bash
# 確保當前目錄與 Template.sln 處於相同的目錄
dotnet new classlib --name Data
dotnet new classlib --name Domain
dotnet new mvc --name Web
```
新增三個專案到解決方案中:
```bash
dotnet sln add Data
dotnet sln add Domain
dotnet sln add Web
```
因為Data 中存放著模型層,所以需要其他專案對它有一個引用:
```ba
cd Domain
dotnet add reference ../Data
cd ../Web
dotnet add reference ../Data
```
當然,實際開發中我們應當還有一個Service層,這一層用來存放業務程式碼,減少控制器裡不必要的業務程式碼。那麼繼續:
```bash
# 回到專案的根目錄
cd ..
dotnet new classlib --name Service
dotnet sln add Service
```
然後新增Service的引用:
```bash
cd Service
dotnet add reference ../Data
```
將 Service的引用新增到Web裡:
```bash
cd ../Web
dotnet add reference ../Service
```
現在一個大型工程基本都是面向介面程式設計,幾個關鍵層應當都是介面層,我們實際上還缺少Domain的實現層和Service的實現層。
```bash
cd ..
dotnet new classlib --name Domain.Implements
dotnet new classlib --name Service.Implements
```
在對應的實現層中,引入它們實現的介面層,並引入Data:
```bash
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中新增新建的兩個實現層的引用:
```bash
cd ../Web
dotnet add reference ../Domain.Implements
dotnet add reference ../Service.Implements
```
新增這兩個實現層到解決方案中:
```bash
cd ..
dotnet sln add Domain.Implements
dotnet sln add Service.Implements
```
下圖是到目前為止的專案結構圖:
![](https://img2020.cnblogs.com/other/1266612/202006/1266612-20200606164559783-1600568456.png)
整體而言,Data是各個層之間的資料流通依據,所以各個專案都依賴於此專案,各個介面層的實現層都只對Web可見,其他各層實際上並不清楚具體實現。
隱藏實現層有什麼好處呢?
- 呼叫方不知道實現方的邏輯,避免呼叫方對特定實現的依賴
- 有利於團隊協作,有的團隊是針對模組劃分,有的是針對分層劃分,無論哪種,使用介面都是一個好的選擇
- 有利於後期優化,可以很方便的切換實現層,而不用重新編譯過多的程式碼
當然,並不只有這些好處,不過這樣有一個壞處,在web層呼叫service層時會更繁瑣,不過這也不是不可解決的,後續的內容中會為大家介紹如何解決這個煩惱。
# 2. 專案補充
通常情況下,一個完整的專案還會有一個工具類專案和一個測試專案。所以,繼續新增以下專案:
```bash
dotnet new classlib --name Utils
```
Utils 表示工具類,通常一個專案中工具類會比較多,所以就抽成了一個專案,單獨列出來。
新增測試專案:
```bash
dotnet new nunit --name Test
```
這裡使用的是nunit 3測試框架,當然還有另一個是xunit測試框架。
新增兩個專案到解決方案裡:
```bash
dotnet sln add Utils
dotnet sln add Test
```
# 3. 總結
本章內容旨在通過建立專案,讓大家瞭解實際開發中專案的層級規劃思想,這並不代表我的就是最優的,只是這是我總結出來相對方便的層級關係。這裡並沒有講解如何通過Visual Studio或者Rider建立這樣的一個專案,我希望大夥能夠自己試試。
好了,希望大家能建立好專案,當然了後期我會給大家提供這個專案的原始碼的,地址暫時保密哦。
> 更多內容煩請關注[我的部落格《高先生小屋》](https://www.attachie.club)
![file](https://img2020.cnblogs.com/other/1266612/202006/1266612-20200606164600082-1015038