通过遍历目标Action的所有参数actionDescriptor.Parameters,根据参数逐一匹配一个对应定的处理对象BinderItem。
如本例,会匹配到两个Binder:
参数 user ===> {Microsoft.AspNetCore.Mvc.ModelBinding.Binders.BodyModelBinder}
参数 note ===> {Microsoft.AspNetCore.Mvc.ModelBinding.Binders.SimpleTypeModelBinder}
这是如何匹配的呢,系统定义了一系列provider,如下图
图一
会遍历他们分别与当前参数做匹配:
for (var i = 0; i < _providers.Length; i++) { var provider = _providers[i]; result = provider.GetBinder(providerContext); if (result != null) { break; } }
同样以这两个Binder为例看一下,BodyModelBinderProvider:
public IModelBinder GetBinder(ModelBinderProviderContext context) { if (context == null) { throw new ArgumentNullException(nameof(context)); } if (context.BindingInfo.BindingSource != null && context.BindingInfo.BindingSource.CanAcceptDataFrom(BindingSource.Body)) { if (_formatters.Count == 0) { throw new InvalidOperationException(Resources.FormatInputFormattersAreRequired( typeof(MvcOptions).FullName, nameof(MvcOptions.InputFormatters), typeof(IInputFormatter).FullName)); } return new BodyModelBinder(_formatters, _readerFactory, _loggerFactory, _options); } return null; }
BodyModelBinder的主要判断依据是BindingSource.Body 也就是user参数我们设置了[FromBody]。
同理SimpleTypeModelBinder的判断依据是 if (!context.Metadata.IsComplexType) 。
找到对应的provider后,则会由该provider来new 一个 ModelBinder返回,也就有了上文的BodyModelBinder和SimpleTypeModelBinder。
小结:至此前期准备工作已经完成,这里创建了三个重要的对象:
1. Task Bind() ,用于绑定的方法,并被封装到了invoker内的CacheEntry中。
2. parameterBindingInfo :本质是一个BinderItem[],其中的BinderItem数量与Action的参数数量相同。
3. propertyBindingInfo:类似parameterBindingInfo, 用于属性绑定,下面详细介绍。
图二
三、执行阶段
从上一节的小结可以猜到,执行阶段就是调用Bind方法,利用创建的parameterBindingInfo和propertyBindingInfo将请求发送来的参数处理后赋值给Action对应的参数。
同样,这个阶段发生在invoker(即ControllerActionInvoker)的InvokeAsync()阶段,当调用到它的Next方法的时候,首先第一步State为ActionBegin的时候就会调用BindArgumentsAsync()方法,如下
private Task Next(ref State next, ref Scope scope, ref object state, ref bool isCompleted) { switch (next) { case State.ActionBegin: { //略。。。 _arguments = new Dictionary<string, object>(StringComparer.OrdinalIgnoreCase); var task = BindArgumentsAsync(); }
而BindArgumentsAsync()方法会调用上一节创建的_cacheEntry.ControllerBinderDelegate,也就是Task Bind() 方法
1. private Task BindArgumentsAsync() { // 略。。。 return _cacheEntry.ControllerBinderDelegate(_controllerContext, _instance, _arguments); }
上一节略了,现在详细看一下这个方法,
async Task Bind(ControllerContext controllerContext, object controller, Dictionary<string, object> arguments) { var valueProvider = await CompositeValueProvider.CreateAsync(controllerContext); var parameters = actionDescriptor.Parameters; for (var i = 0; i < parameters.Count; i++) //遍历参数集和,逐一处理 { var parameter = parameters[i]; var bindingInfo = parameterBindingInfo[i]; var modelMetadata = bindingInfo.ModelMetadata; if (!modelMetadata.IsBindingAllowed) { continue; } var result = await parameterBinder.BindModelAsync( controllerContext, bindingInfo.ModelBinder, valueProvider, parameter, modelMetadata, value: null); if (result.IsModelSet) { arguments[parameter.Name] = result.Model; } } var properties = actionDescriptor.BoundProperties; for (var i = 0; i < properties.Count; i++) //略 }
主体就是两个for循环,分别用于处理参数和属性,依然是以参数处理为例说明。