ASP.NETWebAPIModel-ParameterBinding-创新互联

ASP.NET Web API Model-ParameterBinding

前言

通过上个篇幅的学习了解Model绑定的基础知识，然而在ASP.NET Web API中Model绑定功能模块并不是被直接调用的，而是要通过本篇要介绍的内容ParameterBinding的一系列对象对其进行封装调用，通过本篇的学习之后也会大概的清楚在Web API中绑定会有哪几种方式。

Model-ParameterBinding（对象篇）

在ASP.NET Web API中ParameterBinding代表着参数绑定并且在这其中涉及了几种绑定的方式，然而ParaMeterBinding并不是单独执行的，就好比一个控制器方法中有可能会有多个参数一样，所以我们就先来看一下ActionBinding的相关对象，对于这些对象的生成的环境以及过程我们在后面的篇幅中会有讲解。

HttpActionBinding

代码1-1

namespace System.Web.Http.Controllers
{
    public class HttpActionBinding
    {
        public HttpActionBinding();
        public HttpActionBinding(HttpActionDescriptor actionDescriptor, HttpParameterBinding[] bindings);
        public HttpActionDescriptor ActionDescriptor { get; set; }
        public HttpParameterBinding[] ParameterBindings { get; set; }

        public virtual Task ExecuteBindingAsync(HttpActionContext actionContext, CancellationToken cancellationToken);
    }
}

代码1-1中对于HttpActionBinding类型的定义一目了然，看HttpActionBinding类型的重载构造函数中有HttpActionDescriptor类型、HttpParameterBinding类型的数组类型作为参数，HttpActionDescriptor类型作为控制器方法描述类型大家已经很熟悉了吧，这个类型中包含着控制器方法的元数据信息，而后者HttpParameterBinding类型则是表示着参数绑定对象，其实在Model绑定中每个参数的绑定都是通过ParameterBinding来绑定的，所以这里的执行过程我们暂时不去深入了解，就是单纯的了解一下相关的对象模型。

HttpParameterBinding

代码1-2

namespace System.Web.Http.Controllers
{
    public abstract class HttpParameterBinding
    {
        protected HttpParameterBinding(HttpParameterDescriptor descriptor);

        public HttpParameterDescriptor Descriptor { get; }
        public virtual string ErrorMessage { get; }
        public bool IsValid { get; }
        public virtual bool WillReadBody { get; }

        public abstract Task ExecuteBindingAsync(ModelMetadataProvider metadataProvider, HttpActionContext actionContext, CancellationToken cancellationToken);
        protected object GetValue(HttpActionContext actionContext);
        protected void SetValue(HttpActionContext actionContext, object value);
    }
}

在代码1-2中我们看到HttpParameterBinding类型的定义，可以看到HttpParameterBinding是抽象类型，并且实现绑定的方法ExecuteBindingAsync()也是抽象的，这也是为了在不同的环境和情况相爱采取不同的绑定机制做好铺垫就是多态啦，这个我们后面会说，我们还是先看下HttpParameterBinding类型的内部定义，首先我们看到的是构造函数中的参数类型，HttpParameterDescriptor类型，又是一个对象描述类型，这次的描述对象则是控制其方法中的某个参数，而HttpParameterBinding对象实例的生成则是根据HttpParameterDescriptor对象实例而来，这个后续的篇幅中会有讲解。ErrorMessage属性表示在ParameterBinding绑定的过程中出现的错误信息，而IsValid属性表示绑定是否可以完成的依据就是判断ErrorMessage属性是否为Null，WillReadBody属性表示ParameterBinding对象是否读取Http消息正文内容作为参数绑定的数据源，这个稍后给大家看的示例中就有，一看便知。GetValue()和SetValue()方法就是向当前HttpActionContext中获取对应的参数值和设置参数对应值。

ModelBinderParameterBinding

代码1-3

namespace System.Web.Http.ModelBinding
{
    public class ModelBinderParameterBinding : HttpParameterBinding, IValueProviderParameterBinding
    {
        public ModelBinderParameterBinding(HttpParameterDescriptor descriptor, IModelBinder modelBinder, IEnumerable valueProviderFactories);

        public IModelBinder Binder { get; }
        public IEnumerable ValueProviderFactories { get; }

        public override Task ExecuteBindingAsync(ModelMetadataProvider metadataProvider, HttpActionContext actionContext, CancellationToken cancellationToken);
    }
}

代码1-3表示的是ModelBinderParameterBinding类型，这个类型代表的绑定方式（绑定的数据来源）是通过IModelBinder来获取的，也就正如代码1-3中我们看到的构造函数一样，其中有IModelBinder和ValueProviderFactory类型的集合，这些就是数据绑定的数据源。Binder属性和ValueProviderFactories属性也就是构造函数传入的两个类型值。对于绑定的细节这里就不说多了。

FormatterParameterBinding

代码1-4

namespace System.Web.Http.ModelBinding
{
    public class FormatterParameterBinding : HttpParameterBinding
    {
        public FormatterParameterBinding(HttpParameterDescriptor descriptor, IEnumerable formatters, IBodyModelValidator bodyModelValidator);

        public IBodyModelValidator BodyModelValidator { get; set; }
        public override string ErrorMessage { get; }
        public IEnumerable Formatters { get; set; }
        public override bool WillReadBody { get; }

        public override Task ExecuteBindingAsync(ModelMetadataProvider metadataProvider, HttpActionContext actionContext, CancellationToken cancellationToken);
        public virtual Task