internal static ConfigureBuilder FindConfigureDelegate(Type startupType, string environmentName) { //通过startup类型和方法名为Configure或Configure+环境变量名称的方法 var configureMethod = FindMethod(startupType, "Configure{0}", environmentName, typeof(void), required: true); //用查找到的方法去初始化ConfigureBuilder return new ConfigureBuilder(configureMethod); }
从这里我们可以看到FindConfigureDelegate方法也是调用的FindMethod方法,只是传递的方法名字符串为Configure或Configure+环境变量,关于FindMethod的方法实现我们在上面讲解ConfigureServices方法的时候已经非常详细的说过了,这里就不过多的讲解了。总之是通过FindMethod去查找名为Configure的方法或名为Configure+环境变量的方法比如ConfigureDevelopment查找规则和ConfigureServices是完全一致的。但是Configure方法却可以通过参数注入注册到IServiceCollection中的服务,答案我们同样要在ConfigureBuilder类中去探寻
[点击查看源码👈]
internal class ConfigureBuilder { //构造函数传递Configure的MethodInfo public ConfigureBuilder(MethodInfo configure) { MethodInfo = configure; } public MethodInfo MethodInfo { get; } //Build方法返回Action<IApplicationBuilder>委托 public Action<IApplicationBuilder> Build(object instance) => builder => Invoke(instance, builder); //执行逻辑 private void Invoke(object instance, IApplicationBuilder builder) { //通过IApplicationBuilder的ApplicationServices获取IServiceProvider实例创建一个作用域 using (var scope = builder.ApplicationServices.CreateScope()) { //获取IServiceProvider实例 var serviceProvider = scope.ServiceProvider; //获取Configure的所有参数 var parameterInfos = MethodInfo.GetParameters(); var parameters = new object[parameterInfos.Length]; for (var index = 0; index < parameterInfos.Length; index++) { var parameterInfo = parameterInfos[index]; //如果方法参数为IApplicationBuilder类型则直接将传递过来的IApplicationBuilder赋值给它 if (parameterInfo.ParameterType == typeof(IApplicationBuilder)) { parameters[index] = builder; } else { try { //根据方法的参数类型在serviceProvider中获取具体实例赋值给对应参数 parameters[index] = serviceProvider.GetRequiredService(parameterInfo.ParameterType); } catch (Exception ex) { //如果对应的方法参数名称,没在serviceProvider中获取到则直接抛出异常 //变相的说明了Configure方法的参数必须是注册在IServiceCollection中的 } } } MethodInfo.InvokeWithoutWrappingExceptions(instance, parameters); } } }
通过ConfigureBuilder类的实现逻辑,可以清晰的看到为何Configure方法参数可以注入任何在IServiceCollection中注册的服务了。接下来我们总结一下Configure方法的初始化逻辑,首先在Startup中查找方法名为Configure或Configure+环境变量名称(比如ConfigureDevelopment)的方法,然后查找IApplicationBuilder类型的参数,如果找到则将程序中的IApplicationBuilder实例传递给它。至于为何Configure方法能够通过参数注入任何在IServiceCollection中注册的服务,则是因为循环Configure中的所有参数然后在IOC容器中获取对应实例赋值过来,Configure方法的参数一定得是在IServiceCollection注册过的类型,否则会抛出异常。
ConfigureContainer为何会被调用
如果你在ASP.NET Core 3.1中使用过Autofac那么你对ConfigureContainer方法一定不陌生,它和ConfigureServices、Configure方法一样的神奇,在几乎没有任何约束的情况下我们只需要定义ConfigureContainer方法并为方法传递一个ContainerBuilder参数,那么这个方法就能顺利的被调用了。这一切究竟是如何实现的呢,接下来我们继续探究源码,找到了如下的逻辑
[点击查看源码👈]
//根据规则查找最终返回ConfigureContainerBuilder实例 var configureContainerBuilder = StartupLoader.FindConfigureContainerDelegate(startupType, context.HostingEnvironment.EnvironmentName); if (configureContainerBuilder.MethodInfo != null) { //获取容器类型比如如果是autofac则类型为ContainerBuilder var containerType = configureContainerBuilder.GetContainerType(); // 存储configureContainerBuilder实例 _builder.Properties[typeof(ConfigureContainerBuilder)] = configureContainerBuilder; //构建一个Action<HostBuilderContext,containerType>类型的委托 var actionType = typeof(Action<,>).MakeGenericType(typeof(HostBuilderContext), containerType); // 获取此类型的私有ConfigureContainer方法,然后声明该方法的泛型为容器类型,然后创建这个方法的委托 var configureCallback = GetType().GetMethod(nameof(ConfigureContainer), BindingFlags.NonPublic | BindingFlags.Instance) .MakeGenericMethod(containerType) .CreateDelegate(actionType, this); // 等同于执行_builder.ConfigureContainer<T>(ConfigureContainer),其中T为容器类型。 //C onfigureContainer表示一个委托,即我们在Startup中定义的ConfigureContainer委托 typeof(IHostBuilder).GetMethods().First(m => m.Name == nameof(IHostBuilder.ConfigureContainer)) .MakeGenericMethod(containerType) .InvokeWithoutWrappingExceptions(_builder, new object[] { configureCallback }); }