ASP.NET MVC Model验证(四)

2022-10-14 16:21:17

ASP.NET MVC Model验证(四)

前言

本篇主要讲解ModelValidatorProvider 和ModelValidator两种类型的自定义实现，前者是Model验证提供程序，而ModelValidator类型则是Model验证执行类型，在下面的示例中会使用Model验证提供程序结合Model验证执行类型来执行Model验证，就是使用上个篇幅中所讲的实现个Model绑定器继承自DefaultModelBinder类型，在自定义Model绑定器中使用ModelValidator类型。

Model验证

Model验证简单运用示例
ModelValidator使用生成过程
自定义实现DefaultModelBinder进行验证
自定义ModelValidatorProvider 和ModelValidator
ValidationAttribute特性类使用
自定义ValidationAttribute特性类的示例实现

自定义ModelValidatorProvider 和ModelValidator

ModelValidator

深呼吸一下，直接进入主题。

在我们定义自定义的ModelValidator类型之前，先看一下ModelValidator类型的定义，代码1-1.

代码1-1

    public abstract class ModelValidator
    {
        protected ModelValidator(ModelMetadata metadata, ControllerContext controllerContext);
        protected internal ControllerContext ControllerContext { get; }
        public virtual bool IsRequired { get; }
        //
        // 摘要:
        //     获取模型验证程序的元数据。
        //
        // 返回结果:
        //     模型验证程序的元数据。
        protected internal ModelMetadata Metadata { get; }
        public virtual IEnumerable<ModelClientValidationRule> GetClientValidationRules();
        public static ModelValidator GetModelValidator(ModelMetadata metadata, ControllerContext context);
        //
        // 摘要:
        //     在派生类中实现时验证对象。
        //
        // 参数:
        //   container:
        //     容器。
        //
        // 返回结果:
        //     验证结果的列表。
        public abstract IEnumerable<ModelValidationResult> Validate(object container);
    }

代码1-1中，我们可以看到ModelValidator类型的构造是可以重写的，这样便于我们自定义一些所需的数据，不过下面的示例中并没有这么做，目的是在于简单的演示，然后我们再看一下Metadata属性，这个属性非常重要了，它表示封装着所要进行验证的Model或者是Model属性的信息在此提醒大家关注一下，最后要看的就是Validate()抽象方法了，我们自定义类型必须实现的这么一个方法，在它的返回类型中有个ModelValidationResult类型，我们就来看一下ModelValidationResult类型，代码1-2.

代码1-2

    public class ModelValidationResult
    {
        public ModelValidationResult();

        // 摘要:
        //     获取或设置成员名。
        //
        // 返回结果:
        //     成员名。
        public string MemberName { get; set; }
        //
        // 摘要:
        //     获取或设置验证结果消息。
        //
        // 返回结果:
        //     验证结果消息。
        public string Message { get; set; }
    }

正如大家所看到的，代码1-2没啥好说的，看完本篇自然明白。

ASP.NET MVC Model验证(三)和ASP.NET MVC Model验证(一)中的示例想必有的朋友是看过了，没看过的朋友建议去快速的看一下篇幅一和篇幅三的示例部分（本篇示例的基础依赖上篇的基础部分，篇幅长度原因这里就不再次说明了），在这里我想说的是Model验证也是分级别的，就是上篇中也有提到过的Model级验证和Model属性级验证，在下面的示例中，我把上篇篇幅中的验证过程拆成三个部分（可以写在一起，便于理解）。

我把第一个部分定义为Model属性级验证，我们来看一下示例代码1-3。

代码1-3

