Asp.Net Core 輕鬆學-被低估的過濾器

来源:https://www.cnblogs.com/viter/archive/2018/12/12/10107886.html
-Advertisement-
Play Games

過濾器，從我們開始開發 Asp.Net 應用程式開始，就一直伴隨在我們左右；Asp.Net Core 提供多種類型的過濾器，以滿足多種多樣的業務應用場景；並且在 Asp.Net Core 本身，過濾器的應用也非常廣泛；但是，在實際的業務場景中，大部分開發人員只使用到其中 1 到 2 種類型，當然，這... ...


前言

    過濾器，從我們開始開發 Asp.Net 應用程式開始，就一直伴隨在我們左右；Asp.Net Core 提供多種類型的過濾器，以滿足多種多樣的業務應用場景；並且在 Asp.Net Core 本身，過濾器的應用也非常廣泛；但是，在實際的業務場景中，大部分開發人員只使用到其中 1 到 2 種類型，當然，這其中大部分可能性是由於業務場景的適用性使然，本文嘗試簡單介紹 Asp.Net Core 中提供的各種過濾器，以及實際的應用場景，希望對您有所幫助。

1. 介紹

1.1 作用範圍

過濾器的作用範圍
每種不同的過濾器都有實際的作用範圍，有一些全局過濾器還有作用域的限制，這取決於應用開發者在定義和初始化過濾器的時候的選擇，每個過濾器本身處理任務的許可權和功能都大不相同，但是他們都有一個共同點，就是通過特性標記的方式使用，比如以下代碼，對一個 Action 使用了過濾器 CustomerActionFilter

        [CustomerActionFilter]
        public ActionResult<string> Get(int id)
        {
            return "value";
        }
1.2 過濾器的工作原理

原理解釋
過濾器一般在 Asp.Net Core MVC 管道內運行，一般在操作執行之前（befor） 或者執行之後（after） 執行，以供開發者可以選擇在不同的執行階段介入處理

1.3 過濾器類型，看下圖

類型介紹
上圖既是 Asp.Net Core 內置的各種過濾器類型，也是其執行優先順序順序，相同類型的過濾器還可以定義在某個階段執行的順序

  1. 授權過濾器 AuthorizeAttribute
  2. 資源過濾器 IResourceFilter
  3. 異常過濾器 IExceptionFilter
  4. 操作過濾器 ActionFilterAttribute
  5. 結果過濾器 IResultFilter

3. 授權過濾器

3.1 使用介紹

在請求到達的時候最先執行，優先順序最高，主要作用是提供用戶請求許可權過濾，對不滿足許可權的用戶，可以在過濾器內執行拒絕操作，俗稱“管道短路”
*註意：該過濾器只有執行之前（befor），沒有執行之後（after）的方法
通常情況下，不需要自行編寫過濾器，因為該過濾器在 Asp.Net Core 內部已經有了預設實現，我們需要做的就是配置授權策略或者實現自己的授權策略，然後由系統內置的授權過濾器調用授權策略即可
必須將該過濾器內部可能出現的異常全部處理，因為在授權過濾器之前，沒有任何組件能夠捕獲授權過濾器的異常，一旦授權管理器內部發生異常，該異常將直接輸出到結果中

3.2 應用場景

授權管理器 AuthorizeAttribute 位於 命名空間 Microsoft.AspNetCore.Authorization 內，使用方式非常簡單，查看以下代碼

    [Authorize]
    [Route("api/[controller]")]
    public class UserController : Controller
    {
        [AllowAnonymous]
        [HttpGet]
        public ActionResult<string> Get()
        {
            return "default";
        }

        [HttpPost]
        public ActionResult<string> Post()
        {
            return "default";
        }
    }

UserController 被應用了 Authorize 特性進行標記，表示對該控制器內的任意操作執行授權驗證；但是單獨對 Get 操作進行了授權通過對標記，即 AllowAnonymous ，表示允許匿名訪問
這是非常常用的做法，在授權應用中，常常需要對部分操作進行單獨的授權策略
關於授權過濾器，先介紹到這裡，下一篇單獨對授權過濾器進行演示，因為關於這塊的內容，要講的實在是太多了

