一個簡單的ASP.NET MVC異常處理模塊

来源:http://www.cnblogs.com/4littleProgrammer/archive/2016/03/17/5284840.html
-Advertisement-
Play Games

一、前言 異常處理是每個系統必不可少的一個重要部分,它可以讓我們的程式在發生錯誤時友好地提示、記錄錯誤信息,更重要的是不破壞正常的數據和影響系統運行。異常處理應該是一個橫切點,所謂橫切點就是各個部分都會使用到它,無論是分層中的哪一個層,還是具體的哪個業務邏輯模塊,所關註的都是一樣的。所以,橫切關註點


一、前言

  異常處理是每個系統必不可少的一個重要部分,它可以讓我們的程式在發生錯誤時友好地提示、記錄錯誤信息,更重要的是不破壞正常的數據和影響系統運行。異常處理應該是一個橫切點,所謂橫切點就是各個部分都會使用到它,無論是分層中的哪一個層,還是具體的哪個業務邏輯模塊,所關註的都是一樣的。所以,橫切關註點我們會統一在一個地方進行處理。無論是MVC還是WebForm都提供了這樣實現,讓我們可以集中處理異常。

  在MVC中,在FilterConfig中,已經預設幫我們註冊了一個HandleErrorAttribute,這是一個過濾器,它繼承了FilterAttribute類和實現了IExceptionFilter介面,關於過濾器的執行過程,可以看我的上一篇文章。說到異常處理,馬上就會聯想到500錯誤頁面、記錄日誌等,HandleErrorAttribute可以輕鬆的定製錯誤頁,預設就是Error頁面;而記錄日誌我們也只需要繼承它,並替換它註冊到GlobalFilterCollection即可。關於HandleErrorAttribute很多人都知道怎麼使用了,這裡就不做介紹了。

  ok,開始進入主題!在MVC中處理異常,相信開始很多人都是繼承HandleErrorAttribute,然後重寫OnException方法,加入自己的邏輯,例如將異常信息寫入日誌文件等。當然,這並沒有任何不妥,但良好的設計應該是場景驅動的,是動態和可配置的。例如,在場景一種,我們希望ExceptionA顯示錯誤頁面A,而在場景二中,我們希望它顯示的是錯誤頁面B,這裡的場景可能是跨項目了,也可能是在同一個系統的不同模塊。另外,異常也可能是分級別的,例如ExceptionA發生時,我們只需要簡單的恢復狀態,程式可以繼續運行,ExceptionB發生時,我們希望將它記錄到文件或者系統日誌,而ExceptionC發生時,是個較嚴重的錯誤,我們希望程式發生郵件或者簡訊通知。簡單地說,不同的場景有不同的需求,而我們的程式需要更好的面對變化。當然,繼承HandleErrorAttribute也完全可以實現上面所說的,只不過這裡我不打算去擴展它,而是重新編寫一個模塊,並且可以與原有的HandleErrorAttribute共同使用。

二、設計及實現

2.1 定義配置信息

  從上面已經可以知道我們要做的事了,針對不同的異常,我們希望可以配置它的處理程式,錯誤頁等。如下一個配置:

   <!--自定義異常配置-->
  <settingException>
    <exceptions>
      <!--add優先順序高於group-->
      <add exception="Exceptions.PasswordErrorException" 
           view ="PasswordErrorView"
           handler="ExceptionHandlers.PasswordErrorExceptionHandler"/>
      <groups>
        <!--group可以配置一種異常的view和handler-->
        <group view="EmptyErrorView" handler="ExceptionHandlers.EmptyExceptionHandler">
          <add exception="Exceptions.UserNameEmptyException"/>
          <add exception="Exceptions.EmailEmptyException"/>
        </group>        
      </groups>
    </exceptions>
  </settingException>

  其中,add 節點用於增加具體的異常,它的 exception 屬性是必須的,而view表示錯誤頁,handler表示具體處理程式,如果view和handler都沒有,異常將交給預設的HandleErrorAttribute處理。而group節點用於分組,例如上面的UserNameEmptyException和EmailEmptyException對應同一個處理程式和視圖。

  程式會反射讀取這個配置信息,並創建相應的對象。我們把這個配置文件放到Web.config中,保證它可以隨時改隨時生效。