public class MyCustomModelPropertyValidator : ModelValidator
    {
        public MyCustomModelPropertyValidator(ModelMetadata modelMetadata, ControllerContext controllContext)
            : base(modelMetadata, controllContext)
        { }

        public override IEnumerable<ModelValidationResult> Validate(object container)
        {
            switch (Metadata.PropertyName)
            {
                case "ID":
                    if (string.IsNullOrEmpty((string)container) || (string)container == "")
                    {
                        return new ModelValidationResult[]
                            { 
                               new ModelValidationResult()
                               {
                                   MemberName="ID",
                                   Message= "请输入ID，ID不能为空!"
                               }
                            };
                    }
                    break;
                case "UserID":
                    if (string.IsNullOrEmpty((string)container) || (string)container == "")
                    {
                        return new ModelValidationResult[]
                            { 
                               new ModelValidationResult()
                               {
                                   MemberName="UserID",
                                   Message= "请输入用户账户，用户账户不能为空！"
                               }
                            };
                    }
                    break;
                case "Password1":
                    if (string.IsNullOrEmpty((string)container) || (string)container == "")
                    {
                        ControllerContext.Controller.TempData.Add("Password1", false);
                        return new ModelValidationResult[]
                            { 
                               new ModelValidationResult()
                               {
                                   MemberName="Password1",
                                   Message= "请输入登录密码,登录密码不能为空!"
                               }
                            };
                    }
                    break;
                case "Password2":
                    if (string.IsNullOrEmpty((string)container) || (string)container == "")
                    {
                        ControllerContext.Controller.TempData.Add("Password2", false);
                        return new ModelValidationResult[]
                            { 
                               new ModelValidationResult()
                               {
                                   MemberName="Pssword2",
                                   Message= "请再次输入密码，密码不能为空!"
                               }
                            };
                    }
                    break;
                case "Name":
                    return Enumerable.Empty<ModelValidationResult>();

            }
            return Enumerable.Empty<ModelValidationResult>();
        }
    }

首先我们在代码1-3中定义了个MyCustomModelPropertyValidator类型，并且定义了构造函数这点非常重要（看到Model验证提供程序部分就明白了），在Validate()方法中对一些属性进行了基本的的验证，并且依据方法所约束的返回类型去返回，对于代码的实现部分，看过上篇的朋友就知道了在默认的Model绑定器执行Model属性绑定的时候会进行Model属性验证，会在遍历中循环的调用这个MyCustomModelPropertyValidator类型的验证方法，这里有不明白的朋友可以去看一下上篇。

我们再来看第二部分，第二部分的主要验证是验证两次输入的密码是否是相同的，来看示例代码1-4。

代码1-4

public class MyCustomModelPassWordValidator : ModelValidator
    {
        public MyCustomModelPassWordValidator(ModelMetadata modelMetadata, ControllerContext controllerContext)
            : base(modelMetadata, controllerContext)
        { }

        public override IEnumerable<ModelValidationResult> Validate(object container)
        {
            Models.RegistrationInformation regInfo = Metadata.Model as Models.RegistrationInformation;
            if (regInfo != null)
            {
                if (!ControllerContext.Controller.TempData.ContainsKey("Password1")
                    && !ControllerContext.Controller.TempData.ContainsKey("Password2"))
                {
                    if (regInfo.Password1 != regInfo.Password2)
                    {
                        return new ModelValidationResult[]
                        {
                            new ModelValidationResult()
                            {
                                MemberName="Password2",
                                Message="请重新输入密码，与上次输入密码不同！"
                            }
                        };
                    }
                }
            }
            return Enumerable.Empty<ModelValidationResult>();
        }
    }

在代码1-4中，有细心的朋友发现了跟代码1-3的实现方式有很大的区别，对的因为我把这个MyCustomModelPassWordValidator类型定义为Model级验证了，MyCustomModelPassWordValidator类型所被调用的位置是在默认Model绑定器对Model属性验证完毕并且进行绑定了过后，再在默认Model绑定器的OnModelUpdated()方法中调用的，所以上述可以直接通过Metadata的Model属性直接获取Model的值，由此来进行验证，而这句ControllerContext.Controller.TempData.ContainsKey("Password1")代码的含义是判断在Model的Password1属性在属性级验证的时候是否通过了，因为每个Model验证器之间无法传递消息，只有ControllerContext是指向一个引用的，所有用它来做数据信息的承载。在代码1-3中已经定义了。（对于第二部分的理解不太明白的朋友可以结合上篇和本篇来看）

现在我们再看第三部分，意思和第二部分一样，示例代码1-5。

代码1-5

public class MyCustomModelNameValidator : ModelValidator
    {
        public MyCustomModelNameValidator(ModelMetadata modelMetadata, ControllerContext controllerConttext)
            : base(modelMetadata, controllerConttext)
        { }

        public override IEnumerable<ModelValidationResult> Validate(object container)
        {
            Models.RegistrationInformation regInfo = Metadata.Model as Models.RegistrationInformation;
            if (regInfo != null)
            {
                if (string.Compare(regInfo.Name, "jinyuan", true) == 0)
                {
                    return new ModelValidationResult[] 
                    {
                        new ModelValidationResult()
                        {
                            MemberName="",
                            Message="您输入的名称违法了，立即更改不然查水表"
                        }
                    };
                }
            }
            return Enumerable.Empty<ModelValidationResult>();
        }
    }