4. 資源過濾器

但請求進入，通過授權過濾器後，接下來將執行資源過濾器（如果有定義），使用資源過濾器甚至可以改變綁定模型，還可以在資源過濾器中實現緩存以提高性能

4.1 資源管理器實現自介面 IResourceFilter 或者 IAsyncResourceFilter，現在我們來實現一個資源過濾器，輸出一行信息，看看執行順序

    public class CustomerResourceFilter : Attribute, IResourceFilter
    {
        public void OnResourceExecuted(ResourceExecutedContext context)
        {
            Console.WriteLine("==== OnResourceExecuted");
        }

        public void OnResourceExecuting(ResourceExecutingContext context)
        {
            Console.WriteLine("==== OnResourceExecuting");
        }
    }

4.2 對 HomeController 的操作應用該資源過濾器，看看對一個操作同時應用 CustomerActionFilter 和 CustomerResourceFilter ，他們的執行順序是什麼

    [Route("api/[controller]")]
    [ApiController]
    public class HomeController : ControllerBase
    {
        [HttpGet]
        [CustomerActionFilter]
        [CustomerResourceFilter]
        public async Task<ActionResult<IEnumerable<string>>> Get()
        {
            return new string[] { "value1", "value2" };
        }
    }

4.3 啟動程式，訪問 http://localhost:5000/api/home，輸出結果如下

可以看到，執行順序和開篇的第一張圖例一直，首先執行時資源過濾器的 OnResourceExecuting 方法，接著請求接入了 操作過濾器的 OnActionExecuting 方法，最後執行操作過濾器的 OnResultExecuting 方法，然後把請求交給資源過濾器的 OnResourceExecuted，最後返回到客戶端
所以，從執行順序可以看出，資源管理器的執行優先順序總是高於操作過濾器
資源過濾器可以應用於控制器或者操作，然後基於其執行優先順序的特點，開發員人員可以在資源過濾器中定義某些靜態資源或者緩存直接將數據返回給客戶端，並使其執行短路操作，減少後續管道請求步驟，以提高伺服器響應性能

5. 異常過濾器

在伺服器向客戶端寫入響應內容之前，如果系統引發了異常，異常過濾器可以捕獲該異常，該過濾器作用於全局範圍，這也是最常用的過濾器

5.1 創建一個異常過濾器

    public class CustomerExceptionFilter : Attribute, IExceptionFilter
    {
        public void OnException(ExceptionContext context)
        {
            Console.ForegroundColor = ConsoleColor.Red;
            Console.WriteLine("發生了異常：{0}", context.Exception.Message);
            Console.ForegroundColor = ConsoleColor.Gray;
        }
    }

5.2 將 CustomerExceptionFilter 應用到 HomeController 上

請註意，HomeController 上還同時應用了資源過濾器；現在要做到就是在資源過濾器內部拋出異常，看看 CustomerExceptionFilter 是否可以捕獲該異常

    public class CustomerResourceFilter : Attribute, IResourceFilter
    {
        public void OnResourceExecuted(ResourceExecutedContext context)
        {
            Console.WriteLine("==== OnResourceExecuted");
        }

        public void OnResourceExecuting(ResourceExecutingContext context)
        {
            Console.WriteLine("==== OnResourceExecuting");
            throw new Exception("資源管理器發生了異常");
        }
    }

5.3 運行程式，訪問 http://localhost:5000/api/home

可以看到，系統拋出了異常；但是，異常過濾器 CustomerExceptionFilter 並沒有捕獲該異常，事實證明資源過濾器的執行優先順序還是高於異常過濾器，現在我們嘗試在操作內部引發異常

    [Route("api/[controller]")]
    [ApiController]
    [CustomerResourceFilter]
    [CustomerExceptionFilter]
    public class HomeController : ControllerBase
    {
        // GET api/values
        [HttpGet]
        [CustomerActionFilter]
        public async Task<ActionResult<IEnumerable<string>>> Get()
        {
            throw new Exception("Get操作發生了異常");
            return new string[] { "value1", "value2" };
        }
    }

