ASP.NET Core MVC 模型绑定用法及原理

简介:

前言

查询了一下关于 MVC 中的模型绑定,大部分都是关于如何使用的,以及模型绑定过程中的一些用法和概念,很少有关于模型绑定的内部机制实现的文章,本文就来讲解一下在 ASP.NET Core MVC 中模型绑定是如何实现的,以及它的一些其他用法。

模型绑定的用途

通常情况下,我们在使用 MVC 框架的时候不需要关注模型绑定的相关功能,因为它是集成到 MVC 框架内部的,当我们在浏览器访问一个地址的时候,无论是 GET 还是 POST 访问,在映射到 Action 的过程中 MVC 框架已经自动的进行了对象或者是路由参数的绑定,这其中就是使用的模型绑定。

在 ASP.NET Core MVC 中,模型绑定分为简单模型绑定和复杂模型绑定。简单的模型绑定比如直接从 Form 表单或者 URL 路由数据中获取信息,然后应用到Action方法的各个参数上,复杂模型绑定的话可能就不是简单的转换到参数的值上面了,可能中间还会涉及到一些数据类型转换,模型分解,参数校验等。

下面来看一下模型绑定的一个示例:

假设我们有一个ViewModel对象叫 Person,它的代码如下:

public class Person{    public string Name { get; set; }    
    public int Age { get; set; }
}

在这个 ViewModel 对象中,都是使用的一些很简单的类型,那么我们的 Action 进行如下的定义:

public class PersonController{
    [HttpPost]
    [Route("~api/person/add")]    public IActionResult CreatePerson(Person person)    {        return Ok(person);
    }
}

在上面的代码中,我们可以向 http://localhost:5000/api/person/add 这个地址发送一个 POST 请求,Body 类型使用普通的 Form ,参数使用上面Person定义的 Name, Age。 在 Action 上添加断点,我们就可以看到person变量中的值,然后此 Action 会返回一个被 json 序列化后的结果对象。

这样一个过程,就是模型绑定在实际开发中的一个用途和用法。

是不是看起来很简单呢?但是在内部模型绑定子系统是比较复杂的,由很多部分组成。

模型绑定的一些用法

在 ASP.NET Core MVC 中,支持以下表单类型的模型绑定。

[FromHeader],[FromQuery],[FromRoute],[FromForm]

示例:

public IActionResult CreatePerson([FromForm]Person person){    return Ok(person);
}

这些 [FromXXX] 是告诉模型绑定在解析的过程中从HttpContext中那一部分获取信息。

还有一部分模型绑定框架中定义的一些 Attribute 是用来在模型模型的过程中限制或者忽略一些参数。比如

[BindRequired],[BindNever]

这两个是用来在模型绑定的过程中添加的一些制约,BindRequired可以应用在类或者属性上,用来限制在绑定的过程中必须需要的一些值。BindNever用来忽略当前参数的绑定。

还有两个 [FromServices], [FromBody]。

[FromServices] 是参数绑定的过程中,告诉模型绑定框架该参数从 DI 容器中获取。

[FromBody] 是参数绑定的过程中,告诉框架该参数是使用配置过的格式化程序从Http Body 中解析。

在[FromBody]中,默认情况下会使用MVC框架内部配置的 JsonInputFormatter 进行反序列化解析,如果你传递的 Body 中的类型是 application/xml,你可以在 ConfigureServices 方法中配置 services.AddMvc().AddXmlSerializerFormatters();进行XML的反序列化。

还有一个 [ModelBinder] 这个可能很多人没用过,这个是应用在 Controller 中的属性上的,用来绑定属性信息。比如

public class Controller{
    [ModelBinder]    public string Name { get; set;}    
    public IActionResult CreatePerson(Person person)    {        return Ok(person);
    }
}

在 Action 激活的时候,Controller 的 Name 属性也会具有Action 参数中 person 变量中名字和 Name 相同参数的值。

自定义模型绑定

自定义模型绑定属于 MVC 模型绑定的一些高级知识,在一些特殊情况中我们可能会使用到他们。 详情可以参考这篇 文章 https://docs.microsoft.com/en-us/aspnet/core/mvc/advanced/custom-model-binding,本文不打算做过多介绍。

