上次ActionFilter引发的一个EF异常,本质上是对Core版本的ActionFilter的知识掌握不够牢固造成的,所以花了点时间仔细阅读了微软的官方文档。发现除了IActionFilter、IAsyncActionFilter的问题,还有一个就是依赖注入在ActionFilter上的使用也是需要注意的地方。 当我们的ActionFilter需要使用某个Service的时候,我们一般会通过构造函数注入。 演示一下,首先自定义一个ActionFilter,通过构造函数注入IMyService:
  1. public interface IMyService
  2. {
  3. string GetServiceName();
  4. }
  5. public class MyService:IMyService
  6. {
  7. public MyService()
  8. {
  9. Console.WriteLine("Service {0} created .",GetServiceName());
  10. }
  11. public string GetServiceName()
  12. {
  13. return"MyService";
  14. }
  15. }
  16. public class FilterInjectAttribute:ActionFilterAttribute
  17. {
  18. public FilterInjectAttribute(IMyService myService)
  19. {
  20. if(myService ==null)
  21. {
  22. throw new ArgumentNullException("myService");
  23. }
  24. Console.WriteLine("Service {0} was injected .", myService.GetServiceName());
  25. }
  26. }
但是我们在使用Attribute的时候VS直接给出红色提示,需要传入构造函数的参数,否则无法编译过去。

.NET Core--ActionFilter中使用依赖注入 - 图1
当然我们可以直接new一个MyService来当做参数,但是很显然这样就失去了注入的那些好处了。

一、在ActionFilter中使用依赖注入

ASP.NET Core的ActionFilter中使用依赖注入主要有两种方式:
  1. ServiceFilterAttribute
  2. TypeFilterAttribute

1. ServiceFilterAttribute

使用ServiceFilterAttribute可以使你的ActionFilter完成依赖注入。其实就是把你要用的ActionFilter本身注册为一个Service注册到DI容器中。通过ServiceFilter从容器中检索你的ActionFilter,并且注入到需要的地方。所以第一步就是要注册你的ActionFilter:
  1. public void ConfigureServices(IServiceCollection services)
  2. {
  3. services.AddScoped<IMyService,MyService>();
  4. services.AddScoped(typeof(FilterInjectAttribute));
  5. services.AddControllers();
  6. services.AddRazorPages();
  7. }
然后新建一个Controller,在Action上使用ServiceFilter:
  1. [ServiceFilter(typeof(FilterInjectAttribute))]
  2. publicstring DI()
  3. {
  4. Console.WriteLine("HomeController method DI running .");
  5. return "DI";
  6. }
运行一下,在浏览器里访问下对应的path,可以看到MyService已经注入到FilterInjectAttribute中:

.NET Core--ActionFilter中使用依赖注入 - 图2

2. ServiceFilterAttribute的IsReusable属性:

ServiceFilter有一个属性叫IsReusable。从字面意思也很好理解,就是是否可重用的意思。显而易见如果这个属性设置为True,那么多个请求就会复用这个ActionFilter,这就有点像是单例的意思了。
  1. [ServiceFilter(typeof(FilterInjectAttribute),IsReusable=true)]
  2. public string DI()
  3. {
  4. Console.WriteLine("HomeController method DI running .");
  5. return"DI";
  6. }
运行一下,多次在浏览器中访问对应的action的path,可以看到FilterInjectAttribute的构造函数只会执行一次。

.NET Core--ActionFilter中使用依赖注入 - 图3
这里有一个重要提示, ASP.NET Core runtime 并不保证这个filter是真正的单例。所以不要试图使用这个属性来实现单例,并且业务系统依赖这个单例。

3. TypeFilterAttribute

使用TypeFilterAttribute也可以使你的ActionFilter完成依赖注入。它跟ServiceFilterAttribute差不多,但是使用TypeFilterAttribute注入的ActionFilter并不从DI容器中查找,而是直接通过Microsoft.Extensions.DependencyInjection.ObjectFactory来实例化对象。所以我们的FilterInjectAttribute不需要提前注册到DI容器中。 首先注释掉FilterInjectAttribute的注册代码:
  1. publicvoidConfigureServices(IServiceCollection services)
  2. {
  3. services.AddScoped();
  4. //services.AddScoped(typeof(FilterInjectAttribute));
  5. services.AddControllers();
  6. services.AddRazorPages();
  7. }

改用TypeFilterAttribute:
  1. [TypeFilter(typeof(FilterInjectAttribute))]
  2. publicstring DI()
  3. {
  4. Console.WriteLine(“HomeController method DI running .”);
  5. return“DI”;
  6. }

运行一下,在浏览器里访问下对应的path,可以看到MyService已经注入到FilterInjectAttribute中:

.NET Core--ActionFilter中使用依赖注入 - 图4

4. TypeFilterAttribute的IsReusable属性:

跟上面的ServiceFilter一样,ASP.NET Core runtime 并不保证这个filter是真正的单例,这里就不多啰嗦了。

5. TypeFilterAttribute的Arguments属性:

Arguments参数是TypeFilterAttribute跟ServiceFilterAttribute的一个重要区别,ServiceFilterAttribute并没有这属性。Arguments类型为object数组。通过TypeFilterAttribute实例化的ActionFilter,如果它的构造器中的参数类型在DI容器中找不到,会继续在Arguments参数列表里按顺序获取。
改一下FilterInjectAttribute构造器多加入2个参数,并且保证这2个参数无法从DI中取到:
  1. public class FilterInjectAttribute:ActionFilterAttribute
  2. {
  3. public FilterInjectAttribute(string arg1,IMyService myService,string arg2)
  4. {
  5. if(myService ==null)
  6. {
  7. throw new ArgumentNullException("myService");
  8. }
  9. Console.WriteLine("Service {0} was injected .", myService.GetServiceName());
  10. Console.WriteLine("arg1 is {0} .", arg1);
  11. Console.WriteLine("arg2 is {0} .", arg2);
  12. Console.WriteLine("FilterInjectAttribute was created .");
  13. }
  14. }
在使用的时候传入两个参数:
  1. [TypeFilter(typeof(FilterInjectAttribute),Arguments=newobject[]{"HAHA","HOHO"})]
  2. public string DI()
  3. {
  4. Console.WriteLine("HomeController method DI running .");
  5. return"DI";
  6. }
运行一下看到两个参数被传入了FilterInjectAttribute的构造器:

.NET Core--ActionFilter中使用依赖注入 - 图5

二、总结

  1. ActionFilterAttribute的依赖注入可以通过ServiceFilterAttribute,TypeFilterAttribute来实现
  2. ServiceFilterAttribute是通过DI容器来管理ActionFilterAttribute;TypeFilterAttribute则是通过一个工厂直接实例化,所以使用前不需要注册到DI容器中。
  3. IsReusable属性可以实现类似单例的功能,但是运行时并不保证唯一单例。
  4. TypeFilterAttribute的Arguments属性可以作为参数列表。当实例化ActionFilterAttribute的时候如果构造器参数类型没有在DI容器中注册那么会尝试从Arguments列表中取。