ASP.NET MVC以ModelValidator为核心的Model验证体系: ModelValidator

简介:

旨在为目标Action方法的执行绑定输入参数的Model绑定过程伴随着对Model的验证。借助相应的验证特性,我们可以直接以声明的方式在Model类型上定义验证规则,这些规则将会作为Model元数据的一部分。具体在Model绑定过程中,ModelBinder通过ValueProvider为Model对象的某个属性提供相应属性值之后,会根据定义在基于该属性的Model元数据的验证规则实施验证。ASP.NET MVC的整个Model验证系统以组件ModelValidator为核心,或者说Model对象的验证最终通过某个ModelValidator对象来完成,所以我们有必要先来认识一下ModelValidator以及背后的提供机制。[本文已经同步到《How ASP.NET MVC Works?》中]

目录
一、ModelValidator
二、DataAnnotationsModelValidator
三、ClientModelValidator
四、DataErrorInfoModelValidator
五、ValidatableObjectAdapter

一、ModelValidator

在ASP.NET MVC应用编程接口中,所有的ModelValidator都直接或者间接地继承自抽象类型ModelValidator。如下面的代码片断所示,ModelValidator具有一个布尔类型的只读属性IsRequired,表示该ModelValidator是否是对目标数据进行必要性的验证,默认返回False。GetClientValidationRules返回一个元素类型为ModelClientValidationRule的集合。ModelClientValidationRule是对客户端验证规则的封装,我们会在进行客户端验证时对其进行详细介绍。

   1: public abstract class ModelValidator
   2: {
   3:     //其他成员    
   4:     public virtual IEnumerable<ModelClientValidationRule> GetClientValidationRules();
   5:     public abstract IEnumerable<ModelValidationResult> Validate(object container);
   6:     
   7:     public virtual bool IsRequired { get; }
   8: }

真正对目标数据实施验证是通过调用Validate方法来完成的,而该方法的输入参数container表示的正式被验证的对象。该Validate返回一个表示验证结果的元素类型为ModelValidationResult的集合,该类型的定义如下所示。

   1: public class ModelValidationResult
   2: {  
   3:     public ModelValidationResult();
   4:  
   5:     public string MemberName { get; set; }
   6:     public string Message { get; set; }
   7: }

ModelValidationResult具有两个字符串类型的属性MemberName和Message,前者代表被验证数据成员的名称,后者表示错误消息。一般来说,当它们用于验证某个复杂类型对象的时候,针对于类型本身验证返回的ModelValidationResult对象的MemberName属性为空字符串;而对于针对属性验证来说,属性名称直接作为MemberName属性值。

ModelClientValidationRule集合只有在验证失败的情况下才会返回。如果目标数据符合所有的验证规则,Validate方法会直接返回Null或者一个空ModelValidationResult集合。值得一提的是,我们在调用ModelValidator的Validate方法确定目标数据是否通过验证时,有时候会将方法返回值和定义在类型ValidationResult中具有如下定义的静态只读字段Success进行比较。实际上,表示验证成功的Success字段值就是Null

   1: public class ValidationResult
   2: {
   3:     //其他成员   
   4:     public static readonly ValidationResult Success;
   5: }

二、DataAnnotationsModelValidator

稍微了解ASP.NET MVC的读者应该知道,我们可以通过数据类型的某个属性上应用相应的验证标注特性(比如RequiredAttribute、RangeAttribute和RegularExpressionAttribute等)的方式来定义相应的验证规则,这是ASP.NET MVC 提供的默认Model验证方式。这种基于数据标注(Data Annotation)特性的验证对应的ModelValidator类型为DataAnnotationsModelValidator,我们会在后续的文章中对其进行单独介绍。

三、ClientModelValidator

