主頁 > .NET開發 > [.net] 關于Exception的幾點思考和在專案中的使用(二)

[.net] 關于Exception的幾點思考和在專案中的使用(二)

2021-04-11 06:03:37 .NET開發

本文鏈接: https://www.cnblogs.com/hubaijia/p/about-exceptions-2.html

系列文章:
  • 關于Exception的幾點思考和在專案中的使用(一)
  • 關于Exception的幾點思考和在專案中的使用(二)

本文目錄

目錄
  • 與Exception相關的檔案結構
    • ExceptionFactory 和 Ensure
    • Exception的可見性
  • 結語

與Exception相關的檔案結構

在上一篇我們提到了 集中化管理 Exceptions,這樣所有的Exception的產生都在同一檔案中,便于我們后期的Review、重構,不會看到漫天飛舞的throw new Exceptions(...),也盡量避免了同一種類的Exception擁有著不同的Message,記錄著不同的引數資訊,

此外在上一篇中我們還提出了細化Exception的方式,即按照 型別、ErrorCode、Cause 以此細化,

舉例來說,專案中會形成如下的檔案結構:(實體代碼請訪問 Github)

cddo1s.png

綠框里的就是Exception相關的代碼檔案,其中XXX_ErrorCodes, XXX_ExceptionFactory等型別應該標記為internal,即只是類別庫內部可見,

在上述檔案結構中,我簡要的模擬了一個專案的分層結構,不一定都是這樣,但大致如下:

  • Common 是專案公共類別庫,放著各種輔助代碼、框架代碼等等,代表著你專案的基礎部分;
  • Dal 放著連接各種Store(MySql、Redis等等)的代碼,即放DataAccessObject的;
  • Repo 屏蔽各種細節,直接為各種Service提供服務;
  • Services 表示你的各項業務模塊,當然你的專案結構中有不同的叫法和含義,大家各自知道就行;
  • Application 具體的應用,提供Endpoint,開放Service的各項功能,面向呼叫者,

為什么要詳細描述一個專案分層結構,因為一會兒我們需要解決一個問題,就是Exception的可見性,

先賣個關子,一會兒再說,在此之前,先解決一個小問題,

ExceptionFactory 和 Ensure

將Exception集中化管理,除了我們用的ExceptionFactory,還有一種寫法我們經常見到,那就是Ensure,或者EnsureXXX,

參閱.net core的源代碼,我們會看到非常多的Ensure類,源代碼連接 https://source.dot.net/#q=Ensure,

我們經常把 復雜 或者 重復 出現的判斷寫到Ensure中,Ensure的中文意思“確保”正是這個含義,

示例代碼如下:

// Ensure 寫法
internal static class Ensure
{
    public static void NickNameNotExisted(string newNickName)
    {
        bool alreadyExisted = true;

        // Some Check

        if(alreadyExisted)
        {
            throw IdentityExceptionFactory.NickNameExisted();
        }
    }

    public static T NotNull<T>([NotNull]T? obj, string paramName) where T : class
    {
        if (obj == null)
        {
            throw new ArgumentNullException(paramName);
        }
        return obj;
    }
}

我們觀察到,Ensure類中的Exception也是由ExceptionFactory生成的(當然那些基礎Exception型別,比如ArgumentNullException就直接new 了),

Ensure類是對判斷(if陳述句等)的抽象,而ExceptionFactory只是Exception的生成器,

當然,當我們不直接在現場拋出例外,而是呼叫Ensure類方法拋出例外,會稍微有一些不同:

  • Stack Trace不同,第一行永遠是Ensure的方法
    • 沒有什么大不了,因為Stack Trace會詳細記錄后續的呼叫;
  • 代碼邏輯上不如直接寫 throw 那么直白
    • 明確使用Ensure這一稱呼,寫到代碼規則里,團隊內統一,一看到Ensure就知道可能要拋出例外,
  • 注意CodeAnalysis 和 NRT(null reference types)
    • 如果專案開啟上面兩項功能,需要添加相應的Attribute,比如,上面代碼的NotNull方法,否則在Ensure后,CodeAnalysis還會提醒你CS8602等錯誤.

Exception的可見性

舉例來說,就是 DalException 要不要對Service可見,還是只對Repo可見?

其實可見或者不可見都沒有明顯的錯誤,但總的來說,

  • 隱藏并包裝下層的Exception,對呼叫者更友好些,
    • 比如在WebApplication專案中,我們就可以只面對來自Service的Exception,不用去知道Dal或者Repo的細節,
    • 而來自IdentityService的例外,只有IdentityException一種(不算ArgumentNull那些基本Exception)
  • 隱藏并包裝下層的Exception,可以在每一層加入更多有用的資訊
  • 如果是呼叫第三方類別庫,盡量隱藏和包裝成自己的例外型別,比如你在Dal中呼叫MySqlConnector類別庫,那么將MySqlException放到DalException的innerException中去,讓程式的其他部分不需要面對一個可能更換掉的外來者,

