【asp.net core 系列】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建立這樣的一個項目，我但願大夥可以本身試試。