Drools开源业务规则引擎（一）- 安装与介绍

### 文章目录

[@[toc]](#文章目录 @[toc] Drools开源业务规则引擎（一）- 安装与介绍 0.何为规则引擎 1.Drools介绍 1.1.依赖模块 1.2.规则引擎 2.Drools安装 2.1.依赖导入 2.2.规则的输入和输出类型输入类型输出类型 2.3.创建规则文件 2.4.构建可执行规则库 2.5.执行结果： 3.Drools组件说明)
[Drools开源业务规则引擎（一）- 安装与介绍](#文章目录 @[toc] Drools开源业务规则引擎（一）- 安装与介绍 0.何为规则引擎 1.Drools介绍 1.1.依赖模块 1.2.规则引擎 2.Drools安装 2.1.依赖导入 2.2.规则的输入和输出类型输入类型输出类型 2.3.创建规则文件 2.4.构建可执行规则库 2.5.执行结果： 3.Drools组件说明)
[0.何为规则引擎](#文章目录 @[toc] Drools开源业务规则引擎（一）- 安装与介绍 0.何为规则引擎 1.Drools介绍 1.1.依赖模块 1.2.规则引擎 2.Drools安装 2.1.依赖导入 2.2.规则的输入和输出类型输入类型输出类型 2.3.创建规则文件 2.4.构建可执行规则库 2.5.执行结果： 3.Drools组件说明)
[1.Drools介绍](#文章目录 @[toc] Drools开源业务规则引擎（一）- 安装与介绍 0.何为规则引擎 1.Drools介绍 1.1.依赖模块 1.2.规则引擎 2.Drools安装 2.1.依赖导入 2.2.规则的输入和输出类型输入类型输出类型 2.3.创建规则文件 2.4.构建可执行规则库 2.5.执行结果： 3.Drools组件说明)
[1.1.依赖模块](#文章目录 @[toc] Drools开源业务规则引擎（一）- 安装与介绍 0.何为规则引擎 1.Drools介绍 1.1.依赖模块 1.2.规则引擎 2.Drools安装 2.1.依赖导入 2.2.规则的输入和输出类型输入类型输出类型 2.3.创建规则文件 2.4.构建可执行规则库 2.5.执行结果： 3.Drools组件说明)
[1.2.规则引擎](#文章目录 @[toc] Drools开源业务规则引擎（一）- 安装与介绍 0.何为规则引擎 1.Drools介绍 1.1.依赖模块 1.2.规则引擎 2.Drools安装 2.1.依赖导入 2.2.规则的输入和输出类型输入类型输出类型 2.3.创建规则文件 2.4.构建可执行规则库 2.5.执行结果： 3.Drools组件说明)
[2.Drools安装](#文章目录 @[toc] Drools开源业务规则引擎（一）- 安装与介绍 0.何为规则引擎 1.Drools介绍 1.1.依赖模块 1.2.规则引擎 2.Drools安装 2.1.依赖导入 2.2.规则的输入和输出类型输入类型输出类型 2.3.创建规则文件 2.4.构建可执行规则库 2.5.执行结果： 3.Drools组件说明)
[2.1.依赖导入](#文章目录 @[toc] Drools开源业务规则引擎（一）- 安装与介绍 0.何为规则引擎 1.Drools介绍 1.1.依赖模块 1.2.规则引擎 2.Drools安装 2.1.依赖导入 2.2.规则的输入和输出类型输入类型输出类型 2.3.创建规则文件 2.4.构建可执行规则库 2.5.执行结果： 3.Drools组件说明)
[2.2.规则的输入和输出类型](#文章目录 @[toc] Drools开源业务规则引擎（一）- 安装与介绍 0.何为规则引擎 1.Drools介绍 1.1.依赖模块 1.2.规则引擎 2.Drools安装 2.1.依赖导入 2.2.规则的输入和输出类型输入类型输出类型 2.3.创建规则文件 2.4.构建可执行规则库 2.5.执行结果： 3.Drools组件说明)
[输入类型](#文章目录 @[toc] Drools开源业务规则引擎（一）- 安装与介绍 0.何为规则引擎 1.Drools介绍 1.1.依赖模块 1.2.规则引擎 2.Drools安装 2.1.依赖导入 2.2.规则的输入和输出类型输入类型输出类型 2.3.创建规则文件 2.4.构建可执行规则库 2.5.执行结果： 3.Drools组件说明)
[输出类型](#文章目录 @[toc] Drools开源业务规则引擎（一）- 安装与介绍 0.何为规则引擎 1.Drools介绍 1.1.依赖模块 1.2.规则引擎 2.Drools安装 2.1.依赖导入 2.2.规则的输入和输出类型输入类型输出类型 2.3.创建规则文件 2.4.构建可执行规则库 2.5.执行结果： 3.Drools组件说明)
[2.3.创建规则文件](#文章目录 @[toc] Drools开源业务规则引擎（一）- 安装与介绍 0.何为规则引擎 1.Drools介绍 1.1.依赖模块 1.2.规则引擎 2.Drools安装 2.1.依赖导入 2.2.规则的输入和输出类型输入类型输出类型 2.3.创建规则文件 2.4.构建可执行规则库 2.5.执行结果： 3.Drools组件说明)
[2.4.构建可执行规则库](#文章目录 @[toc] Drools开源业务规则引擎（一）- 安装与介绍 0.何为规则引擎 1.Drools介绍 1.1.依赖模块 1.2.规则引擎 2.Drools安装 2.1.依赖导入 2.2.规则的输入和输出类型输入类型输出类型 2.3.创建规则文件 2.4.构建可执行规则库 2.5.执行结果： 3.Drools组件说明)
[2.5.执行结果：](#文章目录 @[toc] Drools开源业务规则引擎（一）- 安装与介绍 0.何为规则引擎 1.Drools介绍 1.1.依赖模块 1.2.规则引擎 2.Drools安装 2.1.依赖导入 2.2.规则的输入和输出类型输入类型输出类型 2.3.创建规则文件 2.4.构建可执行规则库 2.5.执行结果： 3.Drools组件说明)
[3.Drools组件说明](#文章目录 @[toc] Drools开源业务规则引擎（一）- 安装与介绍 0.何为规则引擎 1.Drools介绍 1.1.依赖模块 1.2.规则引擎 2.Drools安装 2.1.依赖导入 2.2.规则的输入和输出类型输入类型输出类型 2.3.创建规则文件 2.4.构建可执行规则库 2.5.执行结果： 3.Drools组件说明)

Drools开源业务规则引擎（一）- 安装与介绍

0.何为规则引擎

规则引擎，是业务规则管理系统的一部分，主要思想是将应用程序中的业务决策部分分离出来，并使用预定义的语义模板编写业务决策（业务规则），由用户或开发者在需要时进行配置、管理。规则引擎通过业务规则管理系统（BRMS，Business Rule Management System）来实现对业务规则的集中管理和动态执行。

规则引擎的主要特点和好处：

灵活性和可配置性：用户通过配置而不是代码编写来定义和管理业务规则。这使得规则可以根据需求进行更加灵活的调整和修改，而无需进行软件开发和发布。
可维护性和可扩展性：业务规则的管理和维护变得更加容易。通过规则引擎，用户可以独立地修改、添加或删除规则，而无需修改应用程序的源代码。这提高了维护性和扩展性，同时降低了代码维护的风险和成本。
业务与技术的分离：将业务规则从应用程序中分离出来，使得业务人员可以直接参与规则的定义和管理，而不需要依赖开发团队。这种分离促进了业务和技术之间的协作和沟通，加快了业务需求的落地。
决策智能化：支持规则的动态执行和智能推断。可以根据事实和规则条件进行推理并做出相应的决策，业务处理过程更加智能化和自动化，并能够根据具体场景和条件进行个性化决策。
可重复使用和标准化：规则可以被重复使用，并且以标准化的方式进行管理和执行。这样，不同的应用程序和系统可以共享相同的规则库，实现了规则的标准化和统一的执行。

目前市面上具体的规则引擎产品有：

Drools：Drools是一款开源的Java规则引擎，并且提供了强大的规则管理和执行功能。是业界广泛应用的规则引擎，具有丰富的功能和灵活的配置选项。
IBM Operational Decision Manager：ODM 是IBM提供的一套规则引擎和决策管理解决方案。具有强大的规则管理和执行能力，并且可以与其他IBM产品和技术进行集成。
PegaRULES Decision Management：Pegasystems推出的一款规则引擎产品，提供了全面的决策管理功能，包括规则的创建、维护、版本控制和执行。
Blaze Advisor：FICO（原Fair Isaac Corporation）推出的一款领先的规则引擎产品。具有高性能和可扩展的规则执行引擎，适用于大规模的决策管理和业务规则管理场景。
JBoss BRMS：红帽公司（Red Hat）提供的一套开源规则引擎和决策管理系统。基于Drools引擎，并提供了全面的规则管理和执行功能，支持多种商业规则管理需求。

1.Drools介绍

1.1.依赖模块

Drools 是一款开源的业务规则管理系统和规则引擎，由Jboss（现为红帽）开发和维护。Drools完全使用Java语言开发，基于Charles Forgy的RETE算法实现规则的高效执行。它提供了强大的规则管理和执行功能，能够帮助用户更好地管理和执行业务规则。

Drools被分解为几个模块，部分在规则开发/编译过程中需要，另一部分在运行时需要。在大多数情况下，项目只需要运行时包含的所有模块或者依赖，这种方式能提供更好的灵活性。所以运行时规则引擎的jar可以压缩到极致，只需要3个jar包（几百KB）。

以下是组成JBoss Drools的重要库的描述：

knowledge-api.jar ：提供一组接口和类，有助于清楚地显示什么是用户API，什么是引擎API。
knowledge-internal-api.jar ：提供了内部接口和工厂。
drools-core.jar ：核心引擎，运行时组件。包含RETE算法引擎和LEAPS前向推理算法引擎。如果你正在预编译规则（并通过Package或RuleBase对象进行部署），这是唯一的运行时依赖项。

预编译规则（pre-compiling rules）指将规则在运行时之前进行编译的过程。通过预编译规则，可以提高规则引擎的执行效率。
drools-compiler.jar ：包含编译器/构建器组件，以获取规则源，并构建可执行规则库。这通常是应用程序的运行时依赖项，但如果你正在预编译规则，则不必依赖。这取决于drools-core。
drools-jsr94.jar ：这符合JSR-94的实现，这本质上是drools-compiler组件上的一个层。请注意，由于JSR-94规范的性质，并非所有功能都很容易通过此接口暴露。在某些情况下，直接访问Drools API会更容易，但在某些环境中，JSR-94是强制性的。
drools-decisiontables.jar ：这是决策表"编译器"组件，它使用drools-编译器组件。这支持excel和csv输入格式。

上述组件还需要相当多的其他依赖项，其中大多数用于drools-compiler、drools-jsr94或drools-decisiontables模块。

1.2.规则引擎

Drools引擎是Drools中的规则引擎。Drools引擎存储、处理和评估数据，以执行定义好的业务规则或决策模型。Drools引擎的基本功能是将传入的数据或事实与规则的条件相匹配，并确定是否以及如何执行规则。

Drools引擎使用以下基本部件运行：

Rules：业务规则或DMN决策。所有规则都必须至少包含触发规则的条件以及规则规定的操作。（如上述案例的规则文件user.drl）
Facts：Drools引擎中匹配规则条件的输入数据。（如上述案例中的UserIn对象）
Production memory：Drools引擎中存储规则的位置。
Working memory：Drools引擎中存储事实的位置。
Agenda：已激活规则的注册和排序位置，为执行规则做准备。

2.Drools安装

2.1.依赖导入

xml 复制代码

        <dependency>
            <groupId>org.drools</groupId>
            <artifactId>drools-compiler</artifactId>
            <version>7.6.0.Final</version>
        </dependency>

2.2.规则的输入和输出类型

输入类型

java 复制代码

import lombok.Data;
import java.io.Serializable;

/**
 * @Name: UserIn
 * @Description: 用户规则的输入对象
 * @Author: ahao
 * @Date: 2024/6/28 11:43 PM
 */
@Data
public class UserIn implements Serializable {

    /**
     * 年龄：[0,100]
     */
    private Integer age;

}

输出类型

java 复制代码

import lombok.Data;
import java.io.Serializable;

/**
 * @Name: UserOut
 * @Description: 用户规则的输出对象
 * @Author: ahao
 * @Date: 2024/6/28 11:46 PM
 */
@Data
public class UserOut implements Serializable {

    /**
     * 年龄阶段：:0-6岁为婴幼儿;7-12岁为少儿;13-17岁为青少年;18-45岁为青壮年;46-69岁为中年;69岁以上为老年
     */
    private String ageStages;

}

2.3.创建规则文件

位置：classpath:drools/drl/user.drl

java 复制代码

package drools.drl

// 导入输入类型
import com.ahao.project.input.UserIn;
// 以全局变量的形式，定义输出类型
global com.ahao.project.output.UserOut output;

//0-6岁为婴幼儿;
rule "age_0_6"
activation-group "age_stage"
enabled true
when
    input:com.ahao.project.input.UserIn(age >= 0 && age <= 6);
then
    output.setAgeStages("婴幼儿");
end

// 7-12岁为少儿;
rule "age_7_12"
activation-group "age_stage"
enabled true
when
    input:com.ahao.project.input.UserIn(age >= 7 && age <= 12);
then
    output.setAgeStages("少儿");
end

// 13-17岁为青少年;
rule "age_13_17"
activation-group "age_stage"
enabled true
when
    input:com.ahao.project.input.UserIn(age >= 13 && age <= 17);
then
    output.setAgeStages("青少年");
end

// 18-45岁为青壮年;
rule "age_18_45"
activation-group "age_stage"
enabled true
when
    input:com.ahao.project.input.UserIn(age >= 18 && age <= 45);
then
    output.setAgeStages("青壮年");
end

// 46-69岁为中年;69岁以上为老年
rule "age_46_69"
activation-group "age_stage"
enabled true
when
    input:com.ahao.project.input.UserIn(age >= 46 && age <= 69);
then
    output.setAgeStages("中年");
end

// 69岁以上为老年
rule "age_69_999"
activation-group "age_stage"
enabled true
when
    input:com.ahao.project.input.UserIn(age > 69);
then
    output.setAgeStages("老年");
end

2.4.构建可执行规则库

java 复制代码

    @Test
    public void userDrl() {
      	// 获取规则文件
        String drl = "";
        try {
            File file = ResourceUtils.getFile("classpath:drools/drl/user.drl");
            FileReader fileReader = new FileReader(file);
            BufferedReader reader = new BufferedReader(fileReader);
            String s;
            while ((s = reader.readLine()) != null) {
                drl += s + "\n";
            }
        } catch (FileNotFoundException e) {
            throw new RuntimeException(e);
        } catch (IOException e) {
            throw new RuntimeException(e);
        }
        // 利用KieHelper工具类可以不通过kmodule.xml就可以实现规则
        KieHelper kieHelper = new KieHelper();
        // return new RuleBaseConfiguration();
        // RuleBaseConfiguration对象，可用于在决策引擎中配置异常处理程序设置、多线程执行和顺序模式。
        KieBaseConfiguration kieBaseConfiguration = kieHelper.ks.newKieBaseConfiguration();
        //  默认处理异常的类
        // kieBaseConfiguration.setOption(ConsequenceExceptionHandlerOption.get(DefaultConsequenceExceptionHandler.class));
        // 启用多线程: 默认不开启
        // kieBaseConfiguration.setOption(MultithreadEvaluationOption.NO);
        // 启用顺序模式: 默认不开启
        // Drools按照顺序执行规则一次，不会因为工作内存中的改变而再次执行规则。
        // 这就意味着Drools忽略了规则中的insert，modify和update语句，以单个序列执行规则。
        // 这个模式适合在无状态会话中使用。会让规则执行的更快
        kieBaseConfiguration.setOption(SequentialOption.YES);
        // ResourceType.DRL: 表示接受的规则文件类型
        kieHelper.addContent(drl, ResourceType.DRL);
        // 效验规则
        Results verify = kieHelper.verify();
        // 获取错误级别的编译日志
        if (verify.hasMessages( Message.Level.ERROR )) {
            log.error("规则编译失败：{}", messages);
        } else {
            KieBase kieBase = kieHelper.build(kieBaseConfiguration);
            // 创建无状态的会话
            StatelessKieSession statelessKieSession = kieBase.newStatelessKieSession();
            // 创建规则输出对象
            UserOut output = new UserOut();
            statelessKieSession.setGlobal("output", output);
            // 创建规则输入对象
            UserIn input = new UserIn();
            input.setAge(35);
            // 执行规则
            statelessKieSession.execute(input);
            log.info("执行规则完毕，年龄：{},结果：{}",input.getAge(),output.getAgeStages());
        }
    }

2.5.执行结果：

3.Drools组件说明

KieBase：Drools中的知识库，它包含了运行规则所需要的所有知识元素。知识元素包括规则（Rule）、事实（Fact）、函数（Function）、配置（KieBaseConfiguration）等。KieBase 是Drools中规则引擎的核心部分，它负责管理和执行规则。KieBase 是线程安全的，可以在多个 KieSession 中共享。
KieSession：Drools规则引擎中与应用程序交互的接口，是一个运行时的状态容器，包含了 Work Memory、Pattern Matcher , Conflict Resolver 和 Executor 等组件。它用于加载和激活规则，插入事实，并执行规则的匹配和执行过程。KieSession 可以通过 KieBase 创建，并能够进行查询和获取执行结果等操作。
KieModule：Drools规则引擎中对规则集合进行打包和部署的单位。包含了多个KieBase和KieSession的配置信息的容器，可以是一个jar文件或者一个文件夹。KieModule可以从本地或者远程的Maven仓库中加载，实现规则的动态更新和灵活部署。
KieFileSystem：Drools规则引擎中用于动态加载和管理规则资源文件的组件。一个虚拟的文件系统，用来存储规则文件和其他资源文件。它可以添加、修改和删除规则文件，并可以与KieServices和KieBuilder等组件一起使用，实现规则的灵活维护和更新。
KieContainer：管理KieModule的容器，可以从本地或者远程的Maven仓库中加载KieModule，并且可以动态地更新KieModule。