ASP.NET Core - 在ActionFilter中使用依賴註入

上次ActionFilter引發的一個EF異常,本質上是對Core版本的ActionFilter的知識掌握不夠牢固造成的，所以花了點時間仔細閱讀了微軟的官方文檔。發現除了IActionFilter、IAsyncActionFilter的問題，還有一個就是依賴註入在ActionFilter上的使用也是需要註意的地方。
當我們的ActionFilter需要使用某個Service的時候，我們一般會通過構造函數註入。
演示一下，首先自定義一個ActionFilter，通過構造函數註入IMyService：

    public interface IMyService
    {
        string GetServiceName(); 
    }

    public class MyService : IMyService
    {
        public MyService ()
        {
            Console.WriteLine("Service {0} created .", GetServiceName());
        }

        public string GetServiceName()
        {
            return "MyService";
        }
    }

    public class FilterInjectAttribute: ActionFilterAttribute
    {
        public FilterInjectAttribute(IMyService myService)
        {
            if (myService == null)
            {
                throw new ArgumentNullException("myService");
            }

            Console.WriteLine("Service {0} was injected .", myService.GetServiceName());
        }
    }

但是我們在使用Attribute的時候VS直接給出紅色提示，需要傳入構造函數的參數，否則無法編譯過去。

當然我們可以直接new一個MyService來當做參數，但是很顯然這樣就失去了註入的那些好處了。

在ActionFilter中使用依賴註入

在ASP.NET Core的ActionFilter中使用依賴註入主要有兩種方式：

1. ServiceFilterAttribute
2. TypeFilterAttribute

ServiceFilterAttribute

使用ServiceFilterAttribute可以使你的ActionFilter完成依賴註入。其實就是把你要用的ActionFilter本身註冊為一個Service註冊到DI容器中。通過ServiceFilter從容器中檢索你的ActionFilter，並且註入到需要的地方。所以第一步就是要註冊你的ActionFilter:

        public void ConfigureServices(IServiceCollection services)
        {
            services.AddScoped<IMyService,MyService>();
            services.AddScoped(typeof(FilterInjectAttribute));

            services.AddControllers();
            services.AddRazorPages();
        }

然後新建一個Controller，在Action上使用ServiceFilter：

        [ServiceFilter(typeof(FilterInjectAttribute))]
        public string DI()
        {
            Console.WriteLine("HomeController method DI running .");

            return "DI";
        }

運行一下，在瀏覽器里訪問下對應的path，可以看到MyService已經註入到FilterInjectAttribute中：

ServiceFilterAttribute的IsReusable屬性:

ServiceFilter有一個屬性叫IsReusable。從字面意思也很好理解，就是是否可重用的意思。顯而易見如果這個屬性設置為True，那麼多個請求就會復用這個ActionFilter，這就有點像是單例的意思了。

        [ServiceFilter(typeof(FilterInjectAttribute), IsReusable = true)]
        public string DI()
        {
            Console.WriteLine("HomeController method DI running .");

            return "DI";
        }

運行一下，多次在瀏覽器中訪問對應的action的path，可以看到FilterInjectAttribute的構造函數只會執行一次。

這裡有一個重要提示， ASP.NET Core runtime 並不保證這個filter是真正的單例。所以不要試圖使用這個屬性來實現單例，並且業務系統依賴這個單例。

TypeFilterAttribute

使用TypeFilterAttribute也可以使你的ActionFilter完成依賴註入。它跟ServiceFilterAttribute差不多，但是使用TypeFilterAttribute註入的ActionFilter並不從DI容器中查找，而是直接通過Microsoft.Extensions.DependencyInjection.ObjectFactory來實例化對象。所以我們的FilterInjectAttribute不需要提前註冊到DI容器中。
首先註釋掉FilterInjectAttribute的註冊代碼:

        public void ConfigureServices(IServiceCollection services)
        {
            services.AddScoped<IMyService,MyService>();

            //services.AddScoped(typeof(FilterInjectAttribute));

            services.AddControllers();
            services.AddRazorPages();
        }

改用TypeFilterAttribute：

        [TypeFilter(typeof(FilterInjectAttribute))]
        public string DI()
        {
            Console.WriteLine("HomeController method DI running .");

            return "DI";
        }

運行一下，在瀏覽器里訪問下對應的path，可以看到MyService已經註入到FilterInjectAttribute中：

TypeFilterAttribute的IsReusable屬性:

跟上面的ServiceFilter一樣，ASP.NET Core runtime 並不保證這個filter是真正的單例，這裡就不多啰嗦了。

TypeFilterAttribute的Arguments屬性:

Arguments參數是TypeFilterAttribute跟ServiceFilterAttribute的一個重要區別，ServiceFilterAttribute並沒有這屬性。Arguments類型為object數組。通過TypeFilterAttribute實例化的ActionFilter，如果它的構造器中的參數類型在DI容器中找不到，會繼續在Arguments參數列表裡按順序獲取。
改一下FilterInjectAttribute構造器多加入2個參數，並且保證這2個參數無法從DI中取到：

    public class FilterInjectAttribute: ActionFilterAttribute
    {
        public FilterInjectAttribute(string arg1, IMyService myService, string arg2)
        {
            if (myService == null)
            {
                throw new ArgumentNullException("myService");
            }

            Console.WriteLine("Service {0} was injected .", myService.GetServiceName());
            Console.WriteLine("arg1 is {0} .", arg1);
            Console.WriteLine("arg2 is {0} .", arg2);

            Console.WriteLine("FilterInjectAttribute was created .");
        }
    }

在使用的時候傳入兩個參數：

        [TypeFilter(typeof(FilterInjectAttribute), Arguments  = new object[] { "HAHA", "HOHO" })]
        public string DI()
        {
            Console.WriteLine("HomeController method DI running .");

            return "DI";
        }

運行一下看到兩個參數被傳入了FilterInjectAttribute的構造器：

總結

1. ActionFilterAttribute的依賴註入可以通過ServiceFilterAttribute，TypeFilterAttribute來實現
2. ServiceFilterAttribute是通過DI容器來管理ActionFilterAttribute；TypeFilterAttribute則是通過一個工廠直接實例化，所以使用前不需要註冊到DI容器中。
3. IsReusable屬性可以實現類似單例的功能，但是運行時並不保證唯一單例。
4. TypeFilterAttribute的Arguments屬性可以作為參數列表。當實例化ActionFilterAttribute的時候如果構造器參數類型沒有在DI容器中註冊那麼會嘗試從Arguments列表中取。