《Drools7.0.0.Final规则引擎教程》第2章 追溯Drools5的使用

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）已经建立，欢迎大家加入讨论。