采用一个自创的"验证框架"实现对数据实体的验证[改进篇]

2018-02-08 13:34:23 浏览数 (1)

自《编程篇》和《设计篇》发布以来,收到了一些反馈。尤其是园友双鱼座提到.NET 3.5下的System.ComponentModel.DataAnnotations命名空间具有相似的实现,并且通过“表达式”的方式实现了CompositeValidator的服务逻辑判断的功能。为此,我对这个“验证框架”进行了相应的改进,让CompositeValidator具有了解析“验证表达式”的能力。为了让大家对此改进又一个深刻的认识,我们来对比之下对于同一个验证规则,改进前后有何不同。[源代码从这里下载]

一、改进前如何使用CompositeValidator?

改进前的CompositeValidator仅仅提供对两种基本逻辑运算(“析取”和“或取”)的支持,他们分别通过两个具体的CompositeValidator实现,即AndCompositeValidator和OrCompositeValidator。那么对于一些相对复杂的验证规则,应用在属性上的ValidatorAttribute或者ValidatorElementAttribute有可能需要很多,将使我们的代码显得非常臃肿。通过采用《编程篇》中的“找对象”的例子,如果对年龄具有这样的要求:年龄要么在18到25周岁之间,要么在40岁到50周岁之间,对于这段不算太复杂的验证规则,我们需要在Age属性上添加如下7个特性。

代码语言:js复制
   1: public class Mate
   2: {
   3:     private const string messageTemplate   = "通过属性{PropertyName}表示的{Tag}要么在18到25周岁之间,要么在40到50周岁之间。 当前{Tag}为{PropertyValue}周岁!";
   4:    
   5:     [OrCompositeValidator(messageTemplate,"between18And25,between40And50",Tag = "年龄")]
   6:     [AndCompositeValidatorElement("between18And25", "greaterThan18,lessThan25")]
   7:     [AndCompositeValidatorElement("between40And50", "greaterThan40,lessThan50")]
   8:     [GreaterThanValidatorElement("greaterThan18", 18)]
   9:     [GreaterThanValidatorElement("greaterThan40", 40)]
  10:     [LessThanValidatorElement("lessThan25", 25)]
  11:     [LessThanValidatorElement("lessThan50", 50)]
  12:     public int Age { get; set; }
  13:  
  14:     public Mate(int age)
  15:     {
  16:         this.Age = age;
  17:     }
  18: }

采用《编程篇》中定义的辅助方法Validate,我们通过如下的代码对具有不同Age属性值的Mate对象实施验证。对于不同的年龄——16(不符合要求)、20(符合要求)、28(不符合要求)、45(符合要求)和60(不符合要求),分别具有不同的验证结果。

代码语言:js复制
   1: static void Main(string[] args)
   2: {
   3:     var mate = new Mate(16);
   4:     Validate<Mate>(mate);
   5:  
   6:     mate.Age = 20;
   7:     Validate<Mate>(mate);
   8:  
   9:     mate.Age = 28;
  10:     Validate<Mate>(mate);
  11:  
  12:     mate.Age = 45;
  13:     Validate<Mate>(mate);
  14:  
  15:     mate.Age = 60;
  16:     Validate<Mate>(mate);
  17: }

输出结果:

1: 验证失败!

2: 通过属性Age表示的年龄要么在18到25周岁之间,要么在40到50周岁之间。 当前年龄为16周岁!

3: 验证成功!

4: 验证失败!

5: 通过属性Age表示的年龄要么在18到25周岁之间,要么在40到50周岁之间。 当前年龄为28周岁!

6: 验证成功!

7: 验证失败!

8: 通过属性Age表示的年龄要么在18到25周岁之间,要么在40到50周岁之间。 当前年龄为60周岁!

二、在新的CompositeValidator中使用表达式来定义验证规则

如果你采用改进后的验证框架,上面的验证规则可以通过表达式的形式直接写在CompositeValidatorAttribute特性中,下面的代码为你展示了相应的采用改进后的CompositeValidator的Mate类型该如果定义。从中我们可以看出,上述的验证规则对应的表达式为:(V: greaterThan18 AND V: lessThan25) OR (V: greaterThan40 AND V: lessThan50),不但直观而且简洁。在这段表达式中通过“V:{ValidatorElementName}” 表示相应ValidatorElement最终的验证结果(True或者False)。“V: greaterThan18 ”表示应用在Age属性上名称为greaterThan18的GreaterThanValidatorElementAttribute对应的GreaterThanValidator对Age属性值最终的验证结果。目前为止,验证规则对应的表达式支持三种基本的逻辑操作:AND、OR和NOT,这三个操作符结合括号将会使你的验证表达式具有很强的表达能力。如果还不够,你甚至可以定义更多的逻辑操作符。