5.4 再次啟動程式，訪問 http://localhost:5000/api/home，控制台輸出結果如下

5.5 客戶端得到了一個友好的返回值

5.6 這是因為我們在異常過濾器內部將異常進行了出來，並通過設置 context.ExceptionHandled = true 來標記表示異常已經被處理，然後輸出友好信息

    public class CustomerExceptionFilter : Attribute, IExceptionFilter
    {
        public void OnException(ExceptionContext context)
        {
            Console.ForegroundColor = ConsoleColor.Red;
            Console.WriteLine("發生了異常：{0}", context.Exception.Message);
            Console.ForegroundColor = ConsoleColor.Gray;

            context.Result = new JsonResult(new { code = 500, message = context.Exception.Message });
            context.ExceptionHandled = true;
        }
    }

異常過濾器的應用非常簡單，你可以在其內部將異常寫入日誌，或者執行其它需要處理的邏輯

6. 操作過濾器 ActionFilterAttribute 和 結果過濾器 IResultFilter

  1. 操作過濾器：當請求進入 API 介面的時候，操作過濾器提供了一個進入之前（before）和進入之後（after）介入功能，可以使用該過濾器對進入 API 的參數和結果進行干預
  2. 結果過濾器：這個過濾器的作用和操作過濾器非常相似，主要其作用範圍是有微小區別的，結果過濾器是在操作即將返回結果到客戶端之前（before）或者之後（after）執行干預，比如你可以在返回結果之後（after）去渲染視圖

6.1 之所以將這兩個過濾器放在一起講，是因為，這兩個過濾器就像一對孿生兄弟一樣，正所謂有始有終，首先來看操作過濾器

    [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true, Inherited = true)]
    public abstract class ActionFilterAttribute : Attribute, IActionFilter, IFilterMetadata, IAsyncActionFilter, IResultFilter, IAsyncResultFilter, IOrderedFilter
    {
        protected ActionFilterAttribute();

        //
        public int Order { get; set; }

        //
        public virtual void OnActionExecuted(ActionExecutedContext context);
        //
        public virtual void OnActionExecuting(ActionExecutingContext context);
        //
        [AsyncStateMachine(typeof(<OnActionExecutionAsync>d__6))]
        public virtual Task OnActionExecutionAsync(ActionExecutingContext context, ActionExecutionDelegate next);
        //
        public virtual void OnResultExecuted(ResultExecutedContext context);
        //
        public virtual void OnResultExecuting(ResultExecutingContext context);
        //
        [AsyncStateMachine(typeof(<OnResultExecutionAsync>d__9))]
        public virtual Task OnResultExecutionAsync(ResultExecutingContext context, ResultExecutionDelegate next);
    }

操作過濾器包含 6 個基礎方法，分別是執行前（before）執行後（after），寫入結果前（before）寫入後（after）
為什麼會這樣呢，因為操作過濾器實現的介面中包含了結果過濾器的介面
根據官方的提示，如果你需要重寫 ActionFilterAttribute 的方法以處理自定義的業務邏輯，那麼 OnActionExecutionAsync 這個非同步方法不應該和 執行前（before）執行後（after）同時共存
同樣，寫入結果前（before）寫入後（after）和 OnResultExecutionAsync 也是一樣

6.2 操作過濾器包含了 寫入結果前（before）寫入後（after）的方法，這使得我們可以不用去定義結果過濾器就可以實現對寫入結果的管理

當然，最好的做法是定義結果過濾器，這有助於業務分類，且邏輯清晰明瞭，但是如果你希望可以使用非同步操作，很遺憾，結果過濾器不支持該方法

6.3 下麵來看結果過濾的定義

    public class CustomerResultFilter : Attribute, IResultFilter
    {
        public void OnResultExecuted(ResultExecutedContext context)
        {
            Console.WriteLine("OnResultExecuted");
        }

        public void OnResultExecuting(ResultExecutingContext context)
        {
            Console.WriteLine("OnResultExecuting");
        }
    }

