一次偶然的機會，讓我拿出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":[]}
表達樹內使用擴展方法
上面相信大家對于規則引擎的使用，有了一個簡單的了解，下面我們再來一個進階版內容，
比如我覺得通過輸入的年齡不準確，我想通過身份證號去計算年齡，那么我該如何操作，正常的情況下，我們會通過擴展方法，然后將身份證號引數進行傳遞給處理程式，處理程式計算完成后，會回傳給我們年齡，而在這個里面我們該如何操作呢？我們往下看，
通過ReSettings進行增加自定義型別，將擴展方法，因為它們所能使用的方法僅限于[System namespace]，所以我們需要將自定義類進行添加到設定中，
private static readonly ReSettings reSettings = new ReSettings
{
CustomTypes = new[] { typeof(IdCardUtil) }
};
修改如下內容：
var rulesEngine = new RulesEngine.RulesEngine(workflowRules.ToArray(), null, reSettings: reSettings);
var rulesStr = @"[{
""WorkflowName"": ""UserInputWorkflow"",
""Rules"": [
{
""RuleName"": ""CheckNestedSimpleProp"",
""ErrorMessage"": ""年齡必須小于18歲."",
""ErrorType"": ""Error"",
""RuleExpressionType"": ""LambdaExpression"",
""Expression"": ""IdNo.GetAgeByIdCard() < 18""
},
{
""RuleName"": ""CheckNestedSimpleProp1"",
""ErrorMessage"": ""身份證號不可以為空."",
""ErrorType"": ""Error"",
""RuleExpressionType"": ""LambdaExpression"",
""Expression"": ""IdNo != null""
}
]
}] ";
輸出結果如下所示：
驗證成功：False，訊息：年齡必須小于18歲.
驗證成功：True，訊息：
多物件組合條件
下面我們修改了一下之前的規則內容，同時又增加了一個類ListItem，我們將內容賦值之后，進行創建一個匿名型別，里面兩個屬性，user和items，最后通過我們的多條件組合進行邏輯判斷，
var rulesStr = @"[{
""WorkflowName"": ""UserInputWorkflow"",
""Rules"": [
{
""RuleName"": ""CheckNestedSimpleProp"",
""ErrorMessage"": ""Value值不是second."",
""ErrorType"": ""Error"",
""RuleExpressionType"": ""LambdaExpression"",
""Expression"": ""user.UserId==1 && items[0].Value=https://www.cnblogs.com/yyfh/archive/2021/04/29/=second""
}
]
}] ";
var userInput = new UserInput
{
UserId = 1,
IdNo = "11010519491230002X",
Age = 18
};
var input = new
{
user = userInput,
items = new List<ListItem>()
{
new ListItem{ Id=1,Value="https://www.cnblogs.com/yyfh/archive/2021/04/29/first"},
new ListItem{ Id=2,Value="https://www.cnblogs.com/yyfh/archive/2021/04/29/second"}
}
};
輸出結果如下所示：
驗證成功：False，訊息：Value值不是second.
如何實作的？
對于這個，我們該根據現象去看原理，對于內部的動態樹其實是使用了System.Linq.Dynamic.Core,RulesEngine是建立在該庫之上，進行抽象出來的，為我們提供了一個規則引擎，那我們來試一下System.Linq.Dynamic.Core，
我們先查詢集合資料，編輯一個條件字串，如下所示：
var items = input.items.AsQueryable().Where("Id == 1").ToList();
foreach (var item in items)
{
Console.WriteLine($"Id：{item.Id},Value: {item.Value}");
}
輸出結果：
Id：1,Value: first
那我們再看看如果是通過表達樹，我們是如何進行實作的，如下所示：
Expression<Func<ListItem, bool>> predicate = x => x.Id == 1;
//輸入條件如下
var inputItem = new ListItem
{
Id = 1,
Value = "https://www.cnblogs.com/yyfh/archive/2021/04/29/second"
};
if (inputItem.Id !=null)
{
predicate = predicate.And(x=>x.Id==inputItem.Id);
}
if (inputItem.Id != null)
{
predicate = predicate.And(x => x.Value =https://www.cnblogs.com/yyfh/archive/2021/04/29/= inputItem.Value);
}
public static class PredicateBuilder
{
public static Expression> And(this Expression> expr1,
Expression> expr2)
{
var invokedExpr = Expression.Invoke(expr2, expr1.Parameters.Cast());
return Expression.Lambda>
(Expression.And(expr1.Body, invokedExpr), expr1.Parameters);
}
}
正常來說是如上這種的，我們進行條件的拼接，相信大家可以通過這種的一個條件進行一個思考，確定什么樣的適合自己，
如果使用動態查詢形式如下所示：
var items = input.items.AsQueryable().Where("Id ==@0 && Value=https://www.cnblogs.com/yyfh/archive/2021/04/29/=@1",inputItem.Id,inputItem.Value).ToList();
成功失敗事件
因為對于邏輯驗證來說，我們既然要這樣做，肯定需要知道到底成功了還是失敗了，而這個我們不僅可以通過物件的IsSuccess還可以通過兩個事件進行得到邏輯驗證的失敗與成功，如下所示：
var discountOffered = "";
resultList.OnSuccess((eventName) =>
{
discountOffered = $"成功事件:{eventName}.";
});
resultList.OnFail(() =>
{
discountOffered = "失敗事件.";
});
總結
有興趣的話可以看一下System.Linq.Dynamic.Core，因為關于動態表達樹決議還是使用的這個專案去做的，另外專案地址在RulesEngine
https://github.com/hueifeng/BlogSample/tree/master/src/RulesEngineDemo
轉載請註明出處，本文鏈接：https://www.uj5u.com/net/281599.html
標籤：.NET技术