MVC 模型绑定(ModelBinding)实现原理

看过我 ASP.NET Core MVC Action 激活 这篇文章的同学应该知道,在 Action 激活的过程中会涉及到很多状态,那么模型绑定是在 ActionBegin 这个状态中进行的,同时在 ActionNext 过程中被使用,我就直接接着这篇文章的 Action 执行部分进行讲解了。

首先,模型绑定的入口位于 ControllerActionInvoker 这个类中的一个Next方法里

private Task Next(ref State next, ref Scope scope, ref object state, ref bool isCompleted){
    ......    
    switch (next)
    {        case State.ActionBegin:             BindArgumentsAsync();             goto case State.ActionNext;        
        case State.ActionNext:
            _actionExecutingContext = new ActionExecutingContext(_arguments);
    }
    
    ......
}

可以看到在 State.ActionBegin 这个过程中使用了 BindArgumentsAsync() 进行参数绑定,那么整个绑定过程就由此开始。

在 Core MVC 框架模型绑定部分源码中,模型绑定源码分为这几部分:元数据(Metadata),值提供器(ValueProvider),验证者(Validator),绑定器(Binder)。

元数据:元数据相当于模型绑定中的实体对象,用来储存在整个模型绑定子系统中需要的各种必要信息和元数据信息,包括模型参数的元数据和以及绑定信息的元数据等等。

值提供器:值提供器用来提供在运行时模型绑定器可以从中提取值的一个Provider, 默认情况下,值提供器会从以下地方提取各种资源的值:

1、以前绑定的操作参数(当该操作为子操作时)

2、表单字段 (FormValueProvider)

3、路由数据 (RouteValueProvider)

4、查询字符串参数 (QueryStringValueProvider)

5、JQuery 表单数据(JQueryFormValueProvider)

这些 ValueProvider 对象由 CompositeValueProvider 进行统一管理,它是一个集合用来创建或者获取这些 ValueProvider 对象。

验证者:验证者是用来验证Action参数中模型字段的合法性。

它的默认实现是 DefaultObjectValidator,它会根据元数据信息来确定绑定过程中使用的具体 ValudatorProvider 对象,ValudatorProvider 是用来提供IModelValidator接口实例对象的。

在 ASP.NET Core MVC 中有两个类实现了 IModelValidator接口,他们分别是 DataAnnotationsModelValidator 和 ValidatableObjectAdapter。 其中 ValidatableObjectAdapter是一个适配器,用来转换和封装验证结果,所以我们主要看 DataAnnotationsModelValidator。

DataAnnotationsModelValidator 就是用来验证模型类中的各种 Attribute 的,也就是DataAnnotations相关的那些类,比如 [MaxLength],[Required],[RegularExpression] 等等。

绑定器: 绑定器用来绑定Action参数中的大多数简单和复杂的数据模型,它通过对模型各个属性使用递归逻辑来实现该目标。

针对不同类型的绑定具有不同的绑定器,如:

ArrayModelBinder,SimpleTypeModelBinder,FormFileModelBinder,
FormCollectionModelBinder,ComplexTypeModelBinder,
BodyModelBinder,HeaderModelBinder,DictionaryModelBinder,
ServicesModelBinder,KeyValuePairModelBinder,ByteArrayModelBinder,
CancellationTokenModelBinder,CollectionModelBinder,BinderTypeModelBinder

这些 ModelBinder 对象都具有各自的 Provider 对象,对来返回当前Binder对象的实例对象。

这些 ModelBinder 对象由 ParameterBinder 进行统一管理, ParameterBinder 对象会接收模型的元数据信息(Metadata),绑定器工厂(BinderFactory),验证者(Validator),然后进行最终的模型绑定流程,如下图:

250417-20170524113853810-1576035588.png

回到总流程

我们回到 ControllerActionInvoker 这个中,BindArgumentsCoreAsync 这个函数中会进行上层的模型绑定,流程如下:

250417-20170524115505857-2115155507.png

以上总流程的前两步就是 MVC Core 模型绑定系统针对于 Controller 中 Action 参数的绑定,实际上除了针对 Action 参数绑定外,还会对 Controller 中的使用了 [IModelBinder] 特性的进行绑定,那么第三步就是在做这个事情。