代码1-5的功能就是在Model级验证时对Model的Name属性进行验证。

ModelValidatorProvider

上个小节定义了三个部分，第一部分为Model属性级验证，二三部分皆为Model级验证，然而在默认的Model绑定器（DefaultModelBinder类型）执行的时候，它才不管呢，它只负责从ModelValidatorProviders.Providers中获取我们自定义的Model验证器提供程序（ModelValidatorProvider类型实例），再由Model验证器提供程序给它提供Model验证器，这个时候就需要我们的自定义的Model验证器提供程序具有判断我们自身是在哪里被调用的，并且返回对应的Model验证器，来看示例代码1-6。

代码1-6

namespace MvcApplication.ModelValidators
{
    public class MyCustomModelValidatorProvider:ModelValidatorProvider
    {
        public override IEnumerable<ModelValidator> GetValidators(ModelMetadata metadata, ControllerContext context)
        {
            if (metadata.ContainerType == typeof(Models.RegistrationInformation))
            {
                return new ModelValidator[]
                {
                    new MyCustomModelPropertyValidator(metadata,context)
                };
            }
            else if (metadata.ModelType == typeof(Models.RegistrationInformation))
            {
                return new ModelValidator[] 
                {
                    new MyCustomModelPassWordValidator(metadata,context),
                    new MyCustomModelNameValidator(metadata,context)
                };
            }
            return Enumerable.Empty<ModelValidator>();
        }
    }
}

在代码1-6中，我们定义了个自定义的Model验证器提供程序MyCustomModelValidatorProvider类型，在MyCustomModelValidatorProvider类型中是根据GetValidators()方法的参数metadata所包含的信息来判断自己被默认的Model绑定器（DefaultModelBinder类型）调用的位置。（对于Model元数据部分大家可查看我前面跟大家分享的Model元数据系列）

到了这里几乎就已经全部完成了，现在注册到系统中是不能使用的，有的朋友会骂了，不能用瞎扯蛋扯半天，大家莫急，听我解释，是因为我们自定义的Model验证器和Model验证器提供程序都要受到MVC框架的默认的Model绑定器（DefaultModelBinder类型）调用的约束，是必须按照它方法内部定义的来往下写，在这里我们不图省事，再定义一个自定义实现DefaultModelBinder类型的Model绑定器，来看示例代码1-7。

代码1-7

    public class MyCustomModelValidatorDefaultModelBinder : DefaultModelBinder
    {
        protected override void SetProperty(ControllerContext controllerContext, ModelBindingContext bindingContext, PropertyDescriptor propertyDescriptor, object value)
        {
            base.SetProperty(controllerContext, bindingContext, propertyDescriptor, value);
            foreach (ModelValidator modelValidator in ModelValidatorProviders.Providers.GetValidators(bindingContext.PropertyMetadata[propertyDescriptor.Name], controllerContext))
            {
                IEnumerable<ModelValidationResult> modelValidationResults = modelValidator.Validate(value);
                foreach (ModelValidationResult modelValidationResult in modelValidationResults)
                {
                    bindingContext.ModelState.AddModelError(modelValidationResult.MemberName, modelValidationResult.Message);
                }
            }

        }
        protected override void OnModelUpdated(ControllerContext controllerContext, ModelBindingContext bindingContext)
        {
            //base.OnModelUpdated(controllerContext, bindingContext);
            foreach (ModelValidator modelValidator in ModelValidatorProviders.Providers.GetValidators(bindingContext.ModelMetadata, controllerContext))
            {
                IEnumerable<ModelValidationResult> modelValidationResults = modelValidator.Validate(null);
                foreach (ModelValidationResult modelValidationResult in modelValidationResults)
                {
                    bindingContext.ModelState.AddModelError(modelValidationResult.MemberName, modelValidationResult.Message);
                }
            }
        }
    }

有了代码1-7中的Model绑定器就可以吻合我们前面所定义的Model验证器以及提供程序了。

我要把MyCustomModelValidatorProvider类型和MyCustomModelValidatorDefaultModelBinder类型注册到系统中，将示例代码1-8部分添加至Global.asax文件的Application_Start()方法中。

代码1-8

ModelBinders.Binders.Add(typeof(Models.RegistrationInformation), new Binders.MyCustomModelValidatorDefaultModelBinder());
ModelValidatorProviders.Providers.Insert(0, new ModelValidators.MyCustomModelValidatorProvider());

看下图1，图1为初始的展示页面，图2为图1中点击提交后执行验证过后。

图1