結語

以上寫的都比較具體,所以如果與大家的實際使用不同,請多多交流,共同進步,我也會補充到文章里來,

下一篇,我會講講關于 捕捉Exception的幾點實際經驗,比如全域例外處理以及異步編程中的例外,

謝謝閱讀,

轉載請註明出處,本文鏈接:https://www.uj5u.com/net/274649.html

標籤:.NET技术

上一篇:URL地址記住不咋辦,代碼生成走一波。

下一篇:請教一個排列演算法

標籤雲
其他(157675) Python(38076) JavaScript(25376) Java(17977) C(15215) 區塊鏈(8255) C#(7972) AI(7469) 爪哇(7425) MySQL(7132) html(6777) 基礎類(6313) sql(6102) 熊猫(6058) PHP(5869) 数组(5741) R(5409) Linux(5327) 反应(5209) 腳本語言(PerlPython)(5129) 非技術區(4971) Android(4554) 数据框(4311) css(4259) 节点.js(4032) C語言(3288) json(3245) 列表(3129) 扑(3119) C++語言(3117) 安卓(2998) 打字稿(2995) VBA(2789) Java相關(2746) 疑難問題(2699) 细绳(2522) 單片機工控(2479) iOS(2429) ASP.NET(2402) MongoDB(2323) 麻木的(2285) 正则表达式(2254) 字典(2211) 循环(2198) 迅速(2185) 擅长(2169) 镖(2155) 功能(1967) .NET技术(1958) Web開發(1951) python-3.x(1918) HtmlCss(1915) 弹簧靴(1913) C++(1909) xml(1889) PostgreSQL(1872) .NETCore(1853) 谷歌表格(1846) Unity3D(1843) for循环(1842)

