当编写应用程序时,经常性需要花费大量的时间与精力处理业务逻辑,往往业务逻辑的变化需要重构或者增加大量代码,对开发测试人员很不友好。

之前在说过,可以使用脚本引擎来将我们需要经常变化的代码进行动态编译执行,自由度非常大,不过对应的需要资源也多。如果只是针对非常具体业务逻辑的变化,可以尝试使用rulesengine对程序进行操作。

下文使用了官方示例且部分内容翻译自说明文档

简介

rulesengine是微软推出的规则引擎,规则引擎在很多企业开发中有所应用,是处理经常变动需求的一种优雅的方法。个人任务,规则引擎适用于以下的一些场景:

  • 输入输出类型数量比较固定,但是执行逻辑经常变化;
  • switch条件经常变化,复杂switch语句的替代;
  • 会变动的,具有多种条件或者规则的业务逻辑;
  • 规则自由度不要求特别高的场景。(这种情况建议使用脚本引擎)

rulesengine的规则使用json进行存储,通过lambda表达式方式表述规则(rules)。

安装很方便,直接使用nuget进行安装:

install-pacakge rulesengine

规则定义

需要有rules,有workflowname,然后还有一些属性。

[
 {
  "workflowname": "discount",
  "rules": [
   {
    "rulename": "givediscount10",
    "successevent": "10",
    "errormessage": "one or more adjust rules failed.",
    "errortype": "error",
    "ruleexpressiontype": "lambdaexpression",
    "expression": "input1.country == \"india\" and input1.loyalityfactor <= 2 and input1.totalpurchasestodate >= 5000 and input2.totalorders > 2 and input3.noofvisitspermonth > 2"
   }
  ]
 }
]

除了标准的ruleexpressiontype,还可以通过定义rules嵌套多个条件,下面是or逻辑。

{
"rulename": "givediscount30nestedorexample",
"successevent": "30",
"errormessage": "one or more adjust rules failed.",
"errortype": "error",
"operator": "orelse",
"rules":[
  {
  "rulename": "isloyalandhasgoodspend",
  "errormessage": "one or more adjust rules failed.",
  "errortype": "error",
  "ruleexpressiontype": "lambdaexpression",
  "expression": "input1.loyalityfactor > 3 and input1.totalpurchasestodate >= 50000 and input1.totalpurchasestodate <= 100000"
  },
  {
  "rulename": "orhashighnumberoftotalorders",
  "errormessage": "one or more adjust rules failed.",
  "errortype": "error",
  "ruleexpressiontype": "lambdaexpression",
  "expression": "input2.totalorders > 15"
  }
]
}

示例

可以从官方的代码库中下载示例,定义了上述规则,就可以直接开始用了。示例描述了这么一个应用场景:

根据不同的客户属性,提供不同的折扣。由于销售的情况变化较快,提供折扣的规则也需要经常变动。因此比较适用于规则引擎。

public void run()
{
  console.writeline($"running {nameof(basicdemo)}....");
  //创建输入
  var basicinfo = "{\"name\": \"hello\",\"email\": \"abcy@xyz.com\",\"credithistory\": \"good\",\"country\": \"canada\",\"loyalityfactor\": 3,\"totalpurchasestodate\": 10000}";
  var orderinfo = "{\"totalorders\": 5,\"recurringitems\": 2}";
  var telemetryinfo = "{\"noofvisitspermonth\": 10,\"percentageofbuyingtovisit\": 15}";

  var converter = new expandoobjectconverter();

  dynamic input1 = jsonconvert.deserializeobject<expandoobject>(basicinfo, converter);
  dynamic input2 = jsonconvert.deserializeobject<expandoobject>(orderinfo, converter);
  dynamic input3 = jsonconvert.deserializeobject<expandoobject>(telemetryinfo, converter);

  var inputs = new dynamic[]
    {
      input1,
      input2,
      input3
    };
  //加载规则
  var files = directory.getfiles(directory.getcurrentdirectory(), "discount.json", searchoption.alldirectories);
  if (files == null || files.length == 0)
    throw new exception("rules not found.");

  var filedata = file.readalltext(files[0]);
  var workflowrules = jsonconvert.deserializeobject<list<workflowrules>>(filedata);
  //初始化规则引擎
  var bre = new rulesengine.rulesengine(workflowrules.toarray(), null);

  string discountoffered = "no discount offered.";
  //执行规则
  list<ruleresulttree> resultlist = bre.executeallrulesasync("discount", inputs).result;
  //处理结果
  resultlist.onsuccess((eventname) => {
    discountoffered = $"discount offered is {eventname} % over mrp.";
  });

  resultlist.onfail(() => {
    discountoffered = "the user is not eligible for any discount.";
  });

  console.writeline(discountoffered);
}