2.2 異常信息包裝對象

  這裡我們定義一個實體對象,對應上面的節點。如下:

    public class ExceptionConfig
    {
        /// <summary>
        /// 視圖
        /// </summary>
        public string View{get;set;}

        /// <summary>
        /// 異常對象
        /// </summary>
        public Exception Exception{get;set;}

        /// <summary>
        /// 異常處理程式
        /// </summary>
        public IExceptionHandler Handler{get;set;}
    }

2.3 定義Handler介面

  上面我們說到,不同異常可能需要不同處理方式。這裡我們設計一個介面如下:

    public interface IExceptionHandler
    {
        /// <summary>
        /// 異常是否處理完成
        /// </summary>
        bool HasHandled{get;set;}

        /// <summary>
        /// 處理異常
        /// </summary>
        /// <param name="ex"></param>
        void Handle(Exception ex);
    }

  各種異常處理程式只要實現該介面即可。

2.3 實現IExceptionFilter

  這是必須的。如下,實現IExceptionFilter介面,SettingExceptionProvider會根據異常對象類型從配置信息(緩存)獲取包裝對象。

    public class SettingHandleErrorFilter : IExceptionFilter
    {
        public void OnException(ExceptionContext filterContext)
        {
            if(filterContext == null)
            {
                throw new ArgumentNullException("filterContext");
            }
            ExceptionConfig config = SettingExceptionProvider.Container[filterContext.Exception.GetType()];
            if(config == null)
            {
                return;
            }
            if(config.Handler != null)
            {
                //執行Handle方法                
                config.Handler.Handle(filterContext.Exception);
                if (config.Handler.HasHandled)
                {
                    //異常已處理,不需要後續操作
                    filterContext.ExceptionHandled = true;
                    return;
                }
            }            
            //否則,如果有定製頁面,則顯示
            if(!string.IsNullOrEmpty(config.View))
            {
                //這裡還可以擴展成實現IView的視圖
                ViewResult view = new ViewResult();
                view.ViewName = config.View;
                filterContext.Result = view;
                filterContext.ExceptionHandled = true;
                return;
            }
            //否則將異常繼續傳遞
        }
    }