ClientModelValidator是定义在程序集System.Web.Mvc.dll中的内部类型,在客户端用于数据类型的验证。如下面的代码片断所示,在构造函数中除了指定Model元数据和Controller上下文之外,还需要以字符串的形式指定验证类型(数据类型)和错误消息。

   1: internal class ClientModelValidator : ModelValidator
   2: {   
   3:     public ClientModelValidator(ModelMetadata metadata, ControllerContext controllerContext, string validationType,string errorMessage);
   4:     public sealed override IEnumerable<ModelClientValidationRule> GetClientValidationRules();
   5:     public sealed override IEnumerable<ModelValidationResult> Validate(object container);
   6: }

由于ClientModelValidator仅限于客户端验证,其Validate方法(服务端验证)总是返回一个空的ModelValidationResult集合,而GetClientValidationRules方法会根据指定的验证类型和错误消息生成相应的客户端验证规则。

ClientModelValidator具有两个继承者,分别是数值类型和日期类型进行客户端验证的NumericModelValidatorDateModelValidator。如下面的代码片断所示,这两个ClientModelValidator用于表示验证数据类型的字符串分别是“number”和“date”。而表示错误消息的字符串是从内部维护的资源文件中获取的。这实际上带来了一个问题,我们无法对错误消息进行定制

   1: internal sealed class NumericModelValidator :ClientModelValidator
   2: {    
   3:     public NumericModelValidator(ModelMetadata metadata, ControllerContext controllerContext) 
   4:     : base(metadata, controllerContext, "", ClientDataTypeModelValidatorProvider.GetFieldMustBeNumericResource(controllerContext))
   5:     {
   6:     }
   7: }
   8:  
   9: internal sealed class DateModelValidator :ClientModelValidator
  10: {
  11:     public DateModelValidator(ModelMetadata metadata, ControllerContext controllerContext) 
  12:        : base(metadata, controllerContext,  "", ClientDataTypeModelValidatorProvider.GetFieldMustBeDateResource(controllerContext))
  13:     {
  14:     }
  15: }

四、DataErrorInfoModelValidator

在System.ComponentModel命名空间下定义了一个名为IDataErrorInfo的接口,该接口提供了一种标准的错误信息定制方式。如下面的代码片断所示,IDataErrorInfo具有两个成员,只读属性Error用于获取基于自身的错误消息,而只读索引用于返回指定数据成员的错误消息。

   1: public interface IDataErrorInfo
   2: {
   3:     string Error { get; }
   4:     string this[string columnName] { get; }
   5: }

ASP.NET MVC的Model验证系统为实现了IDataErrorInfo接口的数据对象的验证定义专门的ModelValidator。具体来说,对于一个类型实现了IDataErrorInfo接口的数据对象,我们可以通过DataErrorInfoClassModelValidator对该对象本身实施验证,DataErrorInfoClassModelValidator会将Error属性表示的错误消息转换为表示验证结果的ModelValidationResult对象。而对于该对象的属性的验证则采用另一个类型为DataErrorInfoPropertyModelValidator对象,DataErrorInfoPropertyModelValidator会将属性名称作为调用索引的参数从而获得相应的错误消息,并进一步转换成ModelValidationResult对象返回。DataErrorInfoPropertyModelValidator和DataErrorInfoPropertyModelValidator都是定义在程序集System.Web.Mvc.dll中的内部类型,并不对外公布。

五、ValidatableObjectAdapter

在System.ComponentModel.DataAnnotations命名空间下定义了一个IValidatableObject接口,它代表另外一种验证的模式,我个人将其称为“自我验证”,即数据对象自行实现针对自身的验证。如下面的代码片断所示,针对自身的验证实现在IValidatableObject的Validate方法中。

   1: public interface IValidatableObject
   2: {
   3:     IEnumerable<ValidationResult> Validate(ValidationContext validationContext);
   4: }