输入

输入一般来说是ienumerable<dynamic>或者是匿名类型,上面实例展示的是由json反序列化形成的dynamic类型,对于程序生成的数据,使用匿名类型更加方便。

var nestedinput = new {
        simpleprop = "simpleprop",
        nestedprop = new {
          simpleprop = "nestedsimpleprop",
          listprop = new list<listitem>
          {
            new listitem
            {
              id = 1,
              value = "first"
            },
            new listitem
            {
              id = 2,
              value = "second"
            }
          }
        }

      };

命名空间

和脚本引擎一样,默认规则引擎只能访问system的命名空间。如果需要使用到稍微复杂一些的类型,可以自己定义类型或者函数。比如定义一个这样的函数:

public static class utils
{
  public static bool checkcontains(string check, string vallist)
  {
    if (string.isnullorempty(check) || string.isnullorempty(vallist))
      return false;

    var list = vallist.split(',').tolist();
    return list.contains(check);
  }
}

需要使用的时候,先将类传递给rulesengine:

var resettingswithcustomtypes = new resettings { customtypes = new type[] { typeof(utils) } };
var engine = new rulesengine.rulesengine(workflowrules.toarray(), null, resettingswithcustomtypes);

然后就可以直接在表达式中使用了。

"expression": "utils.checkcontains(input1.country, \"india,usa,canada,france\") == true"

规则参数

默认情况下,规则的输入使用的是类似input1 input2这样的形式,如果想直观一点,可以使用ruleparameter来进行封装具体的参数类型。

ruleparameter ruleparameter = new ruleparameter("nip", nestedinput);
var resultlist = bre.executeallrulesasync(workflow.workflowname, ruleparameter).result;

本地变量

如果表达式比较复杂的情况下,可以使用本地变量来进行分段处理,这对调试来说会比较方便。

本地变量的关键字为localparams,可以将中间的内容简单理解成var name = expression

{
    "name": "allow_access_if_all_mandatory_trainings_are_done_or_access_issecure",
    "errormessage": "please complete all your training(s) to get access to this content or access it from a secure domain/location.",
    "errortype": "error",
    "localparams": [
     {
      "name": "completedsecuritytrainings",
      "expression": "mastersecuritycomplaincetrainings.where(status.equals(\"completed\", stringcomparison.invariantcultureignorecase))"
     },
     {
      "name": "completedprojecttrainings",
      "expression": "masterprojectcomplaincetrainings.where(status.equals(\"completed\", stringcomparison.invariantcultureignorecase))"
     },
     {
      "name": "isrequestaccesssecured",
      "expression": "userrequestdetails.location.country == \"india\" ? ((userrequestdetails.location.city == \"bangalore\" && userrequestdetails.domain=\"xxxx\")? true : false):false"
     }
    ],
    "expression": "(completedsecuritytrainings.any() && completedprojecttrainings.any()) || isrequestaccesssecured "
   }

总结

使用规则引擎,可以将经常变动的业务逻辑独立摘出来,为我们编写动态、可拓展的程序提供了很大的便利。rulesengine这个东西提供的api也比较简洁,上手非常简单。

到此这篇关于c规则引擎rulesengine的具体使用的文章就介绍到这了,更多相关c规则引擎rulesengine内容请搜索www.887551.com以前的文章或继续浏览下面的相关文章希望大家以后多多支持www.887551.com!