代碼非常簡單，就是實現介面 IResultFilter
IResultFilter 的工作原理和操作過濾器的寫入結果前（before）寫入後（after）的方法執行一致，可以看到，他們兩個方法和參數名稱都是一致的，因為他們都是實現同一個介面 IResultFilter

6.4 利用結果過濾器實現對輸出結果的干預

下麵就簡單在結果過濾器內部去對已經組織好的數據進行干預，HomeController.Get 方法本應該輸出 一個數組，我們在Header 中增加一項輸出：Author=From Ron.liang

    public class CustomerResultFilter : Attribute, IResultFilter
    {
        public void OnResultExecuted(ResultExecutedContext context)
        {
            // ToDo
        }

        public void OnResultExecuting(ResultExecutingContext context)
        {
            // 干預結果
            context.HttpContext.Response.Headers.Add("Author", "From Ron.liang");
        }
    }

6.5 輸出結果

7.在過濾器中使用依賴註入

在上面介紹的各種各樣的過濾器中，有時候我們可能需要讀取程式運行環境的信息，根據不同的環境做出不同的響應內容
比如，上面的結果過濾器寫入作者信息，可能我們只希望在開發環境輸出，而在產品環境忽略

7.1 使用 GetService，以支持依賴註入

        public void OnResultExecuting(ResultExecutingContext context)
        {
            var env = (IHostingEnvironment)context.HttpContext.RequestServices.GetService(typeof(IHostingEnvironment));

            Console.ForegroundColor = ConsoleColor.Blue;
            Console.WriteLine("OnResultExecuting,{0}", env.EnvironmentName);
            Console.ForegroundColor = ConsoleColor.Gray;

            // 干預結果
            if (env.IsDevelopment())
                context.HttpContext.Response.Headers.Add("Author", "From Ron.liang");
        }

上面的從 context.HttpContext.RequestServices.GetService(typeof(IHostingEnvironment)) 獲取了環境變數，並判斷在開發環境下為響應頭添加內容

7.2 在過濾器中使用中間件

Asp.Net Core 提供了一個功能，使得我們在過濾器中可以使用中間件，實際上，這兩者的使用方式非常類似
如果你希望這麼做，可以定義一個包含 Configure(IApplicationBuilder applicationBuilder) 方法的類，在控制器或者操作中使用它

7.3 定義註冊管理管道類

    public class RegisterManagerPipeline
    {
        public void Configure(IApplicationBuilder applicationBuilder)
        {
            CookieAuthenticationOptions options = new CookieAuthenticationOptions();

            applicationBuilder.UseCors(config =>
            {
                config.AllowAnyOrigin();
            });
        }
    }

RegisterManagerPipeline 定義了一個 Configure 方法，在該方法內部執行一個跨域設置，表示允許任何來源訪問該站點；然後，我們在 UserController 中應用該管道

    [Authorize]
    [Route("api/[controller]")]
    [MiddlewareFilter(typeof(RegisterManagerPipeline))]
    public class UserController : Controller
    {
        // GET: api/<controller>
        [AllowAnonymous]
        [HttpGet]
        public ActionResult<string> Get()
        {
            return "default";
        }
    }

應用方式非常簡單，就像使用普通過濾器一樣對控制器進行特性標記即可
所不同的是，這裡使用的是 MiddlewareFilter 進行註冊 RegisterManagerPipeline
管道式過濾器的優先順序非常高，甚至比授權過濾器的優先順序還高，在使用的時候需要特別註意應用場景

8. 過濾器的執行順序

相同類型的過濾器其執行順序可以使用 Order 欄位進行指定，該值為一個 int32 類型，值越小表示優先順序越高，該值只能作用於相同類型的過濾器
比如，定義了兩個 ActionFilter ，UserNameActionFilter,UserAgeActionFilter，分別制定其 Order 欄位值為 10，5，那麼 UserAgeActionFilter 將會在調用 ，UserNameActionFilter 之前執行
但是，即使指定了 Order ，ActionFilter 的執行優先順序也不會超越授權管理器 AuthorizeAttribute，這是設計上的不同