至此,模型绑定流程结束。

总结

在本篇中,我们学习了在 ASP.NET Core MVC 中模型绑定的一些用途和一些基本的用法,然后学习了 MVC框架中模型绑定的一些内部实现原理,通过这个学习我们可以对整个模型绑定系统更加的系统的一个了解,以便于我们有在工作系统的时候可以针对于模型绑定系统进行扩展。





      本文转自zsdnr  51CTO博客,原文链接:http://blog.51cto.com/12942149/1928950,如需转载请自行联系原作者



相关文章
|
14天前
|
数据可视化 网络协议 C#
C#/.NET/.NET Core优秀项目和框架2024年3月简报
公众号每月定期推广和分享的C#/.NET/.NET Core优秀项目和框架(每周至少会推荐两个优秀的项目和框架当然节假日除外),公众号推文中有项目和框架的介绍、功能特点、使用方式以及部分功能截图等(打不开或者打开GitHub很慢的同学可以优先查看公众号推文,文末一定会附带项目和框架源码地址)。注意:排名不分先后,都是十分优秀的开源项目和框架,每周定期更新分享(欢迎关注公众号:追逐时光者,第一时间获取每周精选分享资讯🔔)。
|
2月前
|
机器学习/深度学习 算法 网络架构
【CVPR2017】AOD-Net:端到端的除雾网络(原理&实操)
【CVPR2017】AOD-Net:端到端的除雾网络(原理&实操)
395 0
【CVPR2017】AOD-Net:端到端的除雾网络(原理&实操)
|
3月前
|
开发框架 前端开发 JavaScript
盘点72个ASP.NET Core源码Net爱好者不容错过
盘点72个ASP.NET Core源码Net爱好者不容错过
71 0
|
17小时前
|
机器学习/深度学习 存储 计算机视觉
r语言中对LASSO回归,Ridge岭回归和弹性网络Elastic Net模型实现-4
r语言中对LASSO回归,Ridge岭回归和弹性网络Elastic Net模型实现
25 11
|
6天前
|
算法
r语言中对LASSO回归,Ridge岭回归和Elastic Net模型实现
r语言中对LASSO回归,Ridge岭回归和Elastic Net模型实现
15 1
|
7天前
|
算法
r语言中对LASSO,Ridge岭回归和Elastic Net模型实现
r语言中对LASSO,Ridge岭回归和Elastic Net模型实现
11 0
|
14天前
|
机器学习/深度学习 数据挖掘 Go
中科院二区7.4分|NET基因肿瘤分型+生存预后模型+分子对接
在《Journal of Translational Medicine》上发表的最新研究中,科学家们鉴定了一种新的NET相关基因签名,用于预测弥漫性大B细胞淋巴瘤(DLBCL)患者的预后。他们发现8个基因(PARVB,LYZ,PPARGC1A,HIF1A,SPP1,CDH1,S100A9和CXCL2)与DLBCL生存率显著相关,建立了NRG遗传风险模型,该模型可能有助于指导DLBCL的治疗选择。研究包括基因表达数据的分析、预后特征的构建和验证,以及与免疫微环境和潜在治疗靶点的相关性探索。
17 0
|
1月前
|
开发框架 前端开发 .NET
进入ASP .net mvc的世界
进入ASP .net mvc的世界
29 0
|
1月前
|
开发框架 人工智能 .NET
C#/.NET/.NET Core拾遗补漏合集(持续更新)
C#/.NET/.NET Core拾遗补漏合集(持续更新)
|
1月前
|
开发框架 中间件 .NET
C# .NET面试系列七:ASP.NET Core
## 第一部分:ASP.NET Core #### 1. 如何在 controller 中注入 service? 在.NET中,在ASP.NET Core应用程序中的Controller中注入服务通常使用<u>依赖注入(Dependency Injection)</u>来实现。以下是一些步骤,说明如何在Controller中注入服务: 1、创建服务 首先,确保你已经在应用程序中注册了服务。这通常在Startup.cs文件的ConfigureServices方法中完成。例如: ```c# services.AddScoped<IMyService, MyService>(); //
61 0