Asp.net web Api源码分析-ParameterBindingAttribute

在前面数据绑定中我们曾提到一个FromUriAttribute类，它集成于ModelBinderAttribute，而ModelBinderAttribute又继承ParameterBindingAttribute，ParameterBindingAttribute类就一个空方法没什么实现，这里主要的实现在ModelBinderAttribute类里面，其主要方法是GetBinding，

 public override HttpParameterBinding GetBinding(HttpParameterDescriptor parameter)
        {
            HttpConfiguration config = parameter.Configuration;
            IModelBinder binder = GetModelBinder(config, parameter.ParameterType);
            IEnumerable<ValueProviderFactory> valueProviderFactories = GetValueProviderFactories(config);

            return new ModelBinderParameterBinding(parameter, binder, valueProviderFactories);
        }

这里的GetModelBinder方法具体实现如下，

 public IModelBinder GetModelBinder(HttpConfiguration configuration, Type modelType)
        {
            if (BinderType == null)
            {
                ModelBinderProvider provider = GetModelBinderProvider(configuration);
                return provider.GetBinder(configuration, modelType);
            }

            // This may create a IModelBinder or a ModelBinderProvider
            object value = GetOrInstantiate(configuration, BinderType);

            Contract.Assert(value != null); // Activator would have thrown

            IModelBinder binder = value as IModelBinder;
            if (binder != null)
            {
                return binder;
            }
            else
            {
                ModelBinderProvider provider = value as ModelBinderProvider;
                if (provider != null)
                {
                    return provider.GetBinder(configuration, modelType);
                }
            }

            Type required = typeof(IModelBinder);
            throw Error.InvalidOperation(SRResources.ValueProviderFactory_Cannot_Create, required.Name, value.GetType().Name, required.Name);
        }

这里的检查BinderType 是否为null，这里首先调用GetModelBinderProvider来获取一个ModelBinderProvider实例，

 public ModelBinderProvider GetModelBinderProvider(HttpConfiguration configuration)
        {
            if (BinderType != null)
            {
                object value = GetOrInstantiate(configuration, BinderType);

                if (value != null)
                {
                    VerifyBinderType(value.GetType());
                    ModelBinderProvider result = (ModelBinderProvider)value;
                    return result;
                }
            }

            // Create default over config
            IEnumerable<ModelBinderProvider> providers = configuration.Services.GetModelBinderProviders();

            if (providers.Count() == 1)
            {
                return providers.First();
            }

            return new CompositeModelBinderProvider(providers);
        }，

这你的GetOrInstantiate方法非常简单，根据BinderType直接创建一个实例，创建方法configuration.DependencyResolver.GetService，然后验证实例是否是ModelBinderProvider类型实例，如果不是抛出异常，如果是则直接转化为ModelBinderProvider并返回。

所以这里我们默认调用configuration.Services.GetModelBinderProviders()来获取providers，

  SetMultiple<ModelBinderProvider>(new TypeConverterModelBinderProvider(),
                                        new TypeMatchModelBinderProvider(),
                                        new KeyValuePairModelBinderProvider(),
                                        new ComplexModelDtoModelBinderProvider(),
                                        new ArrayModelBinderProvider(),
                                        new DictionaryModelBinderProvider(),
                                        new CollectionModelBinderProvider(),
                                        new MutableObjectModelBinderProvider());

所以我们默认的providers 就有这8个，它们每个对应着自己的IModelBinder

TypeConverterModelBinderProvider->TypeConverterModelBinder
TypeMatchModelBinderProvider->TypeMatchModelBinder
KeyValuePairModelBinderProvider->KeyValuePairModelBinder<,>
ComplexModelDtoModelBinderProvider->CompositeModelBinder
ArrayModelBinderProvider-> ArrayModelBinder<T>
DictionaryModelBinderProvider->DictionaryModelBinder<,>
CollectionModelBinderProvider->CollectionModelBinder<>
MutableObjectModelBinderProvider->MutableObjectModelBinder

如果在调用GetModelBinderProvider方法时，BinderType 值为null时返回的是一个CompositeModelBinderProvider，如果不为null则返回指定类型的ModelBinderProvider。

回到GetModelBinder方法中来，我们先看看BinderType 值为null的情况下是如何执行的，调用CompositeModelBinderProvider的GetBinder方法。

其中CompositeModelBinderProvider的GetBinder方法实现如下：

        public override IModelBinder GetBinder(HttpConfiguration configuration, Type modelType)
        {
            IEnumerable<ModelBinderProvider> providers = _providers ?? configuration.Services.GetModelBinderProviders();
            IEnumerable<IModelBinder> binders = from provider in providers
                                                let binder = provider.GetBinder(configuration, modelType)
                                                where binder != null
                                                select binder;
            return new CompositeModelBinder(binders);
        }

