2.1 Drools5简述
上面已经提到Drools是通过规则编译、规则收集和规则的执行来实现具体功能的。Drools5提供了以下主要实现API:
- KnowledgeBuilder
- KnowledgeBase
- KnowledgePackage
- StatefulKnowledgeSession
- StatelessKnowledgeSession
它们起到了对规则文件进行收集、编译、查错、插入fact、设置global、执行规则或规则流等作用。
2.2 Drools5之HelloWorld
下面结合实例,使用上面的API来实现一个简单规则使用实例。随后简单介绍每个API的主要作用。Drools7目前依旧包含上面提的Drools5的API,因此本实例直接使用Drools7的jar包。
2.2.1 业务场景
目前有两种商品钻石(diamond)和黄金(Gold),需要对这两种商品分别制定销售折扣(discount)。如果使用Drools规则引擎就是为了适用两种商品折扣的各种变化,不用修改代码就可以实现复杂业务组合的变更。当然简单的情况,使用普通的if else或配置项也可以达到变更的目的,那就不需要Drools,也就不是本节讨论的范畴了。
2.2.2 代码实例
整体目录结构如下图:
首先创建JAVA项目,使用maven进行管理。创建之后maven的pom.xml文件内容如下:
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.secbro</groupId>
<artifactId>drools-demo</artifactId>
<version>1.0-SNAPSHOT</version>
<properties>
<drools-version>7.0.0.Final</drools-version>
</properties>
<dependencies>
<dependency>
<groupId>org.drools</groupId>
<artifactId>drools-compiler</artifactId>
<version>${drools-version}</version>
</dependency>
</dependencies>
</project>
创建产品类Product,如下:
package com.secbro.drools.model;
/**
* 产品类
* Created by zhuzs on 2017/7/4.
*/
public class Product {
/**
* 钻石
*/
public static final String DIAMOND = "0";
/**
* 黄金
*/
public static final String GOLD = "1";
private String type;
private int discount;
public String getType() {
return type;
}
public void setType(String type) {
this.type = type;
}
public int getDiscount() {
return discount;
}
public void setDiscount(int discount) {
this.discount = discount;
}
}
在项目的resources目录下创建com/rules目录,并在创建Rules.drl,内容如下:
package com.rules
import com.secbro.drools.model.Product
rule Offer4Diamond
when
productObject : Product(type == Product.DIAMOND)
then
productObject.setDiscount(15);
end
rule Offer4Gold
when
productObject: Product(type == Product.GOLD)
then
productObject.setDiscount(25);
end
创建执行规则的测试类Drools5Test:
package com.secbro.drools;
import com.secbro.drools.model.Product;
import org.kie.api.io.ResourceType;
import org.kie.internal.KnowledgeBase;
import org.kie.internal.KnowledgeBaseFactory;
import org.kie.internal.builder.KnowledgeBuilder;
import org.kie.internal.builder.KnowledgeBuilderFactory;
import org.kie.internal.definition.KnowledgePackage;
import org.kie.internal.io.ResourceFactory;
import org.kie.internal.runtime.StatefulKnowledgeSession;
import java.util.Collection;
/**
* Created by zhuzs on 2017/7/4.
*/
public class Drools5xTest {
public static void main(String[] args) {
Drools5xTest test = new Drools5xTest();
test.oldExecuteDrools();
}
private void oldExecuteDrools() {
KnowledgeBuilder kbuilder = KnowledgeBuilderFactory.newKnowledgeBuilder();
kbuilder.add(ResourceFactory.newClassPathResource("com/rules/Rules.drl",
this.getClass()), ResourceType.DRL);
if (kbuilder.hasErrors()) {
System.out.println(kbuilder.getErrors().toString());
}
Collection<KnowledgePackage> pkgs = kbuilder.getKnowledgePackages();
// add the package to a rulebase
KnowledgeBase kbase = KnowledgeBaseFactory.newKnowledgeBase();
// 将KnowledgePackage集合添加到KnowledgeBase当中
kbase.addKnowledgePackages(pkgs);
StatefulKnowledgeSession ksession = kbase.newStatefulKnowledgeSession();
Product product = new Product();
product.setType(Product.GOLD);
ksession.insert(product);
ksession.fireAllRules();
ksession.dispose();
System.out.println("The discount for the product " + product.getType()
+ " is " + product.getDiscount()+”%”);
}
}
现在执行,main方法,打印出来的结果为:
The discount for the product 1 is 25%
2.2.3 实例详解
通过上面的实例我们已经完成了Drools规则引擎API的使用。下面,针对实例逐步讲解每个API的使用方法及drl文件的语法。
类名 | 使用说明 |
---|---|
KnowledgeBuilder | 在业务代码中收集已编写的规则,并对规则文件进行编译,生成编译好的KnowledgePackage集合,提供给其他API使用。通过其提供的hasErrors()方法获得编译过程中是否有错,getErrors()方法打印错误信息。支持.drl文件、.dslr文件和xls文件等。 |
KnowledgePackage | 存放编译之后规则的对象 |
KnowledgeBase | 收集应用当中知识(knowledge)定义的知识库对象(KnowledgePackage),在一个 KnowledgeBase 当中可以包含普通的规则(rule)、 规则流(rule flow)、函数定义(function)、用户自定义对象(type model)等,并创建session对象(StatefulKnowledgeSession和 StatelessKnowledgeSession) |
StatefulKnowledgeSession | 接收外部插入的数据fact对象(POJO),将编译好的规则包和业务数据通过fireAllRules()方法触发所有的规则执行。使用完成需调用dispose()方法以释放相关内存资源。 |
StatelessKnowledgeSession | 对StatefulKnowledgeSession的封装实现,与其对比不需要调用dispose()方法释放内存,只能插入一次fact对象。 |
以上是针对Drools5x版本api相关使用简介,Drools7版本已经不再使用此系列的API,此处章节就不展开描述。规则的语法也放在Drools7对应章节中进行详细介绍。
关于
你的支持是我努力的最大动力!此系列课程正在持续更新中,相关讨论QQ(593177274)已经建立,欢迎大家加入讨论。