c#网站用特性来实现数据校验实例

作者:袖梨 2022-06-25

客户端的校验一般由js来完成,本文主要介绍利用特性完成服务器端的数据校验。

什么是特性?

超市中有各种各样的商品,商品上贴有标签。标签上可能有商品的名称,价格,种类等信息。我们要购买一样东西前,一般先会看标签,了解更多的信息。当然主要是价格,万一钱没带够呢?:)
如果把类当做商品,那么特性就是贴在商品上的标签。特性给我们提供了更多类相关的信息。[Serializable] 就是在C#中常用的一个系统的特性,通过这个特性,我们可以知道类是否允许被序列化。


特性验证简单Demo

我们已经了解了特性,那么如何用特性校验数据呢?
假设用户注册后,通过客户端的校验后,将用户名和密码传输到了服务器。我们先验证用户名不为空,怎么做呢?
理一下思路,我们可以分3步来完成这件事情:
1、声明一个自定义特性。
2、给用户类添加自定义特性。
3、通过特性实现对数据的校验。

声明一个自定义特性。


[AttributeUsage(AttributeTargets.Property)]
class RequiredAttribute : Attribute
{
    /// 
    /// 验证失败返回的错误信息
    /// 
    public string ErrorMessage
    {
        get;
        set;
    }
    /// 
    /// 输入值
    /// 
    public object InputValue
    {
        get;
        set;
    }
    /// 
    /// 验证规则
    /// 
    /// 验证失败返回的错误信息
    public RequiredAttribute(string errorMessage)
    {
        this.ErrorMessage = errorMessage;
    }
    /// 
    /// 接口参数为空或空字符串都返回false
    /// 
    /// 
    public  bool Validate()
    {
        return !string.IsNullOrEmpty(InputValue.ToString());
    }
}

 
自定义特性必须继承Attribute类,[AttributeUsage(AttributeTargets.Property)]特性表示,我们自定义的特性,只允许添加到类的属性上。Validate()方法就是这个特性的核心逻辑,他的功能很简单,验证用户输入的值是否为空。 这个值从哪儿来呢?别急,我们一步步来。


给用户类添加自定义特性


public class User
{
    [Required("请输入用户名")]
    public string UserName { get; set; }
    public string PassWord { get; set; }
}


特性可添加在类,属性,方法,字段上。这里添加到属性上是因为我们仅需要对属性的值进行校验,且我们自定义特性时声明了特性只能添加到属性上。 [Required("请输入用户名")],我们发现特性声明就是对特性类进行实例化,圆括弧中需要传入的参数,就是我们声明构造函数时的参数。其实自定义特性就相当于超市中用于贴标签的机器。
通过特性实现对数据的校验。

我们通过读商品的标签就可以知道商品的信息,然后决定是不是要买。同样用户类中的特性也需要一个人来读,我们肯定读不了这个特性,那么找谁来做呢?没错,反射。

public string Validate()
{
    // 反射取当前对象的所有属性
    System.Reflection.PropertyInfo[] properties = this.GetType().GetProperties();
    foreach (var pInfo in properties)
    {
        // 取属性中的特性
        if (pInfo.IsDefined(typeof(RequiredAttribute),false))
        {
            var customAttributes =
                pInfo.GetCustomAttributes(typeof (RequiredAttribute), false) as RequiredAttribute[];
            // 根据特性进行参数验证
            foreach (var attribute in customAttributes)
            {
                // 初始化特性,并进行验证。
                var validateVal = pInfo.GetValue(this, null);
                attribute.InputValue = validateVal;
                if (!attribute.Validate())
                {
                    return "验证失败!消息:" + attribute.ErrorMessage;
                }
            }
        }   
    }
    // 验证成功
    return "验证成功!";
}



代码的注释已经很清楚了,就不在解释代码了。
还记得我们前面有个问题:用户输入的值的初始化问题么?其实值就是反射取属性的值,交给我们的特性。

总结

到这儿我们再回头看整个特性验证的过程其实很简单。原来我们验证是每来一个数据都自己写单独的逻辑去验证。而现在,我们将验证的逻辑封装到特性内,哪个数据需要就添加这个特性。数据校验时,我们只需反射用特性来做校验就可以了。再打个比方:我们在小摊上买东西的时候,每种商品我们都需去询问摊主,这个买多少钱啊?而超市给每种商品都贴上了标签,明码标价。

相关文章

精彩推荐