熱門瀏覽
  • WebAPI簡介

    Web體系結構: 有三個核心:資源(resource),URL(統一資源識別符號)和表示 他們的關系是這樣的:一個資源由一個URL進行標識,HTTP客戶端使用URL定位資源,表示是從資源回傳資料,媒體型別是資源回傳的資料格式。 接下來我們說下HTTP. HTTP協議的系統是一種無狀態的方式,使用請求/ ......

    uj5u.com 2020-09-09 22:07:47 more
  • asp.net core 3.1 入口:Program.cs中的Main函式

    本文分析Program.cs 中Main()函式中代碼的運行順序分析asp.net core程式的啟動,重點不是剖析原始碼,而是理清程式開始時執行的順序。到呼叫了哪些實體,哪些法方。asp.net core 3.1 的程式入口在專案Program.cs檔案里,如下。ususing System; us ......

    uj5u.com 2020-09-09 22:07:49 more
  • asp.net網站作為websocket服務端的應用該如何寫

    最近被websocket的一個問題困擾了很久,有一個需求是在web網站中搭建websocket服務。客戶端通過網頁與服務器建立連接,然后服務器根據ip給客戶端網頁發送資訊。 其實,這個需求并不難,只是剛開始對websocket的內容不太了解。上網搜索了一下,有通過asp.net core 實作的、有 ......

    uj5u.com 2020-09-09 22:08:02 more
  • ASP.NET 開源匯入匯出庫Magicodes.IE Docker中使用

    Magicodes.IE在Docker中使用 更新歷史 2019.02.13 【Nuget】版本更新到2.0.2 【匯入】修復單列匯入的Bug,單元測驗“OneColumnImporter_Test”。問題見(https://github.com/dotnetcore/Magicodes.IE/is ......

    uj5u.com 2020-09-09 22:08:05 more
  • 在webform中使用ajax

    如果你用過Asp.net webform, 說明你也算是.NET 開發的老兵了。WEBform應該是2011 2013左右,當時還用visual studio 2005、 visual studio 2008。后來基本都用的是MVC。 如果是新開發的專案,估計沒人會用webform技術。但是有些舊版 ......

    uj5u.com 2020-09-09 22:08:50 more
  • iis添加asp.net網站,訪問提示:由于擴展配置問題而無法提供您請求的

    今天在iis服務器配置asp.net網站,遇到一個問題,記錄一下: 問題:由于擴展配置問題而無法提供您請求的頁面。如果該頁面是腳本,請添加處理程式。如果應下載檔案,請添加 MIME 映射。 WindowServer2012服務器,添加角色安裝完.netframework和iis之后,運行aspx頁面 ......

    uj5u.com 2020-09-09 22:10:00 more
  • WebAPI-處理架構

    帶著問題去思考,大家好! 問題1:HTTP請求和回傳相應的HTTP回應資訊之間發生了什么? 1:首先是最底層,托管層,位于WebAPI和底層HTTP堆疊之間 2:其次是 訊息處理程式管道層,這里比如日志和快取。OWIN的參考是將訊息處理程式管道的一些功能下移到堆疊下端的OWIN中間件了。 3:控制器處理 ......

    uj5u.com 2020-09-09 22:11:13 more
  • 微信門戶開發框架-使用指導說明書

    微信門戶應用管理系統,采用基于 MVC + Bootstrap + Ajax + Enterprise Library的技術路線,界面層采用Boostrap + Metronic組合的前端框架,資料訪問層支持Oracle、SQLServer、MySQL、PostgreSQL等資料庫。框架以MVC5,... ......

    uj5u.com 2020-09-09 22:15:18 more
  • WebAPI-HTTP編程模型

    帶著問題去思考,大家好!它是什么?它包含什么?它能干什么? 訊息 HTTP編程模型的核心就是訊息抽象,表示為:HttPRequestMessage,HttpResponseMessage.用于客戶端和服務端之間交換請求和回應訊息。 HttpMethod類包含了一組靜態屬性: private stat ......

    uj5u.com 2020-09-09 22:15:23 more
  • 部署WebApi隨筆

    一、跨域 NuGet參考Microsoft.AspNet.WebApi.Cors WebApiConfig.cs中配置: // Web API 配置和服務 config.EnableCors(new EnableCorsAttribute("*", "*", "*")); 二、清除默認回傳XML格式 ......

    uj5u.com 2020-09-09 22:15:48 more
最新发布
  • C#多執行緒學習(二) 如何操縱一個執行緒

    <a href="https://www.cnblogs.com/x-zhi/" target="_blank"><img width="48" height="48" class="pfs" src="https://pic.cnblogs.com/face/2943582/20220801082530.png" alt="" /></...

    uj5u.com 2023-04-19 09:17:20 more
  • C#多執行緒學習(二) 如何操縱一個執行緒

    C#多執行緒學習(二) 如何操縱一個執行緒 執行緒學習第一篇:C#多執行緒學習(一) 多執行緒的相關概念 下面我們就動手來創建一個執行緒,使用Thread類創建執行緒時,只需提供執行緒入口即可。(執行緒入口使程式知道該讓這個執行緒干什么事) 在C#中,執行緒入口是通過ThreadStart代理(delegate)來提供的 ......

    uj5u.com 2023-04-19 09:16:49 more
  • 記一次 .NET某醫療器械清洗系統 卡死分析

    <a href="https://www.cnblogs.com/huangxincheng/" target="_blank"><img width="48" height="48" class="pfs" src="https://pic.cnblogs.com/face/214741/20200614104537.png" alt="" /&g...

    uj5u.com 2023-04-18 08:39:04 more
  • 記一次 .NET某醫療器械清洗系統 卡死分析

    一:背景 1. 講故事 前段時間協助訓練營里的一位朋友分析了一個程式卡死的問題,回過頭來看這個案例比較經典,這篇稍微整理一下供后來者少踩坑吧。 二:WinDbg 分析 1. 為什么會卡死 因為是表單程式,理所當然就是看主執行緒此時正在做什么? 可以用 ~0s ; k 看一下便知。 0:000> k # ......

    uj5u.com 2023-04-18 08:33:10 more
  • SignalR, No Connection with that ID,IIS

    <a href="https://www.cnblogs.com/smartstar/" target="_blank"><img width="48" height="48" class="pfs" src="https://pic.cnblogs.com/face/u36196.jpg" alt="" /></a>...

    uj5u.com 2023-03-30 17:21:52 more
  • 一次對pool的誤用導致的.net頻繁gc的診斷分析

    <a href="https://www.cnblogs.com/dotnet-diagnostic/" target="_blank"><img width="48" height="48" class="pfs" src="https://pic.cnblogs.com/face/3115652/20230225090434.png" alt=""...

    uj5u.com 2023-03-28 10:15:33 more
  • 一次對pool的誤用導致的.net頻繁gc的診斷分析

    <a href="https://www.cnblogs.com/dotnet-diagnostic/" target="_blank"><img width="48" height="48" class="pfs" src="https://pic.cnblogs.com/face/3115652/20230225090434.png" alt=""...

    uj5u.com 2023-03-28 10:13:31 more
  • C#遍歷指定檔案夾中所有檔案的3種方法

    <a href="https://www.cnblogs.com/xbhp/" target="_blank"><img width="48" height="48" class="pfs" src="https://pic.cnblogs.com/face/957602/20230310105611.png" alt="" /></a&...

    uj5u.com 2023-03-27 14:46:55 more
  • C#/VB.NET:如何將PDF轉為PDF/A

    <a href="https://www.cnblogs.com/Carina-baby/" target="_blank"><img width="48" height="48" class="pfs" src="https://pic.cnblogs.com/face/2859233/20220427162558.png" alt="" />...

    uj5u.com 2023-03-27 14:46:35 more
  • 武裝你的WEBAPI-OData聚合查詢

    <a href="https://www.cnblogs.com/podolski/" target="_blank"><img width="48" height="48" class="pfs" src="https://pic.cnblogs.com/face/616093/20140323000327.png" alt="" /><...

    uj5u.com 2023-03-27 14:46:16 more