可扩展验证框架 - A2DFramework验证框架使用介绍

SUMMARY

用途
DEMO演示
NuGet相关的资料
VS工具端的设置

用途

数据验证的作用很重要，目前.NET提供的内建验证机制是采用DataAnnotation方式来实现属性的验证，并且也提供了很多验证Attribute，如下图：

不过缺点也有：

没有基于场景的验证支持
- 如订单Entity
  - 如果是PC录入，则要求验证完整的属性有效性
  - 如果是Mobile录入，则要求验证一部分属性有效性
  - 如果是后台admin录入，则要求最小属性有效性
硬编码导致不灵活
- 生产环境中的维护成本，重新编译、测试、上线
- 管理人员无法修改规则，只能通过开发部门

基于上述2点，做了些改进，填补上述缺点

DEMO演示

先建立工程，然后用NuGet工具引用A2DFramework.BusinessExceptionService:

public class OrderEntity
    {
        [Required]
        [RuleMobileAttribute("PC录入")]  //这个是A2DFramework提供的验证属性，构造函数中标明场景名
        public string FirstName { get; set; }

        public string LastName { get; set; }

        public string Mobile { get; set; }
}
class Program
    {
        static void Main(string[] args)
        {
            A2DFramework.Starter.Init();
            A2DFramework.RuleEngine.Starter.Init();
            A2DFramework.BusinessExceptionService.Starter.Init();

            OrderEntity user = new OrderEntity();
            user.FirstName = "";
            Console.WriteLine("=========无场景验证，既执行基本验证==========");
            foreach (var error in user.IsValid ())//基本验证用法，不会验证场景
            {
                string msg = string.Format("key: {0}, msg: {1}", error.Key, error.Message);
                Console.WriteLine(msg);
            }
            Console.WriteLine("==========有场景验证 [PC录入]=========");
            foreach (var error in user.IsValid("PC录入") )//场景验证方式，参数中传入场景名
            {
                string msg = string.Format("key: {0}, msg: {1}", error.Key, error.Message);
                Console.WriteLine(msg);
            }

            Console.ReadKey();
        }
    }

场景部分验证规则可硬编码在C#代码中，也可以extract到xml中:

A2D.config:
<?xml version="1.0" encoding="utf-8" ?>
<A2D>
    <BusinessExceptionService configSource ="A2D.BusinessExceptionService.config">
    </BusinessExceptionService>
</A2D>


A2D.BusinessExceptionService.config:
<?xml version="1.0" encoding="utf-8" ?>
<A2D>
    <BusinessExceptionService>
        <Scene Name="场景1">
            <EntityType Type="ConsoleApplication12.OrderEntity, ConsoleApplication12">
                <Rule RuleType="PropertyValidator " FailAction="Warning" PropertyName="LastName" ErrorMessage="LastName值不能大于10">
                    <![CDATA[
                                                                                                                value!=null&&value.length<=10 
                                                                                                                ]]></Rule>
                <Rule RuleType="ClassValidator" FailAction="Warning" ErrorMessage="FirstName与LastName不相符">
                    <![CDATA[
                                                                                                                value!=null
                                                                                                                &&value.FirstName!=null
                                                                                                                &&value.LastName!=null
                                                                                                                &&value.FirstName===value.FirstName 
                                                                                                                ]]>
                </Rule>
            </EntityType>
        </Scene>
    </BusinessExceptionService>
</A2D>