从当前的providers中依次调用他们的GetBinder方法，然后利用返回的IModelBinder集合创建一个新的CompositeModelBinder实例。

现在我们回到GetModelBinder方法中来，BinderType 为null的情况下返回一个CompositeModelBinder实例，不为null就首先根据BinderType来创建新的实例，如果它是IModelBinder就直接返回，如果它是ModelBinderProvider就调用它的GetBinder方法并返回，否者抛出异常。

现在回到GetBinding方法中来，IModelBinder已经取到了，接下来是如何获取ValueProviderFactory集合。

 public virtual IEnumerable<ValueProviderFactory> GetValueProviderFactories(HttpConfiguration configuration)
        {
            // By default, just get all registered value provider factories
            return configuration.Services.GetValueProviderFactories();
        }

     SetMultiple<ValueProviderFactory>(new QueryStringValueProviderFactory(),
                                           new RouteDataValueProviderFactory());

其中FromUriAttribute重写父类的GetValueProviderFactories方法，

 public override IEnumerable<ValueProviderFactory> GetValueProviderFactories(HttpConfiguration configuration)
        {
            foreach (ValueProviderFactory f in base.GetValueProviderFactories(configuration))
            {
                if (f is IUriValueProviderFactory)
                {
                    yield return f;
                }
            }
        }

默认的QueryStringValueProviderFactory、RouteDataValueProviderFactory都实现了IUriValueProviderFactory接口，而CompositeValueProviderFactory就没有实现它。

到这里ModelBinderAttribute中的GetBinding方法最后就只剩下ModelBinderParameterBinding的实例化了，这个比较简单忽略它了。

在DefaultActionValueBinder有这么一句new FromBodyAttribute().GetBinding(parameter)，首先看看FromBodyAttribute的实现吧：

    public sealed class FromBodyAttribute : ParameterBindingAttribute
    {
        public override HttpParameterBinding GetBinding(HttpParameterDescriptor parameter)
        {
            IEnumerable<MediaTypeFormatter> formatters = parameter.Configuration.Formatters;
            IBodyModelValidator validator = parameter.Configuration.Services.GetBodyModelValidator();

            return parameter.BindWithFormatter(formatters, validator);
        }
    }

  SetSingle<IBodyModelValidator>(new DefaultBodyModelValidator());这里的validator其实是一个DefaultBodyModelValidator实例。

其中BindWithFormatter的方法实现如下：

public static HttpParameterBinding BindWithFormatter(this HttpParameterDescriptor parameter, IEnumerable<MediaTypeFormatter> formatters, IBodyModelValidator bodyModelValidator)
        {
            return new FormatterParameterBinding(parameter, formatters, bodyModelValidator);
        }

这里返回一个FormatterParameterBinding实例。所以默认情况下我们主要还用的ModelBinderParameterBinding、FormatterParameterBinding它们2个。后面再绑定参数的时候就是调用他们的ExecuteBindingAsync方法。

总结一下吧：web api的参数绑定和mvc参数绑定差不多，它主要是从路由、url、form来获取参数，路由和url里面的参数结果相对简单，然而from里面的参数有时候需要一个format来格式化，在实际应用中典型的是josn的格式化，返回也需要一个格式化的。在开发Action时建议参数加上Attritute比较好，这样就节省DefaultActionValueBinder.GetParameterBinding方法的开销，他直接返回parameter.ParameterBinderAttribute，而不用像 parameter.Configuration.ParameterBindingRules、parameter.BindWithAttribute(new FromUriAttribute())、new FromBodyAttribute().GetBinding(parameter)这几个复杂而又麻烦的方式获取HttpParameterBinding实例，代码如：

 public void Post([FromBody]string value)
        {
        }

同是web api里面的IModelBinder这里主要有8个实现（TypeConverterModelBinder TypeMatchModelBinder KeyValuePairModelBinder<,> CompositeModelBinder ArrayModelBinder<T> DictionaryModelBinder<,> CollectionModelBinder<> MutableObjectModelBinder），而mvc则只有一个DefaultModelBinder实现。同样web api中的ValueProviderFactory实现也比较简单就默认只有CompositeValueProviderFactory、QueryStringValueProviderFactory、RouteDataValueProviderFactory。总之我们知道web api主要应用就是Rest，它是相对mvc来说是一个轻量级handler，比我们普通的httphandler功能要强大很多，典型是路由和数据格式化的支持。