ASP.NET Model验证系统定义了专门的ModelValidator来验证种实现了IValidatableObject接口的数据对象,其类型为ValidatableObjectAdapter。由于被验证本身已经将验证实现在了Validate方法中,所以ValidatableObjectAdapter只需要调用该方法并将验证结果从ValidationResult类型转换成ModelValidationResult类型即可。

   1: public class ValidatableObjectAdapter : ModelValidator
   2: {
   3:     public ValidatableObjectAdapter(ModelMetadata metadata, ControllerContext context);
   4:     public override IEnumerable<ModelValidationResult> Validate(object container);
   5: }

 

ASP.NET MVC以ModelValidator为核心的Model验证体系: ModelValidator
ASP.NET MVC以ModelValidator为核心的Model验证体系: ModelValidatorProvider
ASP.NET MVC以ModelValidator为核心的Model验证体系: ModelValidatorProviders


作者:蒋金楠
微信公众账号:大内老A
微博: www.weibo.com/artech
如果你想及时得到个人撰写文章以及著作的消息推送,或者想看看个人推荐的技术资料,可以扫描左边二维码(或者长按识别二维码)关注个人公众号(原来公众帐号 蒋金楠的自媒体将会停用)。
本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。
相关文章
|
29天前
|
开发框架 前端开发 JavaScript
ASP.NET MVC 教程
ASP.NET 是一个使用 HTML、CSS、JavaScript 和服务器脚本创建网页和网站的开发框架。
28 7
|
27天前
|
存储 开发框架 前端开发
ASP.NET MVC 迅速集成 SignalR
ASP.NET MVC 迅速集成 SignalR
38 0
|
2月前
|
前端开发 JavaScript
MVC中简单数据模型(M): Model类
MVC中简单数据模型(M): Model类
|
2月前
|
开发框架 前端开发 .NET
ASP.NET MVC WebApi 接口返回 JOSN 日期格式化 date format
ASP.NET MVC WebApi 接口返回 JOSN 日期格式化 date format
36 0
|
2月前
|
开发框架 前端开发 安全
ASP.NET MVC 如何使用 Form Authentication?
ASP.NET MVC 如何使用 Form Authentication?
|
2月前
|
开发框架 .NET
Asp.Net Core 使用X.PagedList.Mvc.Core分页 & 搜索
Asp.Net Core 使用X.PagedList.Mvc.Core分页 & 搜索
91 0
|
3月前
|
开发框架 JSON .NET
|
4月前
|
机器学习/深度学习 JSON 测试技术
CNN依旧能战:nnU-Net团队新研究揭示医学图像分割的验证误区,设定先进的验证标准与基线模型
在3D医学图像分割领域,尽管出现了多种新架构和方法,但大多未能超越2018年nnU-Net基准。研究发现,许多新方法的优越性未经严格验证,揭示了验证方法的不严谨性。作者通过系统基准测试评估了CNN、Transformer和Mamba等方法,强调了配置和硬件资源的重要性,并更新了nnU-Net基线以适应不同条件。论文呼吁加强科学验证,以确保真实性能提升。通过nnU-Net的变体和新方法的比较,显示经典CNN方法在某些情况下仍优于理论上的先进方法。研究提供了新的标准化基线模型,以促进更严谨的性能评估。
122 0
|
5月前
|
开发框架 前端开发 .NET
ASP.NET CORE 3.1 MVC“指定的网络名不再可用\企图在不存在的网络连接上进行操作”的问题解决过程
ASP.NET CORE 3.1 MVC“指定的网络名不再可用\企图在不存在的网络连接上进行操作”的问题解决过程
158 0
|
4月前
|
JSON 数据格式 微服务
.NET下 支持大小写不敏感的JSON Schema验证方法
有很多应用程序在验证JSON数据的时候用到了JSON Schema。 在微服务架构下,有时候各个微服务由于各种历史原因,它们所生成的数据对JSON Object属性名的大小写规则可能并不统一,它们需要消费的JSON数据的属性名可能需要大小写无关。 遗憾的是,目前的JSON Schema没有这方面的标准,标准中都是大小写敏感的。在类似上述情况下,这给使用JSON Schema进行数据验证造成了困难。
下一篇
无影云桌面