8.1 Order 演示代碼

        [HttpPost]
        [UserNameActionFilter(Order = 10)]
        [UserAgeActionFilter(Order = 5)]
        public void Post([FromBody] UserModel value)
        {
        }

8.2 輸出結果

上圖輸出的黃色部分文字清晰的說明瞭過濾器的執行順序
顯示執行了資源過濾器，接著執行了 Order=5 的 UserAgeActionFilter ，最後執行了 Order=10 的 UserNameActionFilter 過濾器
可以看到，雖然操作過濾器設置了 Order=5，但其執行優先順序仍然不能超越授權過濾器，甚至無法超越資源過濾器

結束語

  • 本文簡單介紹了 Asp.Net Core 下系統內置的各種各樣的過濾器，分別是

    1. 授權過濾器 AuthorizeAttribute
    2. 資源過濾器 IResourceFilter
    3. 異常過濾器 IExceptionFilter
    4. 操作過濾器 ActionFilterAttribute
    5. 結果過濾器 IResultFilter
  • 還通過一些簡單說實例演示了過濾器的執行過程

  • 最後介紹瞭如何在過濾器中使用中間件，以及對過濾器的執行順序進行了詳細的演示

演示代碼下載

https://files.cnblogs.com/files/viter/Ron.FilterDemo.zip


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

