SimpleAdmin手摸手教學之:項目架構設計2.0

来源:https://www.cnblogs.com/huguodong/archive/2023/04/04/17287979.html
-Advertisement-
Play Games

一、說明 在SimpleAdmin1.0版本中,我將整體項目結構分為三大塊,分別為架構核心、業務模塊和應用服務。隨著1.0版本的封版,回去再看我之前的項目架構,也暴露了一些問題,比如在1.0版本中,Signalr和Mqtt只能二選一,這顯然是不科學的,因為這兩種雖然都可以作為消息通知,但是顯然可以有 ...


一、說明

在SimpleAdmin1.0版本中,我將整體項目結構分為三大塊,分別為架構核心業務模塊應用服務。隨著1.0版本的封版,回去再看我之前的項目架構,也暴露了一些問題,比如在1.0版本中,Signalr和Mqtt只能二選一,這顯然是不科學的,因為這兩種雖然都可以作為消息通知,但是顯然可以有更多的應用場景,所以如果兩者只能用其一的話,顯然整個項目架構就不靈活了。並且隨著功能越來越多,太多的代碼集合在一個應用中,僅僅以文件夾區分功能模塊的話,會不會導致項目越來越臃腫?慢慢的就成了屎山了。這個時候我就想到了很多系統都會採用的插件式開發的模式,在業務模塊中,除了基礎的功能之外,一些拓展性功能採用插件的方式創建在獨立的類庫中,這樣的話我們想要用哪個功能就引用該功能的項目,如果功能有問題我們也能快速定位到代碼的位置,非常方便。於是,我就在SimpleAdmin1.0的基礎上,對現有架構進行重新設計,以下是2.0架構設計的一些特色:

  1. 插件式開發:分層明確,減少代碼耦合性,增強代碼可讀性,避免項目成為屎山。
  2. Signalr和Mqtt並存:將Mqtt和Signalr都封裝成插件使用,想要使用哪個就引用那個插件,並且支持同時引用。
  3. 支持MemerCache:支持記憶體緩存,無需依賴redis即可啟動項目。

二、項目結構

2.0的項目結構主要分為架構核心系統插件業務模塊應用服務,相比於1.0,多了一個插件層。

如圖所示:

三、分層說明

3.1 架構核心

SimpleAdmin.Core->核心層

核心層,公共組件,常量,枚舉,通用方法等其他核心代碼,可以被任何項目引用,不依賴其他項目。

│  Core.Development.json  -->  開發環境配置
│  Core.Production.json  -->  生產環境配置
│  Startup.cs  -->  啟動類
├─Attributes  -->  特性
├─BaseInput  -->  共用輸入參數(分頁,ID傳參等)
├─Components  -->  公共組件
├─Const  -->  常量
├─Dto  -->  數據類
├─Extension  -->  拓展
├─UnifyResult  -->  統一返回結果
└─Utils  -->  工具類(驗證碼,圖片處理,種子數據處理等)

3.2 系統插件

系統插件是新增的一層,目的是把一些通用的代碼抽取出來,封裝成類庫插件的形式,給不同的項目引用,如果需要哪個功能,直接引用對應的插件即可,非常清晰。哪個功能有問題直接去對應的插件查找,非常方便。這裡不做過多的介紹,後面將單開一篇教程詳細介紹插件功能。

3.2.1 核心插件

核心插件通常放置一些系統通用插件,如orm,緩存等,這些是系統的基礎,基本上所有業務模塊都需要用到的插件。

├─SimpleAdmin.Plugin.Aop  -->  Aop插件
├─SimpleAdmin.Plugin.Cache  -->  緩存插件
├─SimpleAdmin.Plugin.CodeFirst  -->  CodeFirst資料庫初始化插件
├─SimpleAdmin.Plugin.Core  -->  插件核心,被其他插件引用
├─SimpleAdmin.Plugin.SqlSugar  -->  SqlSugar ORM插件

3.2.2 系統模塊插件

系統模塊插件主要是對應的我們SimpleAdmin.System層所用到的插件。

├─SimpleAdmin.Plugin.Batch  -->  批量編輯插件
├─SimpleAdmin.Plugin.Gen  -->  代碼生成器插件
├─SimpleAdmin.Plugin.ImportExport  -->  批量導入導出插件
├─SimpleAdmin.Plugin.Mqtt  -->  MQTT插件
├─SimpleAdmin.Plugin.Signalr  -->  Signalr插件

3.3 業務模塊

SimpleAdmin.System->系統應用層

系統應用層,主要是提供系統應用服務給Api介面層調用,SimpleAdmin的主要功能都由該層實現。

│  Startup.cs  --> 啟動類
│  System.Development.json  -->  開發環境配置
│  System.Production.json  -->  生產環境配置
├─EventSubscriber  -->  事件匯流排
├─Oss  -->  對象存儲
├─Services  -->  服務(系統功能介面加實現)
└─UserManager  -->  用戶中心(獲取當前請求用戶信息)

SimpleAdmin.Application->業務應用層

業務應用層,主要是業務代碼的編寫,可以將自己的業務寫在該層,當然也可以自己新建一層寫。本系統該層主要是用作數據許可權示例。

│  Application.Development.json  --> 開發環境配置
│  Application.Production.json  --> 生產環境配置
│  Startup.cs  --> 啟動類
└─Service  --> 服務(業務功能實現)

