浅谈在ASP.NET MVC3中使用IClientValidatable接口实现客户端和服务器端同时验证

从ASP.NET MVC2开始,MVC新增了元数据级别的验证,例如:Range、RegularExpression、Required、StringLength等验证属性,这些属性极大的方便了服务器端的验证,同时我们还可以自定义验证属性来满足我们特殊的需求,MVC3的出现进一步提升了验证的便捷性,具体体现在,新增了IValidatableObject和IClientValidatable接口,以及默认支持Range、RegularExpression、Required、StringLength等验证属性在客户端和服务器端进行验证。

IValidatableObject接口,网上已经有很多的资料了,今天我主要介绍IClientValidatable这个接口,IClientValidatable 接口允许 ASP.NET MVC 在运行时发现支持的客户端验证器,这个接口被用来支持集成不同的验证框架——摘自:ASP.NET MVC3概述。

下面我们就来看看如何使用IClientValidatable接口来实现客户端和服务器端的验证。

首先我们来自定义一个验证属性NoIsAttribute.cs,该属性的主要作用是验证用户名中不能含有指定的字符串,代码如下:

public sealed class NoIsAttribute:ValidationAttribute
    {
        public string InputString { get; set; }
        public NoIsAttribute()
        {
            ErrorMessage = "验证失败";
        }

        public override bool IsValid(object value)
        {
            if (value == null)
                return true;
            string inputString = (string)value;
            if (inputString.Contains(InputString))
            {
                return false;
            }
            return true;
        }
    }


下面我们来创建一个实体类Logon.cs

public class Logon
    {
        [DisplayName("年龄")]
        [Range(6,100)]
        public int Age { get; set; }

        [DisplayName("姓名")]
        [NoIs(InputString="卜俊生",ErrorMessage="用户名不能含有卜俊生")]
        public string Name { get; set; }

    }


在Logon.cs中我们对Name属性应用了Nois验证属性,这样用户在登录过程中如果输入了包含“卜俊生”,那么将无法通过验证,不过该属性只能当用户将数据提交到服务器后才能对数据进行验证,(其中Age属性应用了Range验证属性,因为asp.net mvc3默认支持对range进行客户端验证,所以当用户输入年龄后,如果年龄不符合要求则在客户端进行验证。),为了让NoIs验证属性也能在客户端进行验证,我们就需要将NoIsAttribute.cs实现IClientValidatable接口,所以我们要改造我们的NoIsAttribute.cs代码。

public sealed class NoIsAttribute:ValidationAttribute,IClientValidatable
    {
        public string InputString { get; set; }
        public NoIsAttribute()
        {
            ErrorMessage = "验证失败";
        }
        public IEnumerable<ModelClientValidationRule> GetClientValidationRules(ModelMetadata metadata, ControllerContext context)
        {
            ModelClientValidationRule rule = new ModelClientValidationRule
            {
                ValidationType = "nois",
                ErrorMessage = FormatErrorMessage(metadata.GetDisplayName())
            };
            rule.ValidationParameters["inputstring"] = InputString;
            yield return rule;
        }

        public override bool IsValid(object value)
        {
            if (value == null)
                return true;
            string inputString = (string)value;
            if (inputString.Contains(InputString))
            {
                return false;
            }
            return true;
        }
    }

IClientValidatable 接口很简单,他只有一个GetClientValidationRules()方法,我们只要实现这个方法就可以了,这个方法包括两个参数,metadata表示要验证的属性的元数据,context表示发送请求的Controller的上下文,并且它返回一个ModelClientValidationRule集合。

我们先来看看这段代码:

ModelClientValidationRule rule = new ModelClientValidationRule
            {
                ValidationType = "nois",
                ErrorMessage = FormatErrorMessage(metadata.GetDisplayName())
            };

这段代码是创建一个ModelClientValidationRule对象,并且为其两个属性赋值,其中ValidationType是验证类型(客户端代码需要调用该属性),ErrorMessage是错误信息。

让后我们再来看看下面这句代码:

rule.ValidationParameters["inputstring"] = InputString;

这句代码的意思是添加一个验证属性”inputstring”,它的值是InputString,需要注意的是ValidationParameters是一个IDictionary<string,object>字典,最重要的是ValidationParameters的key必须是小写的,不能包含任何大写字母,否则运行时会报错,请一定要谨记。

IClientValidatable.cs完成后,我们还需要编写客户端代码才能实现客户端和服务器端同时验证。

默认情况下asp.net mvc3已经开启了客户端验证和隐藏验证,这一点我们可以在web.config中查看

<appSettings>
    <add key="ClientValidationEnabled" value="true"/> 
    <add key="UnobtrusiveJavaScriptEnabled" value="true"/> 
  </appSettings>


那么默认情况下asp.net mvc3使用jquery的Validate插件进行客户端验证,所以你会在View文件中看见图下代码

<script src="@Url.Content("~/Scripts/jquery.validate.min.js")" type="text/javascript"></script>
<script src="@Url.Content("~/Scripts/jquery.validate.unobtrusive.min.js")" type="text/javascript"></script>


下面我们就要为validate插件编写自定义验证规则,并将规则添加到unobtrusive中,代码如下:

<script type="text/javascript">
    $.validator.addMethod("nois", function (value, element, param) {
        if (value == false) {
            return true;
        }
        if (value.indexOf(param) != -1) {
            return false;
        }
        else {
            return true;
        }

    });
    $.validator.unobtrusive.adapters.addSingleVal("nois","inputstring");
</script>



如要注意的是addMethod这个函数的第一个参数值必须和IClientValidatable.cs中的ValidationType的值必须一致,都必须是”nois”,还有就是 $.validator.unobtrusive.adapters.addSingleVal("nois","inputstring"); 这一句中的第二个参数值要和ValidationParameters的key的值相同,必须是“inputstring“。

这样就可实现客户端和服务器端同时验证了,有兴趣的朋友可以试下。

源码下载

posted on 2011-01-24 01:12  卜俊生  阅读(3723)  评论(6编辑  收藏  举报