Drools是个规则引擎的开源实现。官方文档比较长。这里提供一个方法,搭建最基本的Drools运行环境,并提供一个简单示例。
环境准备:
JDK
至少需要JDK 1.5以上,JDK去这里下载:http://www.oracle.com/technetwork/java/javase/downloads/index.html
安装好之后,把 [JDK安装目录]/bin 加入到PATH
中,确保执行javac
没问题
Gradle构建工具
Gradle构建工具,去这里下载:https://gradle.org/releases/
安装好之后,把[Gradle安装目录]/bin 加入到PATH
中,确保执行gradle
没问题
Visual Studio Code插件(可选)
可以安装下 Java Extension Pack 这个插件,写Java代码时有自动提示。
构建简单示例的具体步骤
1. Gradle引入Drools库
用 Visual Studio Code 起个空项目,新建文件build.gradle
,这是Gradle的构建配置,内容如下:
apply plugin: 'java'
apply plugin: 'application'
repositories {
mavenCentral()
}
dependencies {
compile group: 'org.kie', name: 'kie-api', version: '7.5.0.Final'
compile group: 'org.drools', name: 'drools-compiler', version: '7.5.0.Final'
}
第 1、2 行引入了 Java 插件,使Gradle可以构建Java代码,8、9、10 行引入了执行Drools依赖的两个库。6、7 行告诉 Gradle 从Maven Repository下载两个依赖库
2. 让Java程序跑起来
建立src/main/java
目录,这是Gradle规定的,Java代码都要放在这个目录里面。
运行Java程序,必须至少有一个类,这个类必须得有个主函数。
所以新建一个Main.java文件,写上Main
类和 main 函数:
package drools.sample;
public class Main
{
public static void main(String[] args) {
System.out.println("Hello, World");
}
}
每个Java类必须属于一个 package 中,package 的名字和目录层级是一一对应的,所以这里的 Main.java 应该放在这里:
还要告诉Gradle,Java的main函数在哪个类里面,build.gradle中加上这一句:
这时候执行gradle run
,如果输出中能看到打印了 Hello World,说明Java 环境没有问题了。
3. 编写规则文件
规则引擎的基本套路是:用一套规则,去检查数据是否符合规则,如果符合规则,那么可以在数据上执行一些操作(增删查改都可以)。
- 规则是定义在文本文件里的,以 .drl 格式结尾
- 数据就存在 Java 的类实例中。规则引擎跑起来的时候,需要将数据放在一个 Session 的结构中,规则只会对 Session 中的数据进行检查。
现在用Drools实现一个最简单的功能:用户可以在系统提交申请,如果用户年龄小于18岁,则判断申请是无效的。
先写一个 Java 类,保存申请信息:
package drools.sample;
public class Applicant
{
public String name;
public int age;
public boolean valid;
}
然后编写规则文件:
package drools.sample;
rule "Is of valid age" // 给规则取个名
when
$a : Applicant( age < 18 ) // 规则
then
// 符合规则后执行的操作,是Java代码
$a.valid = false;
System.out.println($a.name + "小于18岁,不能申请");
end
注意规则文件也有 package 名,这个package名必须和Main函数所在的package一致!!!
上述两个文件的存放位置:
4. 让规则跑起来
运行Drools需要一个XML配置,固定名称叫kmodule.xml
,放在这里:
配置文件至少包含下面几行:
<kmodule xmlns="http://www.drools.org/xsd/kmodule">
<kbase name="kbase1" packages="drools.sample">
<ksession name="ksession1" />
</kbase>
</kmodule>
XML配置定义了规则所属的 package (要和.drl文件里的 package 名一致)。还定义了一个Session。
最后完善Main函数:
package drools.sample;
import org.kie.api.KieServices;
import org.kie.api.runtime.KieContainer;
import org.kie.api.runtime.KieSession;
public class Main
{
public static void main(String[] args) {
KieServices ks = KieServices.Factory.get();
KieContainer kc = ks.newKieClasspathContainer();
KieSession kSession = kc.newKieSession("ksession1");
Applicant a = new Applicant();
a.name = "Xiao,ming";
a.age = 15;
a.valid = true;
kSession.insert(a);
kSession.fireAllRules();
kSession.dispose();
System.out.println(a.valid);
}
}
Main函数10~12行建立了规则引擎执行环境,创建了一个 Session
14~17行创建了一个申请对象,设置年龄15岁,并把该对象插入到 Session 中
18行开始执行规则
19行规则执行完成,清理 Session 中的数据
最后运行gradle run
输出中可以看到一个 false,说明申请年龄小于18岁,valid字段被设置成了false。如果把申请年龄设置为20,那么输出就会是true