代码语言:js复制
   1: public class Mate
   2: {
   3:     private const string messageTemplate = "通过属性{PropertyName}表示的{Tag}要么在18到25周岁之间, 要么在40到50周岁之间。 当前{Tag}为{PropertyValue}。";
   4:  
   5:     [CompositeValidator(messageTemplate, "(V: greaterThan18 AND V: lessThan25) OR (V: greaterThan40 AND V: lessThan50)",Tag ="年龄")]
   6:     [GreaterThanValidatorElement("greaterThan18", 18)]
   7:     [LessThanValidatorElement("lessThan25", 25)]
   8:     [GreaterThanValidatorElement("greaterThan40", 40)]
   9:     [LessThanValidatorElement("lessThan50", 50)]
  10:     public int Age { get; set; }
  11:  
  12:     public Mate(int age)
  13:     {
  14:         this.Age = age;
  15:     }
  16: }

三、最新的CompositeValidator作了哪些改变?

在之前的版本中,CompositeValidator是一个抽象类,我们需要定义继承自该类的具体的CompositeValidator来完成相应的逻辑运算,比如AndCompositeValidator和OrCompositeValidator。在新的版本中,CompositeValidator本身就是一个可以用于验证的Validator。我们为它指定一个验证表达式,它自己可以对表达式进行解析,并调用相应的ValidatorElement实施单一验证。最终将这些单一验证结果按照表达式定义的逻辑关系,得到一个最终的结果。最新的CompositeValidator定义如下:

代码语言:js复制
   1: public  class CompositeValidator:Validator
   2: {
   3:     public string ValidationExpression { get; private set; }
   4:     public ExpressionParser ExpressionParser { get; private set; }
   5:     public IEnumerable<Validator> Validators { get; private set; }
   6:  
   7:     public CompositeValidator(string messageTemplate, string validationExpression,IEnumerable<Validator> validators):base(messageTemplate)
   8:     {
   9:         Guard.ArgumentNotNullOrEmpty(validationExpression, "validationExpression");
  10:         Guard.ArgumentNotNull(validators, "validators");
  11:         this.ValidationExpression = validationExpression;
  12:         this.Validators = validators;
  13:         this.ExpressionParser = new ExpressionParser(validators);
  14:     }
  15:     public override ValidationError Validate(object objectToValidate)
  16:     {
  17:         if (this.ExpressionParser.Parse(this.ValidationExpression).Evaluate(objectToValidate))
  18:         {
  19:             return null;
  20:         }
  21:         else
  22:         {
  23:             return this.CreateValidationError(objectToValidate);
  24:         }
  25:     }
  26: }

通过可以看到,CompositeValidator多了两个只读属性:ValidationExpression和ExpressionParser,分别表示验证表达式和表达式解析器(Parser)。那么在Validate方法中,直接调用ExpressionParser的Parse方法会得到一个自定义的BooleanExpression对象,直接调用该对象的Evaluate方法并传入验证对象作为参数,就可以得到最终的验证结果。

CompositeValidatorAttribute随着CompositeValidator的改进也作了相应的变化。只要是提供了一个表示验证表达式的ValidationExpression的属性,该属性在构造函数中指定。和之前的版本一样,CompositeValidatorAttribute不得不采用显式指定ValidatorElment列表的方式(调用CreateCompositeValidator方法来创建CompositeValidator对象)。

代码语言:js复制
   1: public class CompositeValidatorAttribute : ValidatorAttribute
   2: {
   3:     public string ValidationExpression { get; private set; }
   4:     public CompositeValidatorAttribute(string messageTemplate, string validationExpression)
   5:         : base(messageTemplate)
   6:     {
   7:         Guard.ArgumentNotNullOrEmpty(validationExpression, "validationExpression");
   8:         this.ValidationExpression = validationExpression;
   9:         
  10:     }
  11:     public CompositeValidator CreateCompositeValidator(IEnumerable<Validator> validators)
  12:     {
  13:         return new CompositeValidator(this.MessageTemplate, this.ValidationExpression, validators);
  14:     }
  15:     public override Validator CreateValidator()
  16:     {
  17:         throw new NotImplementedException();
  18:     }
  19: }

对于ExpressionParser得实现,我是借鉴了EnterLib安全模块的Authorization表达式的解析方法。由于逻辑稍微有点复杂,有兴趣的朋友可以分析一下EnterLib的源码,也可以直接下载本验证框架的源代码分析表达式解析的逻辑。

四、最终的验证逻辑变得简单

表达式的引入使CompositeValidator和它们ValidatorElement变成是纯粹的两层关系(原来还有一个CompositeValidatorElement的概念),免去了复杂的递归逻辑操作。我将所有的代码写在下面,里面主要涉及到的逻辑就是如果得到某个属性相匹配的Validator。为了避免频繁的反射和对Validator的创建,我参数了缓存机制。不过代码行数还是不少,如果对此真的感兴趣的话还是下载源代码吧。

