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