TOC
Drools语法-Language
关键词
Hard keywords(Cannot use any):
true,false,nullSoft keywords(avoid use)
lock-on-active date-effective date-expires no-loop auto-focus activation-group agenda-group ruleflow-group entry-point duration package import dialect salience enabled attributes rule extend when then template query declare function global eval not in or and exists forall accumulate collect from action reverse result end over init
注释
单行注释
rule "Testing Comments" when // this is a single line comment eval( true ) // this is a comment in the same line of a pattern then // this is a comment inside a semantic code block end多行注释
rule "Test Multi-line Comments" when /* this is a multi-line comment in the left hand side of a rule */ eval( true ) then /* and this is a multi-line comment in the right hand side of a rule */ end
Pakage
package
package表示一个命名空间.package是必须定义的，必须放在规则文件第一行.import
import语句的工作方式类似于Java中的import语句。您需要为要在规则中使用的任何对象指定完全限定路径和类型名称。global
global用于定义全局变量。Rules:
global java.util.List myGlobalList; rule "Using a global" when eval( true ) then myGlobalList.add( "Hello World" ); endSet the global value:
List list = new ArrayList(); KieSession kieSession = kiebase.newKieSession(); kieSession.setGlobal( "myGlobalList", list );
Function
function
function是一种将语义代码放置在规则源文件中的方法，而不是普通的Java类function String hello(String name) { return "Hello "+name+"!"; } import function my.package.Foo.hello rule "using a static function" when eval( true ) then System.out.println( hello( "Bob" ) ); end
Query
- query
query是一种搜索工作内存中与指定条件匹配的事实的简单方法.
对所有30岁以上的人的简单查询
query "people over the age of 30"
person : Person( age > 30 )
end
查询超过x岁的人，以及居住在y的人
query "people over the age of x" (int x, String y)
person : Person( age > x, location == y )
end
QueryResults results = ksession.getQueryResults( "people over the age of 30" );
System.out.println( "we have " + results.size() + " people over the age of 30" );
System.out.println( "These people are are over 30:" );
for ( QueryResultsRow row : results ) {
Person person = ( Person ) row.get( "person" );
System.out.println( person.getName() + "\n" );
}
Rule
rule定义规则。rule "ruleName"。
一个规则可以包含三个部分：属性部分,条件部分：即LHS,结果部分：即RHS.
属性部分-Attributes
定义当前规则执行的一些属性等，比如是否可被重复执行、过期时间、生效时间等。
activation-group agenda-group auto-focus date-effective date-expires dialect duration duration-value enabled lock-on-active no-loop ruleflow-group salience
no-loop
默认值：false
类型：Boolean
在一个规则当中如果条件满足就对
Working Memory当中的某个Fact对象进行了修改，比如使用update 将其更新到当前的Working Memory当中，这时引擎会再次检查所有的规则是否满足条件，如果满足会再次执行.ruleflow-group
默认值：N/A
类型：String
Ruleflow是一个Drools功能，可让您控制规则的触发。由相同的规则流组标识汇编的规则仅在其组处于活动状态时触发。将规则划分为一个个的组，然后在规则流当中通过使用ruleflow-group属性的值，从而使用对应的规则。lock-on-active
默认值：false
类型：Boolean
当在规则上使用
ruleflow-group属性或agenda-group属性的时候，将lock-on-action属性的值设置为true，可能避免因某些Fact 对象被修改而使已经执行过的规则再次被激活执行。可以看出该属性与no-loop属性有相似之处，no-loop属性是为了避免Fact 修改或调用了insert、retract、update之类而导致规则再次激活执行，这里的lock-on-action属性也是起这个作用，lock-on-active是no-loop的增强版属性，它主要作用在使用ruleflow-group属性或agenda-group属性的时候，lock-on-active属性默认值为false。与no-loop不同的是lock-on-active可以避免其他规则修改FACT对象导致规则的重新执行。salience
默认值：0
类型：integer
设置规则执行的优先级，
salience属性的值是一个数字，数字越大执行优先级越高，同时它的值可以是一个负数. 规则的salience默认值为0，所以如果我们不手动设置规则的salience属性，那么它的执行顺序是随机的.agenda-group
默认值：MAIN
类型：String
规则的调用与执行是通过
StatelessSession或StatefulSession来实现的，一般的顺序是创建一个StatelessSession或StatefulSession，将各种经过编译的规则的package 添加到session当中，接下来将规则当中可能用到的Global对象和Fact对象插入到Session 当中，最后调用fireAllRules 方法来触发、执行规则。在没有调用最后一步fireAllRules方法之前，所有的规则及插入的Fact对象都存放在一个名叫Agenda表的对象当中，这个Agenda表中每一个规则及与其匹配相关业务数据叫做Activation，在调用fireAllRules方法后，这些Activation 会依次执行，这些位于Agenda 表中的Activation 的执行顺序在没有设置相关用来控制顺序的属性时（比如salience 属性），它的执行顺序是随机的，不确定的。Agenda Group是用来在Agenda 的基础之上，对现在的规则进行再次分组，具体的分组方法可以采用为规则添加agenda-group属性来实现。agenda-group属性的值也是一个字符串，通过这个字符串，可以将规则分为若干个Agenda Group，默认情况下，引擎在调用这些设置了agenda-group属性的规则的时候需要显示的指定某个Agenda Group得到Focus（焦点），这样位于该Agenda Group当中的规则才会触发执行，否则将不执行。auto-focus
默认值：false
类型：Boolean
用来在已设置了
agenda-group的规则上设置该规则是否可以自动独取Focus，如果该属性设置为true，那么在引擎执行时，就不需要显示的为某个Agenda Group设置Focus，否则需要。对于规则的执行的控制，还可以使用Agenda Filter来实现。在Drools 当中，提供了一个名为org.drools.runtime.rule.AgendaFilter 的Agenda Filter接口，用户可以实现该接口，通过规则当中的某些属性来控制规则要不要执行。org.drools.runtime.rule.AgendaFilter接口只有一个方法需要实现，方法体如下：public boolean accept(Activation activation);在该方法当中提供了一个Activation参数，通过该参数我们可以得到当前正在执行的规则对象或其它一些属性，该方法要返回一个布尔值，该布尔值就决定了要不要执行当前这个规则，返回true 就执行规则，否则就不执行。activation-group
默认值：N/A
类型：String
该属性的作用是将若干个规则划分成一个组，用一个字符串来给这个组命名，这样在执行的时候，具有相同
activation-group属性的规则中只要有一个会被执行，其它的规则都将不再执行。也就是说，在一组具有相同activation-group属性的规则当中，只有一个规则会被执行，其它规则都将不会被执行。当然对于具有相同activation-group属性的规则当中究竟哪一个会先执行，则可以用类似salience之类属性来实现。dialect
默认值： 根据package指定
类型：String，”java” or “mvel”
dialect种类是用于LHS或RHS代码块中的任何代码表达式的语言。目前有两种dialect，Java和MVEL。虽然dialect可以在包级别指定，但此属性允许为规则覆盖包定义。date-effective
默认值：N/A
类型：字符串，包含日期和时间定义。格式：
dd-MMM-yyyy(25-Sep-2009).仅当当前日期和时间在日期有效属性后面时，才能激活规则。
date-expires
默认值：N/A
类型：字符串，包含日期和时间定义。格式：
dd-MMM-yyyy(25-Sep-2009).如果当前日期和时间在
date-expires属性之后，则无法激活规则.enabled
默认值：false
类型：String
表示规则是可用的，如果手工为一个规则添加一个
enabled属性，并且设置其enabled属性值为false，那么引擎就不会执行该规则.duration
默认值：无
类型：long
持续时间指示规则将在指定的持续时间之后触发，如果它仍然是true.
条件部分-LHS
定义当前规则的条件，如when Message(); 判断当前workingMemory中是否存在Message对象。
Left Hand Side（LHS）是规则的条件部分的公共名称。它由零个或多个条件元素组成。
如果LHS为空，它将被认为是一个条件元素，它总是为真，并且当创建一个新的WorkingMemory会话时，它将被激活一次。
Conditions / LHS —匹配模式（Patterns）
没有字段约束的Pattern
Person()
有文本字段约束的Pattern
Person( name == “bob” )
字段绑定的Pattern
Person( $name : name == “bob” )
变量名称可以是任何合法的java变量，$是可选的，可由于区分字段和变量
Fact绑定的Pattern
$bob : Person( name == “bob” )字段绑定的Pattern
变量约束的Pattern
Person( name == $name )
Drools提供了十二种类型比较操作符:
> >= < <= == != contains not contains memberOf not memberOf matches not matches
contains
运算符
contains用于检查作为Collection或elements的字段是否包含指定的值.Cheese( name contains "tilto" ) Person( fullName contains "Jr" ) String( this contains "foo" )not contains
和
contains相反memberOf
运算符
memberOf用于检查字段是否是集合的成员或元素;该集合必须是一个变量。CheeseCounter( cheese memberOf $matureCheeses )not memberOf
和
memberOf相反matches
正则表达式匹配，与java不同的是，不用考虑’/‘的转义问题
Cheese( type matches "(Buffalo)?\\S*Mozarella" )not matches
和
matches相反
其他条件元素： - exists
存在。检查Working Memory是否存在某物。使用模式`exists`，则规则将只激活最多一次，而不管在工作存储器中存在与存在模式中的条件匹配的数据量
not
不存在，检查工作存储器中是否存在某物。认为“
not”意味着“there must be none of...”。
结果部分-RHS
这里可以写普通java代码，即当前规则条件满足后执行的操作，可以直接调用Fact对象的方法来操作应用。
Right Hand Side（RHS）是规则的结果或动作部分的通用名称;此部分应包含要执行的操作的列表。在规则的RHS中使用命令式或条件式代码是不好的做法;作为一个规则应该是原子的性质 - “when this, then do this”，而不是“when this, maybe do this”。规则的RHS部分也应该保持较小，从而保持声明性和可读性。如果你发现你需要在RHS中的命令式和/或条件代码，那么也许你应该把这个规则分成多个规则。 RHS的主要目的是插入，删除或修改工作存储器数据。为了协助，有一些方便的方法可以用来修改工作记忆;而不必首先引用工作内存实例。
update
更新，告诉引擎对象已经改变（已经绑定到LHS上的某个东西），并且规则可能需要重新考虑。
insert(new Something())
插入，往当前
workingMemory中插入一个新的Fact对象，会触发规则的再次执行，除非使用no-loop限定；insertLogical(new Something())
类似于
insert，但是当没有更多的facts支持当前触发规则的真实性时，对象将被自动删除。modify
修改，与
update语法不同，结果都是更新操作。该语言扩展提供了一种结构化的方法来更新事实。它将更新操作与一些setter调用相结合来更改对象的字段。retract
删除
一些内置的method。
drools.halt()
调用
drools.halt（）立即终止规则执行。这是需要将控制权返回到当前会话使用fireUntilHalt（）的点。drools.getWorkingMemory()
返回WorkingMemory对象.
drools.setFocus( String s)
将焦点设置为指定的
agenda group.drools.getRule().getName()
从规则的RHS调用，返回规则的名称。
drools.getTuple()
返回与当前执行的规则匹配的
Tuple，而drools.getActivation（）传递相应的激活。
Drools应用
动态规则
动态获取KieSession
public KieSession getKieSession(String rules) {
KieServices kieServices = KieServices.Factory.get();
KieFileSystem kfs = kieServices.newKieFileSystem();
kfs.write("src/main/resources/rules/rules.drl", rules.getBytes());
KieBuilder kieBuilder = kieServices.newKieBuilder(kfs).buildAll();
Results results = kieBuilder.getResults();
if (results.hasMessages(org.kie.api.builder.Message.Level.ERROR)) {
System.out.println(results.getMessages());
throw new BusinessException(300003,results.getMessages().toString(),4);
}
KieContainer kieContainer = kieServices.newKieContainer(kieServices.getRepository().getDefaultReleaseId());
KieBase kieBase = kieContainer.getKieBase();
return kieBase.newKieSession();
}
激活规则
KieSession kieSession = rulesService.getKieSession(rule);
Gson gson = new Gson();
Person person = gson.fromJson(json, Person.class);
kieSession.insert(person);
kieSession.fireAllRules();
kieSession.dispose();
决策表
将文件翻译为drl文件
public String getRuleTable() {
//把excel翻译成drl文件
SpreadsheetCompiler compiler = new SpreadsheetCompiler();
String rules = compiler.compile(ResourceFactory.newClassPathResource(RULES_PATH + File.separator + "rule.xlsx", "UTF-8"), "rule-table");
System.out.println(rules);
return rules;
}
将文件流翻译为drl文件
public String getRuleTable(InputStream inputStream) {
//把excel翻译成drl文件
SpreadsheetCompiler compiler = new SpreadsheetCompiler();
String rules = compiler.compile(ResourceFactory.newInputStreamResource(inputStream, "UTF-8"), "rule-table");
logger.info("get rule from xls:" + rules);
return rules;
}
Drools-Example
使用Drools来解决一些复杂的逻辑问题。
MingDrink
problem
小明喝汽水问题:
1元钱一瓶汽水，喝完后两个空瓶换一瓶汽水，问：小明有20元钱，最多可以喝到几瓶汽水？
rule
package com.xu.drools import com.xu.drools.bean.XiaoMing; // 小明喝汽水问题 // 1元钱一瓶汽水，喝完后两个空瓶换一瓶汽水，问：小明有20元钱，最多可以喝到几瓶汽水？ // 规则1：1元钱一瓶汽水 // 规则2：两个空瓶换一瓶汽水 //规则1：1元钱一瓶汽水。有钱就买水，空瓶+1，钱-1，喝水+1； rule "rule1" salience 3 when $m:XiaoMing(money>0); then System.out.println("有钱即可喝水，钱："+$m.getMoney()); $m.setBottle($m.getBottle()+1); $m.setMoney($m.getMoney()-1); $m.setDrink($m.getDrink()+1); update($m) end //规则2：两个空瓶换一瓶汽水。有空瓶就换钱，空瓶-2，钱+1； rule "rule2" salience 2 when $m:XiaoMing(bottle>=2); then System.out.println("有瓶子就换钱，瓶子："+$m.getBottle()); $m.setBottle($m.getBottle()-2); $m.setMoney($m.getMoney()+1); update($m) end //规则3，打印已经喝掉的数量 rule "rule3" salience 1 when $m:XiaoMing(); then System.out.println("总共喝掉："+$m.getDrink()); end
WorldProblem
problem
猜对错问题: 在一次数学竞赛中，获得前三名的同学是A，B，C. 老师对他们说：“祝贺你们，请你们猜一猜名次。”
- 甲：“A是第二，C是第三.”
- 乙：“A是第一，B是第三.”
- 丙：“B是第二，A是第三.”
感觉有更好的方法，但是写不出规则来0.0rule
package com.xu.drools import com.xu.drools.bean.Student; import com.xu.drools.bean.World rule "find jia1" salience 2 when $jia1 : Student(name == "jia",word1=="A",word2=="C",desc1=="2",desc2!="3") then insert( new World($jia1.getDesc1(),0,$jia1.getDesc2()) ); end rule "find jia2" salience 2 when $jia2 : Student(name == "jia",word1=="A",word2=="C",desc1!="2",desc2=="3") then insert( new World($jia2.getDesc1(),0,$jia2.getDesc2()) ); end rule "find yi1" salience 3 when $yi1 : Student(name == "yi",word1=="A",word2=="B",desc1=="1",desc2!="3"); $w : World(a==$yi1.getDesc1()) then $w.setB($yi1.getDesc2()); update($w) end rule "find yi2" salience 3 when $yi2 : Student(name == "yi",word1=="A",word2=="B",desc1=="1",desc2!="3") $w : World(a==$yi2.getDesc1()) then $w.setB($yi2.getDesc2()); update($w) end rule "find bing1" salience 4 when $bing1 : Student(name == "bing",word1=="A",word2=="B",desc1=="3",desc2!="2") $w : World(a==$bing1.getDesc1(),b==$bing1.getDesc2()) then System.out.println("-------"+$w.toString()); end rule "find bing2" salience 4 when $bing2 : Student(name == "bing",word1=="A",word2=="B",desc1!="3",desc2=="2") $w : World(a==$bing2.getDesc1(),b==$bing2.getDesc2()) then System.out.println("-------"+$w.toString()); end
GolferProblem
problem
高尔夫球员站位问题:
已知有四个高尔夫球员，他们的名字是Fred,Joe,Bob,Tom;
- 今天他们分别穿着红色，蓝色，橙色，以及格子衣服，并且他们按照从左往右的顺序站成一排。
- 我们将最左边的位置定为1，最右边的位置定为4，中间依次是2,3位置。
- 现在我们了解的情况是：
- 1.高尔夫球员Fred,目前不知道他的位置和衣服颜色
- 2.Fred右边紧挨着的球员穿蓝色衣服
- 3.Joe排在第2个位置
- 4.Bob穿着格子短裤
- 5.Tom没有排在第1位或第4位，也没有穿橙色衣服
- 请问,这四名球员的位置和衣服颜色。
rule
package com.xu.drools import com.xu.drools.bean.Golfer; rule "find solution" when //1.高尔夫球员Fred,目前不知道他的位置和衣服颜色 $fred : Golfer( name == "Fred" ) //3.Joe排在第2个位置 $joe : Golfer( name == "Joe", position == 2, position != $fred.position, color != $fred.color ) //4.Bob穿着格子短裤 $bob : Golfer( name == "Bob", position != $fred.position, position != $joe.position, color == "plaid", color != $fred.color, color != $joe.color ) //5.Tom没有排在第1位或第4位，也没有穿橙色衣服 $tom : Golfer( name == "Tom", position != 1, position != 4, position != $fred.position, position != $joe.position, position != $bob.position, color != "orange", color != $fred.color, color != $joe.color, color != $bob.color ) //2.Fred右边紧挨着的球员穿蓝色衣服 Golfer( position == ( $fred.position + 1 ), color == "blue", this in ( $joe, $bob, $tom ) ) then System.out.println( "Fred " + $fred.getPosition() + " " + $fred.getColor() ); System.out.println( "Joe " + $joe.getPosition() + " " + $joe.getColor() ); System.out.println( "Bob " + $bob.getPosition() + " " + $bob.getColor() ); System.out.println( "Tom " + $tom.getPosition() + " " + $tom.getColor() ); end