3. Drools入门实战

在金融风控场景中，规则往往需要频繁调整，例如反欺诈名单、授信额度阈值、交易频次限制等。如果把这些逻辑硬编码在Java里，每次变更都要重新编译、测试和发布，响应速度很难满足业务要求。Drools作为一款成熟的规则引擎，能够把“规则”从代码中抽离出来，用接近自然语言的方式描述业务判断，并由引擎负责匹配和执行。本章将完成从零到一的入门实战：搭建环境、配置Maven依赖、编写第一个Hello World规则、调用KIE API，并解析规则文件结构。

一、核心原理：Drools如何把规则“跑起来”

Drools的核心是Rete算法及其衍生实现。它会把规则中的条件编译成一张网络，当事实（Fact）插入工作内存（Working Memory）时，引擎沿着网络传播匹配结果，而不是每次都对所有规则做全量遍历。这样在规则数量较多时，仍能保持较好的匹配效率。

理解Drools需要抓住三个关键词：Fact、Rule、KIE。Fact是插入引擎的普通Java对象，例如一笔交易、一个客户；Rule是“当条件满足时执行动作”的声明；KIE（Knowledge Is Everything）是Drools 6之后统一的API体系，负责加载规则、创建会话、执行规则。规则文件通常以.drl结尾，由包声明、导入、规则定义等部分组成。

二、环境搭建与Maven依赖配置

Drools基于Java，推荐使用JDK 8或JDK 11，Maven 3.6以上。创建普通Maven项目后，在pom.xml中引入Drools核心依赖。对于入门实战，通常只需要drools-core、drools-compiler和kie-api。如果使用Drools 7.x，可以统一引入drools-engine或按模块引入。

<dependencies>
    <dependency>
        <groupId>org.drools</groupId>
        <artifactId>drools-core</artifactId>
        <version>7.74.1.Final</version>
    </dependency>
    <dependency>
        <groupId>org.drools</groupId>
        <artifactId>drools-compiler</artifactId>
        <version>7.74.1.Final</version>
    </dependency>
    <dependency>
        <groupId>org.kie</groupId>
        <artifactId>kie-api</artifactId>
        <version>7.74.1.Final</version>
    </dependency>
</dependencies>

如果项目使用Spring Boot，也可以引入kie-spring，但入门阶段不建议直接上集成框架，先手动创建KieContainer更能看清执行链路。依赖下载完成后，建议执行一次mvn clean compile，确认本地仓库和编译环境正常。

三、Hello World规则示例与KIE API基本使用

下面编写一个最简单的规则：当插入一个Customer对象且其风险等级为“HIGH”时，打印风险提示。首先定义Fact类：

public class Customer {
    private String name;
    private String riskLevel;
    // 省略 getter/setter 和构造方法
}

在src/main/resources/rules目录下创建hello.drl：

package rules;

import com.example.fact.Customer;

rule "HighRiskCustomer"
    when
        $c: Customer(riskLevel == "HIGH")
    then
        System.out.println("高风险客户：" + $c.getName());
end

接着使用KIE API加载并执行规则：

KieServices kieServices = KieServices.Factory.get();
KieContainer kieContainer = kieServices.getKieClasspathContainer();
KieSession kieSession = kieContainer.newKieSession();

Customer customer = new Customer("张三", "HIGH");
kieSession.insert(customer);
kieSession.fireAllRules();
kieSession.dispose();

运行后控制台会输出“高风险客户：张三”。这段代码体现了KIE API的基本流程：获取KieServices → 创建KieContainer → 创建KieSession → 插入Fact → 触发规则 → 释放会话。其中getKieClasspathContainer()会扫描类路径下的META-INF/kmodule.xml和规则文件。如果没有该配置文件，也可以手动构建KieFileSystem和KieBuilder，但入门阶段使用类路径容器最方便。

四、规则文件结构解析与常见误区

一个标准的.drl文件通常包含以下部分：

初学者常见的误区有三个。第一，把package当成Java包路径，实际上它只是规则文件的逻辑命名空间，和文件目录不要求严格一致。第二，在then中直接修改Fact属性后，误以为规则会自动重新匹配；实际上需要调用update()通知引擎，否则引擎不会感知变化。第三，忽略kmodule.xml的作用，导致类路径容器找不到规则。一个最小的kmodule.xml如下：

<kmodule xmlns="http://jboss.org/kie/6.0.0/kmodule">
    <kbase name="kbase" packages="rules">
        <ksession name="ksession" />
    </kbase>
</kmodule>

复盘来看，入门阶段最重要的不是记住所有API，而是理解“规则文件是声明式的，引擎负责匹配”。只要Fact、规则、会话三者的关系清晰，后续学习金融风控中的规则流、决策表、CEP复杂事件处理都会顺畅很多。建议读者亲手把Hello World跑通，再尝试修改条件、增加第二条规则，观察fireAllRules()的返回值和执行顺序，这对建立规则引擎的直觉非常有帮助。