moutainhigh / ruleengine

wiki： Hale-Lee/RuleEngine

• 另一个表达式引擎： aviator

##使用方法

1. 在 POM.XML 文件中添加下面的内容

    <dependency>
        <groupId>com.github.hale-lee</groupId>
        <artifactId>RuleEngine</artifactId>
        <version>0.2.0</version>
    </dependency>

2. 配置 ruleEngine.properties 文件

rule.reader=xml/drools/database

• 若选择xml格式的规则文件，那么rule.reader=xml，此时需要设置xml.rule.filename=ruleconfig.xml    
  
• 若选择将规则文件定义存放在数据库中，那么设置rule.reader=database，此时需要设置db.rule.table=表名  （存放规则定义的表格，其格式可以参考SQL文件夹下的rule-mysql.sql或rule-oracle.sql）同时需要配置或者引用现有框架的jdbc配置, RuleEngine支持直接的jdbc数据库，也支持druid的数据库连接池，还可以直接引用外部框架的的数据库链接，比如spring-mvc的数据库链接。      
  
• 若选择使用drools格式的规则文件，则设置rule.reader=drools，同时需要设置drools.rule.filename=sample.drl
  

3. 引用调用

直接import EngineService类，生成EngineService对象，同时将需要校验的bean作为Object传入给EngineService对象的Start方法。   如下所示：

	EngineService service = new EngineService();
	try {
		Student st = new Student();
		st.setAge(5);
		st.name = "tom";
		st.sex = 1;

		EngineRunResult result = service.start(st);
		System.out.println(result.getResult().getName());

		System.out.println(st.getAge());
	} catch (RuleEngineException e) {
		e.printStackTrace();
	}

4. 编写规则

• 若选择 xml 格式，则需配置 xml.rule.filename 项目:

  <rule id="totallist" exe_class="" method="" parent="">
          <property name="content" value="客户身份证号码规则"/>
          <property name="result" value="RESULT.REJECTED" desc="拒绝"/>
          <property name="continue_flag" value="1"/>
          <property name="group_express" value="(blacklist || graylist)"/>
  	<property name="priority" value="00010"/>
  </rule>

• 若选择 drools 格式，则需配置 drools.rule.filename 项目:

  rule "ageUp12"
  	 salience 400
  	 when
  		$student: Student(age < 8)
  		 /* antoher rule */
  	 then
  		System.out.println("I was called, my name is : " + $student.name);
  		ageUp($student,12);
  		//callOver($student);
  	 end

• 4.3 若选择 database 格式，则需配置db.rule.table项目:

  item_no|content|exe_sql|exe_class|param_name|param_type|comparison_code|comparison_value|baseline|result|executor|priority|continue_flag|parent_item_no|group_express|remark|comments|enable_flag|create_time|update_time
  11|黑名单|select count(1) as cnt from tl_blacklist where customer_no = ? and delete_flag = 1|customer_no|java.lang.String|01|==|0|PASSED|100|1|1|2018-02-26 12:40:15.000000|2018-02-26 12:40:18.000000

  数据库连接方式时，需要同时设置db.accesser:

  • 如果使用 druid 的数据库连接池，可以设置成db.accesser=tech.kiwa.engine.utility.DirectDBAccesser

    DirectDBAccesser 提供了开关变量 UseDruid:

    • 如果设置成 true 就是使用了druid连接池
    • 如果设置成 false 则是直接地jdbc

  • 如果使用 Spring 的数据库连接，可以设置成db.accesser=tech.kiwa.engine.utility.SpringDBAccesser