在上一篇《dotNET Core 3.X 依赖注入》中简单介绍了 dotNET Core 框架本身的依赖注入功能,大部分情况下使用框架的依赖注入功能就可以满足了,在一些特殊场景下,我们就需要引入第三方的注入框架。
为什么要使用 Autofac?
如果您在之前的 dotNET Framwork 时代使用过依赖注入,那么对 Autofac 一定不会陌生,在 dotNET Core 中也可以很方便的使用 Autofac,之所以使用第三方注入框架,是因为能提供更多的功能:
属性注入
批量注入
动态代理的 AOP 功能
在 dotNET Core 中使用 Autofac
在 dotNET Core 2.x 和 3.x 中使用 Autofac 是有区别的,所以下面分别介绍在两个版本中的简单使用。
2.x
1、创建 dotNET Core 2.1 版本的 WebAPI 项目
2、创建 IUserService 接口和 UserService 类:
public interface IUserService
{string GetUserName();
}
public class UserService: IUserService
{public string GetUserName(){return "oec2003";}
}
3、创建 UserController,在构造函数中添加依赖注入:
[Route("api/[controller]/[action]")]
[ApiController]
public class UserController: ControllerBase
{private readonly IUserService _userService;public UserController(IUserService userService){_userService = userService;}public string GetUserName(){return _userService.GetUserName();}
}
4、添加 Autofac.Extensions.DependencyInjection 的 NuGet 引用
5、修改 Startup 类的 ConfigureServices 方法:
public IServiceProvider ConfigureServices(IServiceCollection services)
{services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_1);//创建 Autofac 容器var containerBuilder = new ContainerBuilder();containerBuilder.Populate(services);//将 UserService 类作为 IUserService 的实现进行注册containerBuilder.RegisterType<UserService>().As<IUserService>().InstancePerLifetimeScope();var container = containerBuilder.Build();//接管内置的容器return new AutofacServiceProvider(container);
}
3.x
1、创建 dotNET Core 3.x 的项目和相关类,参考上面的一到四步
2、修改 Program 类,使用 AutofacServiceProviderFactory 来替代创建服务提供程序的工厂:
public static IHostBuilder CreateHostBuilder(string[] args) =>Host.CreateDefaultBuilder(args).UseServiceProviderFactory(new AutofacServiceProviderFactory()).ConfigureWebHostDefaults(webBuilder => { webBuilder.UseStartup<Startup>(); });
3、修改 Startup 类,在该类中添加 ConfigureContainer 方法,和ConfigureServices 方法一样,框架也是通过命名约束来进行执行的:
public void ConfigureContainer(ContainerBuilder builder)
{builder.RegisterType<UserService>().As<IUserService>().InstancePerLifetimeScope();
}
Autofac 的增强功能
下面的所有示例全部在 dotNET Core 3.1 版本中完成。
属性注入
dotNET Core 框架本身的依赖注入只支持构造函数和 FromSerice 的方式,Autofac 可以支持属性的注入。
使用属性注入很简单,在注册类型时调用 PropertiesAutowired 方法即可,具体步骤如下:
1、调整 UserController ,以属性的方式来定义 IUserService:
public class UserController: ControllerBase
{public IUserService UserService { get; set; }public string GetUserName(){return UserService.GetUserName();}
}
2、修改 Startup 类的 ConfigureServices 方法,添加 AddControllersAsServices 方法的调用:
public void ConfigureServices(IServiceCollection services)
{services.AddControllers().AddControllersAsServices();
}
3、修改 Startup 类的 ConfigureContainer :
public void ConfigureContainer(ContainerBuilder builder)
{builder.RegisterType<UserService>().As<IUserService>().InstancePerLifetimeScope();var controllerBaseType = typeof(ControllerBase); builder.RegisterAssemblyTypes(typeof(Program).Assembly).Where(t => controllerBaseType.IsAssignableFrom(t) && t != controllerBaseType).PropertiesAutowired();
}
只要在 Controller 中需要做属性注入的时候,才需要在 ConfigureServices 方法中添加对 AddControllersAsServices 方法的调用;
PropertiesAutowired 方法添加在使用属性的注入类型中,比如上面代码是在 Controller 中使用属性,所以 PropertiesAutowired 添加对所有 Controller注册的后面;
如果在 UserService 类以属性的方式对 IDeptService 引用,注册的方式如下:
public void ConfigureContainer(ContainerBuilder builder)
{builder.RegisterType<DeptService>().As<IDeptService>().InstancePerLifetimeScope();builder.RegisterType<UserService>().As<IUserService>().PropertiesAutowired().InstancePerLifetimeScope();
}
批量注册
其实上面的代码中已经涉及到了批量注册,就是对所有的 Controller 进行注册:
var controllerBaseType = typeof(ControllerBase);
builder.RegisterAssemblyTypes(typeof(Program).Assembly).Where(t => controllerBaseType.IsAssignableFrom(t) && t != controllerBaseType).PropertiesAutowired();
所有的 Controller 都是继承自基类 ControllerBase,先获取基类的类型;
找到 Program 类所在的程序集中所有实现了 ControllerBase 的类型进行注册。
再来看另一种情况,上面例子中创建 UserServicce 服务,现在再创建 DeptService 服务类:
public interface IDeptService
{string GetDeptName();
}
public class DeptService:IDeptService
{public string GetDeptName(){return "产品部";}
}
修改 Startup 类的 ConfigureContainer 方法来实现批量注册:
public void ConfigureContainer(ContainerBuilder builder)
{builder.RegisterAssemblyTypes(typeof(Program).Assembly).Where(t => t.Name.EndsWith("Service")).AsImplementedInterfaces().InstancePerLifetimeScope();
}
找到 Program 类所在的程序集中所有以 Service 命名的类型进行注册。更多的情况就根据实际场景举一反三了。
动态代理的 AOP 功能
使用动态代理的功能,需要引用 NuGet 包:Autofac.Extras.DynamicProxy,如下图:
AOP 的概念这里就不在赘述,和 dotNET Core 内置的拦截器(Filter、中间件)的区别是 Autofac 的 AOP 针对具体业务方法而不是 HTTP 请求。
1、创建 UserServiceInterceptor 拦截类,继承自 IInterceptor:
public class UserServiceInterceptor:IInterceptor
{public virtual void Intercept(IInvocation invocation){Console.WriteLine($"{DateTime.Now}: 方法执行前");invocation.Proceed();Console.WriteLine($"{DateTime.Now}: 方法执行后");}
}
2、修改 Startup 类中的 ConfigureContainer 方法,进行 AOP 的注册:
public void ConfigureContainer(ContainerBuilder builder)
{builder.RegisterType<UserServiceInterceptor>();builder.RegisterType<UserService>().As<IUserService>().EnableInterfaceInterceptors().InstancePerLifetimeScope();
}
注册 UserServiceInterceptor 拦截器
注册 UserService 服务的时候调用 EnableInterfaceInterceptors 启用拦截器
3、修改 UserService 类,添加 AOP 特性标记:
[Intercept(typeof(UserServiceInterceptor))]
public class UserService: IUserService
{//public IDeptService DeptService { get; set; }public string GetUserName(){Console.WriteLine($"{DateTime.Now}: 方法执行中");return "oec2003";//return $"oec2003({DeptService.GetDeptName()})";}
}
4、调用结果如下:
总结
本文算是抛砖引入,Autofac 还有许多的功能由于目前没有使用到,也就没有放到本文中,比如子容器等。具体使用 dotNET Core 框架自身的依赖注入,还是使用 Autofac,要看具体的场景了,当然两者也是可以并存的。
示例代码:https://github.com/oec2003/DotNetCoreThreeAPIDemo/tree/master/AutofacNetCore3.1Demo