2.4 讀取配置文件,創建異常信息包裝對象

  這部分代碼比較多,事實上,你只要知道它是在讀取web.config的自定義配置節點即可。SettingExceptionProvider用於提供容器對象。

    public class SettingExceptionProvider
    {
        public static Dictionary<Type, ExceptionConfig> Container =
            new Dictionary<Type, ExceptionConfig>();

        static SettingExceptionProvider()
        {
            InitContainer();
        }

        //讀取配置信息,初始化容器
        private static void InitContainer()
        {
            var section = WebConfigurationManager.GetSection("settingException") as SettingExceptionSection;
            if(section == null)
            {
                return;
            }
            InitFromGroups(section.Exceptions.Groups);
            InitFromAddCollection(section.Exceptions.AddCollection);
        }

        private static void InitFromGroups(GroupCollection groups)
        {                      
            foreach (var group in groups.Cast<GroupElement>())
            {   
                ExceptionConfig config = new ExceptionConfig();
                config.View = group.View;
                config.Handler = CreateHandler(group.Handler);
                foreach(var item in group.AddCollection.Cast<AddElement>())
                {
                    Exception ex = CreateException(item.Exception);
                    config.Exception = ex;
                    Container[ex.GetType()] = config;
                }
            }
        }

        private static void InitFromAddCollection(AddCollection collection)
        {
            foreach(var item in collection.Cast<AddElement>())
            {
                ExceptionConfig config = new ExceptionConfig();
                config.View = item.View;
                config.Handler = CreateHandler(item.Handler);
                config.Exception = CreateException(item.Exception);
                Container[config.Exception.GetType()] = config;
            }
        }

        //根據完全限定名創建IExceptionHandler對象
        private static IExceptionHandler CreateHandler(string fullName)             
        {
            if(string.IsNullOrEmpty(fullName))
            {
                return null;
            }
            Type type = Type.GetType(fullName);
            return Activator.CreateInstance(type) as IExceptionHandler;
        }

        //根據完全限定名創建Exception對象
        private static Exception CreateException(string fullName)
        {
            if(string.IsNullOrEmpty(fullName))
            {
                return null;
            }
            Type type = Type.GetType(fullName);
            return Activator.CreateInstance(type) as Exception;
        }
    }

  以下是各個配置節點的信息:

  settingExceptions節點:

    /// <summary>
    /// settingExceptions節點
    /// </summary>
    public class SettingExceptionSection : ConfigurationSection 
    {
        [ConfigurationProperty("exceptions",IsRequired=true)]
        public ExceptionsElement Exceptions
        {
            get
            {
                return (ExceptionsElement)base["exceptions"];
            }
        }
    }

  exceptions節點:

    /// <summary>
    /// exceptions節點
    /// </summary>
    public class ExceptionsElement : ConfigurationElement 
    {
        private static readonly ConfigurationProperty _addProperty =
            new ConfigurationProperty("", typeof(AddCollection), null, ConfigurationPropertyOptions.IsDefaultCollection);

        [ConfigurationProperty("", IsDefaultCollection = true)]
        public AddCollection AddCollection
        {
            get
            {
                return (AddCollection)base[_addProperty];
            }
        }

        [ConfigurationProperty("groups")]
        public GroupCollection Groups
        {
            get
            {
                return (GroupCollection)base["groups"];
            }
        }
    }

  Group節點集:

    /// <summary>
    /// group節點集
    /// </summary>
    [ConfigurationCollection(typeof(GroupElement),AddItemName="group")]
    public class GroupCollection : ConfigurationElementCollection
    {       
        /*override*/

        protected override ConfigurationElement CreateNewElement()
        {
            return new GroupElement();
        }

        protected override object GetElementKey(ConfigurationElement element)
        {
            return element;
        }
    }

  group節點:

    /// <summary>
    /// group節點
    /// </summary>
    public class GroupElement : ConfigurationElement
    {
        private static readonly ConfigurationProperty _addProperty =
            new ConfigurationProperty("", typeof(AddCollection), null, ConfigurationPropertyOptions.IsDefaultCollection);

        [ConfigurationProperty("view")]
        public string View
        {
            get
            {
                return base["view"].ToString();
            }
        }

        [ConfigurationProperty("handler")]
        public string Handler
        {
            get
            {
                return base["handler"].ToString();
            }
        }

        [ConfigurationProperty("", IsDefaultCollection = true)]
        public AddCollection AddCollection
        {
            get
            {
                return (AddCollection)base[_addProperty];
            }
        }        
    }

  add節點集:

    /// <summary>
    /// add節點集
    /// </summary>    
    public class AddCollection : ConfigurationElementCollection 
    {          
        /*override*/

        protected override ConfigurationElement CreateNewElement()
        {
            return new AddElement();
        }

        protected override object GetElementKey(ConfigurationElement element)
        {
            return element;
        }
    }

  add節點:

    /// <summary>
    /// add節點
    /// </summary>
    public class AddElement : ConfigurationElement
    {
        [ConfigurationProperty("view")]
        public string View
        {
            get
            {
                return base["view"] as string;
            }
        }

        [ConfigurationProperty("handler")]
        public string Handler
        {
            get
            {
                return base["handler"] as string;
            }
        }

        [ConfigurationProperty("exception", IsRequired = true)]
        public string Exception
        {
            get
            {
                return base["exception"] as string;
            }
        }
    }

 

三、測試

  ok,下麵測試一下,首先要在FilterConfig的RegisterGlobalFilters方法中在,HandlerErrorAttribute前註冊我們的過濾器:

  filters.Add(new SettingHandleErrorFilter())。

