【asp.net core 系列】6 實戰之 一個專案的完整結構

月影西下發表於2020-06-06

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建立這樣的一個專案,我希望大夥能夠自己試試。

好了,希望大家能建立好專案,當然了後期我會給大家提供這個專案的原始碼的,地址暫時保密哦。

更多內容煩請關注我的部落格《高先生小屋》

file

相關文章