代码语言:js复制
   1: public static class Validation
   2: {
   3:     private static Dictionary<NamedProperty, IEnumerable<Validator>> validators = new Dictionary<NamedProperty, IEnumerable<Validator>>();
   4:     private static Dictionary<NamedProperty, IEnumerable<Validator>> validatorElements = new Dictionary<NamedProperty, IEnumerable<Validator>>();
   5:  
   6:     private static IEnumerable<Validator> GetValidators(string ruleName, PropertyInfo property)
   7:     {
   8:         var key = new NamedProperty(ruleName, property);
   9:         if (validators.ContainsKey(key))
  10:         {
  11:             return validators[key];
  12:         }
  13:         lock (typeof(Validation))
  14:         {
  15:             if (validators.ContainsKey(key))
  16:             {
  17:                 return validators[key];
  18:             }
  19:             validators[key] = DoGetValidators(ruleName,property);
  20:             return validators[key];
  21:         }
  22:     }
  23:  
  24:     private static IEnumerable<Validator>  GetValidatorElements(string ruleName, PropertyInfo property)
  25:     {
  26:          var key = new NamedProperty(ruleName, property);
  27:          if (validatorElements.ContainsKey(key))
  28:         {
  29:             return validatorElements[key];
  30:         }
  31:         lock (typeof(Validation))
  32:         {
  33:             if (validatorElements.ContainsKey(key))
  34:             {
  35:                 return validatorElements[key];
  36:             }
  37:             validatorElements[key] = DoGetValidatorElements(ruleName, property);
  38:             return validatorElements[key];
  39:         }
  40:     }
  41:  
  42:     private static IEnumerable<Validator> DoGetValidatorElements(string ruleName, PropertyInfo property)
  43:     {
  44:         foreach (ValidatorElementAttribute attribute in property.GetCustomAttributes(typeof(ValidatorElementAttribute), true))
  45:         {
  46:             yield return attribute.CreateValidator();
  47:         }
  48:     }
  49:  
  50:     private static IEnumerable<Validator> DoGetValidators(string ruleName, PropertyInfo property)
  51:     {
  52:         var validatorAttributes = new List<ValidatorAttribute>();
  53:  
  54:         foreach (var attribute in property.GetCustomAttributes(typeof(ValidatorAttribute), true))
  55:         {
  56:             ValidatorAttribute validatorAttribute = (ValidatorAttribute)attribute;
  57:             if (validatorAttribute.RuleName == ruleName)
  58:             {
  59:                 validatorAttribute.FormatMessage(property);
  60:                 validatorAttributes.Add(validatorAttribute);
  61:             }
  62:         }
  63:  
  64:         foreach (var attribute in validatorAttributes)
  65:         {
  66:             if (attribute is CompositeValidatorAttribute)
  67:             {
  68:                 yield return ((CompositeValidatorAttribute)attribute).CreateCompositeValidator(GetValidatorElements(ruleName, property));
  69:             }
  70:             else
  71:             {
  72:                 yield return attribute.CreateValidator();
  73:             }
  74:         }
  75:     }
  76:  
  77:     public static bool Validate(object value, out IEnumerable<ValidationError> validationErrors)
  78:     {
  79:         return Validate(value,string.Empty, out validationErrors);
  80:     }
  81:  
  82:     public static bool Validate(object value, string ruleName, out IEnumerable<ValidationError> validationErrors)
  83:     {
  84:         validationErrors = new List<ValidationError>();
  85:         Guard.ArgumentNotNull(value, "value");
  86:         foreach (var property in value.GetType().GetProperties())
  87:         {
  88:             var validators = GetValidators(ruleName, property);
  89:             if (validators.Count() > 0)
  90:             {
  91:                 var propertyValue = property.GetValue(value, null);
  92:                 foreach (var validator in validators)
  93:                 {
  94:                     validator.FormatMessage(propertyValue);
  95:                     var error = validator.Validate(propertyValue);
  96:                     if (null != error)
  97:                     {
  98:                         ((List<ValidationError>)validationErrors).Add(error);
  99:                     }
 100:                 }
 101:             }
 102:         }
 103:         return validationErrors.Count() == 0;
 104:     }
 105: }
 106:  
 107: internal class NamedProperty
 108: {
 109:     public string RuleName { get; set; }
 110:     public PropertyInfo Property { get; set; }
 111:  
 112:     public NamedProperty(string name, PropertyInfo property)
 113:     {
 114:         this.RuleName = name ?? string.Empty;
 115:         Guard.ArgumentNotNull(property, "property");
 116:         this.Property = property;
 117:     }
 118:  
 119:     public override int GetHashCode()
 120:     {
 121:         return this.RuleName.GetHashCode() ^ this.Property.GetHashCode();
 122:     }
 123: }

采用一个自创的"验证框架"实现对数据实体的验证[编程篇] 采用一个自创的"验证框架"实现对数据实体的验证[设计篇] 采用一个自创的"验证框架"实现对数据实体的验证[改进篇] 采用一个自创的"验证框架"实现对数据实体的验证[扩展篇]

0 人点赞