.NET RulesEngine(规则引擎)的使用详解

一次偶然的机会,让我拿出RulesEngine去完成一个业务,对于业务来说主要是完成一个可伸缩性(不确定的类型,以及不确定的条件,条件的变动可能是持续增加修改的)的业务判断。比如说完成一个成就系统,管理员可创建,对于成就来说有一次性解锁、日常、周常式,还有随时重置,每次达成都触发的,面对着成就任务的增加,那对于程序员来说,如果每次都去增加修改这些成就任务简直是太头疼了。好了,对此大家应该有一个简单的了解了,那跟着笔者往下走,我们看看如何在.NET中使用非常少的代码去完成一个简单的动态逻辑处理。

RulesEngine 概述

RulesEngine是Microsoft推出的一个规则引擎项目,用于系统中抽象出的业务逻辑/规则/策略。在我们开发的过程中,避免不了的是跟这种反反复复的业务逻辑进行处理,而对于这种动态的规则来说的话,它是比较优雅的一种方式,使用我们减少了对我们代码或者说项目的修改。

如何使用

目前我们可以通过nuget的形式进行引入该库,如下所示:

dotnet add package RulesEngine

对于规则的配置来说,大家可以直接通过类型化参数,笔者主要是为了大家可以清晰的明白,所以用JSON化配置来做演示。

//反序列化Json格式规则字符串 var workflowRules = JsonConvert.DeserializeObject<List<WorkflowRules>>(rulesStr); var rulesEngine = new RulesEngine.RulesEngine(workflowRules.ToArray());

//定义规则 var rulesStr = @"[{ ""WorkflowName"": ""UserInputWorkflow"", ""Rules"": [ { ""RuleName"": ""CheckAge"", ""ErrorMessage"": ""年龄必须大于18岁."", ""ErrorType"": ""Error"", ""RuleExpressionType"": ""LambdaExpression"", ""Expression"": ""Age > 18"" }, { ""RuleName"": ""CheckIDNoIsEmpty"", ""ErrorMessage"": ""身份证号不可以为空."", ""ErrorType"": ""Error"", ""RuleExpressionType"": ""LambdaExpression"", ""Expression"": ""IdNo != null"" } ] }] ";

如上所示我们定义了规则信息,对于该信息,对于规则信息笔者默认存储的还是JSON数据,当然大家可以进行存储如下内容,将如下数据结构拆分存储到数据库中。

属性 描述
RuleName   规则名称  
Properties   规则属性,获取或设置规则的自定义属性或者标记  
Operator   操作符  
ErrorMessage   错误消息  
Enabled   获取和设置规则是否已启用  
RuleExpressionType   规则表达式类型,默认为LambdaExpression,当然目前只有这么一个  
WorkflowRulesToInJect   注入工作流程规则  
Rules   规则  
LocalParams   本地参数  
Expression   表达树  
Actions    
SuccessEvent   完成事件,默认为规则名称  

我们来看一下该代码产生的结果,对于该内容笔者创建了一个类,如下所示:

public class UserInput { public string IdNo { get; set; } public int Age { get; set; } }

static async Task Main(string[] args) { var userInput = new UserInput { IdNo = null, Age = 18 }; //反序列化Json格式规则字符串 var workflowRules = JsonConvert.DeserializeObject<List<WorkflowRules>>(rulesStr); var rulesEngine = new RulesEngine.RulesEngine(workflowRules.ToArray()); List<RuleResultTree> resultList = await rulesEngine.ExecuteAllRulesAsync("UserInputWorkflow", userInput); foreach (var item in resultList) { Console.WriteLine("验证成功:{0},消息:{1}",item.IsSuccess,item.ExceptionMessage); } Console.ReadLine(); }

输出结果如下所示:

验证成功:False,消息:年龄必须大于18岁.
验证成功:False,消息:身份证号不可以为空.

返回结构resultList如下所示:

{ "Rule":{ "RuleName":"CheckNestedSimpleProp","Properties":null,"Operator":null,"ErrorMessage":"年龄必须大于18岁.", "ErrorType":"Error","RuleExpressionType":"LambdaExpression","WorkflowRulesToInject":null,"Rules":null,"LocalParams":null,"Expression":"Age > 18","Actions":null,"SuccessEvent":null},"IsSuccess":false,"ChildResults":null,"Inputs":{ "input1":{ "IdNo":null,"Age":18} }, "ActionResult":{ "Output":null,"Exception":null},"ExceptionMessage":"年龄必须大于18岁.","RuleEvaluatedParams":[]}

表达树内使用扩展方法

上面相信大家对于规则引擎的使用,有了一个简单的了解,下面我们再来一个进阶版内容。

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/zyggsw.html