3.1 準備異常對象

   準備幾個簡單的異常對象:

 public class PasswordErrorException : Exception{}
 public class UserNameEmptyException : Exception{} 
 public class EmailEmptyException : Exception{}

3.2 準備Handler

  針對上面的異常,我們準備兩個Handler,一個處理密碼錯誤異常,一個處理空異常。這裡沒有實際處理代碼,具體怎麼處理,應該結合具體業務了。如:

    public class PasswordErrorExceptionHandler : IExceptionHandler
    {
        public bool HasHandled{get;set;}
        
        public void Handle(Exception ex)
        {
            //具體處理邏輯...
        }
    }

    public class EmptyExceptionHandler : IExceptionHandler
    {
        public bool HasHandled { get; set; }

        public void Handle(Exception ex)
        {
            //具體處理邏輯...
        }
    }

3.3 拋出異常

  按照上面的配置,我們在Action中手動throw異常

        public ActionResult Index()
        {
            throw new PasswordErrorException();
        }
        public ActionResult Index2()
        {
            throw new UserNameEmptyException();
        }
        public ActionResult Index3()
        {
            throw new EmailEmptyException();
        }

  可以看到,相應的Handler會被執行,瀏覽器也會出現我們配置的錯誤頁面。

四、總結

  事實上這隻是一個比較簡單的例子,所以我稱它為簡單的模塊,而是用框架、庫之類的詞。當然我們可以根據實際情況對它進行擴展和優化。微軟企業庫視乎也集成這樣的模塊,有興趣的朋友可以瞭解一下。

  源碼下載


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

-Advertisement-
Play Games
更多相關文章
  • 裝載系統的時候只開啟了22埠。結果再裝完Nginx+php+mysql 後不能訪問網站。 iptables -L -n 查看防火牆設置發現沒開啟80埠 由於Linux防火牆預設是關閉的。可以用兩種方式,一個是關閉防火牆,另一個就是讓防火牆開放這個埠。 關閉防火牆命名: service ipta
  • 二、Makefile(下)01.make常用內嵌函數函數調用  $(function arguments)$(wildcard PATTERN)  當前目錄下匹配模式的文件  例如:src=$(wildcard *.c)$(patsubst PATTERN,REPLACEMENT,TEXT)  模式
  • 鑒於前段時間系統出了點問題,然後直接將盤抹了,來個徹底乾凈的系統重裝。這裡敲下過程。(網路恢復太慢了,我整整一個晚上竟然沒down下來,惱怒了,直接U盤裝) First,系統盤製作: 1.首先需要有:一個不小於8G的U盤,運行OS X 系統的電腦(U盤最好先使用磁碟工具進行抹盤,格式選擇OS 擴展(
  • 二、makefile(上)01.make工具  利用make工具可以自動完成編譯工作。這些工作包括:如果修改了某幾個源文件,則只重裝新編譯這幾個源文件;如果某個頭文件被修改了,則重新編譯所有包含該頭文件的源文件。利用這個自動編譯可大大簡化開發工作,避免不必要的重新編譯。  make工具通過一個稱為M
  • 轉自:http://engrmosaic.uncc.edu/mosaic-anywhere/remote-desktop-file-format The new Terminal Services client (version 2600 and newer, 5.1.2600.x) introdu
  • Nginx 訪問日誌輪詢切割腳本         配置www.conf     配置bbs.conf     配置blog.conf 測試     配置定時任務使得每天0點整執行腳本    
  • 初學者對 : Controller where T : class,new() 不理解 ,我是初學者的時候也一樣不理解,在此做個簡單的解釋:這是類型參數約束,.NET支持的類型參數約束有以下五種: where T : struct | T必須是一個結構類型 where T : class | T必須
  • 異常處理彙總-前端系列 http://www.cnblogs.com/dunitian/p/4523015.html 舉個例子 重點:display:flex (參考:http://www.360doc.com/content/14/0811/01/2633_400926000.shtml) 效果
一周排行
    -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.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...