3.4 應用服務

3.4.1 Web

SimpleAdmin.Web.Entry->啟動層

Web 入口層,主要作用就是作為程式入口,沒有什麼實際業務,沒啥好講的,主要是一些全局的設置,詳情見appsettings.json

│-- appsettings.json --> 啟動層配置文件
│-- ip2region.db --> 解析ip用的資料庫文件
│-- Program.cs --> 啟動類

SimpleAdmin.Web.Core->WebApi介面層

Api介面層,存放web應用所需要用到的代碼,如組件,控制器,中間件,過濾器等。

│  Startup.cs  --> 啟動類
│  Web.Development.json  --> 開發環境配置
│  Web.Production.json  -->  生產環境配置
├─Components  --> 存放Web組件
├─Controllers --> 存放控制器
├─Filter  --> 過濾器
├─Handlers  -->  處理器
└─Logging  -->  操作日誌功能
└─Options  -->  配置文件轉實體選項類

3.4.2 後臺服務

SimpleAdmin.Background->後臺服務層

後臺服務層,作為定時任務,MQTT或其他服務載體常駐於後臺,不依賴於Web,不會因web服務升級而停止。這樣做的好處就是不會被iis記憶體回收,也不會因為web服務升級而停止工作。

│  Background.Development.json  --> 開發環境配置
│  Background.Production.json  --> 生產環境配置
│  MqttWorker.cs  --> mqtt後臺任務
│  Program.cs  -->  啟動類
├─Dto  -->  數據轉換類

四、總結

SimpleAdmin2.0的架構在1.0的基礎上進行了很大的調整,回頭再看1.0的代碼確實有點屎山那味了,還好在1.0完成之後並沒有急著開發新的功能而是重新梳理代碼邏輯,優化架構,為以後的新功能開發打好基礎,這對我自己來說也是一種進步。在日常工作中也一樣,如果你回頭看幾個月之前寫的代碼發現可以以更好的方式實現時,說明你的代碼水平已經進步了。或許在不久的將來,2.0的架構設計也會被推翻重新設計也說不定

您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 配置文件 # 1. 複製my-default.ini文件 # 2. 命名為my.ini # 3. 修改完配置文件只會,一定別忘重啟服務端 存儲引擎(面試用) # 理論部分 '''存儲引擎其實就是資料庫存儲數據的方式!!!''' '''你們這個階段,最好自己寫一寫,後面熟悉了在複製''' # MySQ ...
  • kubeadm安裝kubernetes kubeadm 是官方社區推出的一個用於快速部署 kubernetes 集群的工具。 這個工具能通過兩條指令完成一個 kubernetes 集群的部署: $ kubeadm init 創建一個master節點 $ kubeadm join 將一個 Node 節 ...
  • 俗話說的好:技能學了~就要用在自己喜歡得東西上!! 這我不得聽個話~我喜歡小姐姐,跳舞的小姐姐 這不得用python把小姐姐爬下來~嘿嘿嘿 採集網站 本期目標來自虎牙舞蹈區 開發環境 Python 3.8 Pycharm 模塊 requests re 基本流程 數據來源分析 確定採集內容是什麼? ( ...
  • 作者:袁首京 原創文章,轉載時請保留此聲明,並給出原文連接。 草堂南澗邊,有客嘯雲煙。 掃葉林風後,拾薪山雨前。 野橋通竹徑,流水入芝田。 琴月相親夜,更深戀不眠。 話說周世宗顯德年間,有位老先生,性情疏野,不以榮宦為意。一生遇見了很多人、經歷了許多事。可惜這些事我一件也不知道、這些人我一個也不曉得 ...
  • 整理編輯:阿秀 鏈接:https://www.nowcoder.com/discuss/1096078 學弟分享 我是一個杭州雙非的本科生,2022屆畢業之後進了某銀行的科技部工作,年包 20w+。 當時想著在銀行也算是一份安穩的工作,因此選擇了給錢最多的一個,想著自己走上了金融 + 科技的賽道。 ...
  • 教程簡介 Apache Commons DBUtils入門教程 - 從基本到高級概念的簡單簡單步驟熟悉Apache Commons DBUtils,其中包括概述,環境設置,第一個應用程式,基本CRUD示例,創建,讀取,更新,刪除查詢,DBUtils對象,QueryRunner ,AsyncQuery ...
  • 前言 一、人物簡介 第一位閃亮登場,有請今後會一直教我們C語言的老師 —— 自在。 第二位上場的是和我們一起學習的小白程式猿 —— 逍遙。 二、算數運算符簡介 C語言的算數運算符,是用來完成基本的算術運算的符號。 按操作數個數可分為一元運算符(含一個操作數)和二元運算符(含兩個操作數)。 一元運算符 ...
  • abstract 由abstract關鍵字修飾的類稱為抽象類,可以將某些類共有的行為抽象出來,形成約束,提高開發效率。 //抽象類 public abstract class Action{ //抽象方法,只有方法名字,沒有方法的實現 public abstract void doSth(); } ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 QuestPDF 是一個開源 .NET 庫,用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫,它徹底改變了我們生成 PDF 文檔的方 ...
  • 項目地址 項目後端地址: https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址: ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址: http://tree ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...