-Advertisement-
Play Games
更多相關文章
  • 為什麼不能用Abort退出線程
    在使用線程時，如果線程還未結束直接退出線程很有可能會導致數據丟失。 Thread.Sleep(500);//500毫秒後結束線程 th.Abort(); 線上程啟動500毫秒後，關閉線程 WriteMessage("線程結束工作.", ConsoleColor.Yellow, ConsoleColo ...
  • 簡單的C#實體映射 AutoMapper
    AutoMapper是對象到對象的映射工具。在完成映射規則之後，AutoMapper可以將源對象轉換為目標對象。 1 public class SourceModel 2 { 3 public int ID { get; set; } 4 public string Name { get; set; ...
  • 【開發記錄】如何在B/S項目中使用中國天氣的實時天氣功能
    好久沒有更新我的博客了，正好手頭有一個比較合適的項目經驗可以分享出來，就是這個如何使用中國天氣的天氣預報功能，也正好做個項目經驗記錄。 功能需求 這個功能需求比較簡單，就是想在網頁端顯示實時天氣數據。 解決方案： 第一種：使用百度地圖的api來做，以定位為例，可以很方便的查找到用的的所在地，進而進行 ...
  • C# 發送電子郵件源碼片段
    下麵代碼內容是關於C# 發送電子郵件片段的代碼，應該對各位有所用途。 using System;using System.Web;using System.Web.Mail;public class TestSendMail{ public static void Main() { try { Ma ...
  • C#文件壓縮
    using System.IO.Compression; string TOZipPath = String.Format("~/Static/ZIP/{0}", DirName); //需要壓縮的源文件 string TOZipFilePath = String.Format("~/Static/ ...
  • C# receive 接收的字元串 對比不相等的問題
    背景： 最近寫了一個C/S架構的 C# Socket 通訊項目，服務端，客戶端弄通了之後，客戶端發送給服務端後，服務端回覆一個字元串告訴客戶端確認收到了。問題就在這。 問題： 一開始，我讓服務端回覆了一個拉阿伯數字9，客戶端通過byte（一個位元組）數組接收後轉換成UTF8的string字元串，和客戶 ...
  • 在.net Core中使用StackExchange.Redis 2.0
    StackExchange.Redis 2.0做了大量的改進包括使用了高性能的IO庫System.IO.Pipelines來提升性能以及解決Timeouts問題， 但是在.net Core2.2之前為實現布式緩存和session等引用了Microsoft.AspNetCore.DataProtect ...
  • Ocelot概述
    Ocelot是一個基於netcoreapp2.0構建，.NET Core框架下的開源Api網關項目，用於開發基於.NET微服務架構或面向服務架構系統的統一入口。 ...
一周排行
    -Advertisement-
    Play Games
  • WPF 已知問題 監聽 WMI 事件導致觸摸失效
    示例項目結構 在 Visual Studio 中創建一個 WinForms 應用程式後，項目結構如下所示： MyWinFormsApp/ │ ├───Properties/ │ └───Settings.settings │ ├───bin/ │ ├───Debug/ │ └───Release/ ...
  • [STAThread]特性
    [STAThread] 特性用於需要與 COM 組件交互的應用程式，尤其是依賴單線程模型（如 Windows Forms 應用程式）的組件。在 STA 模式下，線程擁有自己的消息迴圈，這對於處理用戶界面和某些 COM 組件是必要的。 [STAThread] static void Main(stri ...
  • UWP WinUI3 傳入 AddHandler 的 RoutedEventHandler 類型與事件所需不匹配將拋出參數異常
    在WinForm中使用全局異常捕獲處理 在WinForm應用程式中，全局異常捕獲是確保程式穩定性的關鍵。通過在Program類的Main方法中設置全局異常處理，可以有效地捕獲並處理未預見的異常，從而避免程式崩潰。 註冊全局異常事件 [STAThread] static void Main() { / ...
  • .NET 多版本 WinForm 開源控制項庫 SunnyUI
    前言 給大家推薦一款開源的 Winform 控制項庫，可以幫助我們開發更加美觀、漂亮的 WinForm 界面。 項目介紹 SunnyUI.NET 是一個基於 .NET Framework 4.0+、.NET 6、.NET 7 和 .NET 8 的 WinForm 開源控制項庫，同時也提供了工具類庫、擴展 ...
  • .net core8 使用Swagger（附當前源碼）
    說明 該文章是屬於OverallAuth2.0系列文章，每周更新一篇該系列文章（從0到1完成系統開發）。 該系統文章，我會儘量說的非常詳細，做到不管新手、老手都能看懂。 說明：OverallAuth2.0 是一個簡單、易懂、功能強大的許可權+可視化流程管理系統。 有興趣的朋友，請關註我吧(*^▽^*) ...
  • WPF 什麼時候 VisualTreeHelper.GetDescendantBounds 將返回無窮大
    一、下載安裝 1.下載git 必須先下載並安裝git，再TortoiseGit下載安裝 git安裝參考教程：https://blog.csdn.net/mukes/article/details/115693833 2.TortoiseGit下載與安裝 TortoiseGit，Git客戶端，32/6 ...
  • C# 開源教程帶你輕鬆掌握數據結構與演算法
    前言 在項目開發過程中，理解數據結構和演算法如同掌握蓋房子的秘訣。演算法不僅能幫助我們編寫高效、優質的代碼，還能解決項目中遇到的各種難題。 給大家推薦一個支持C#的開源免費、新手友好的數據結構與演算法入門教程：Hello演算法。 項目介紹 《Hello Algo》是一本開源免費、新手友好的數據結構與演算法入門 ...
  • 第22篇 生成proto文件bat腳本
    1.生成單個Proto.bat內容 @rem Copyright 2016, Google Inc. @rem All rights reserved. @rem @rem Redistribution and use in source and binary forms, with or with ...
  • 記一次 .NET某上位機視覺程式 卡死分析
    一：背景 1. 講故事 前段時間有位朋友找到我，說他的窗體程式在客戶這邊出現了卡死，讓我幫忙看下怎麼回事？dump也生成了，既然有dump了那就上 windbg 分析吧。 二：WinDbg 分析 1. 為什麼會卡死 窗體程式的卡死，入口門檻很低，後續往下分析就不一定了，不管怎麼說先用 !clrsta ...
  • 醫學DICOM文件與PACS系統進行數據傳輸
    前言 人工智慧時代，人臉識別技術已成為安全驗證、身份識別和用戶交互的關鍵工具。 給大家推薦一款.NET 開源提供了強大的人臉識別 API，工具不僅易於集成，還具備高效處理能力。 本文將介紹一款如何利用這些API，為我們的項目添加智能識別的亮點。 項目介紹 GitHub 上擁有 1.2k 星標的 C# ...
所有分類