3.1 Hello World 实例
在上一章中介绍了Drools5x版本中规则引擎使用的实例,很明显在Drools7中KnowledgeBase类已经标注为“@Deprecated”——废弃。在本章节中介绍Drools7版本中的使用方法。后续实例都将默认使用此版本。
先看一下Drools项目的目录结构:
Maven pom.xml文件中依赖配置:
<properties> <drools-version>7.0.0.Final</drools-version> </properties> <dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.12</version> </dependency> <dependency> <groupId>org.drools</groupId> <artifactId>drools-compiler</artifactId> <version>${drools-version}</version> </dependency> </dependencies>
Fact对象对应的实体类依旧为Product:
package com.secbro.drools.model; /** * 产品类 * Created by zhuzs on 2017/7/4. */ public class Product { public static final String DIAMOND = "DIAMOND"; // 钻石 public static final String GOLD = "GOLD"; // 黄金 private String type; private int discount; // 省略getter/setter方法 }
规则文件依旧为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
与Drools5不同的是Drools中引入了kmodule.xml文件。配置内容如下:
<?xml version="1.0" encoding="UTF-8"?> <kmodule xmlns="http://www.drools.org/xsd/kmodule"> <kbase name="rules" packages="com.rules"> <ksession name="ksession-rule"/> </kbase> </kmodule>
配置简单说明:
Kmodule中可以包含一个到多个kbase,分别对应drl的规则文件。
Kbase需要一个唯一的name,可以取任意字符串。
packages为drl文件所在resource目录下的路径。注意区分drl文件中的package与此处的package不一定相同。多个包用逗号分隔。默认情况下会扫描resources目录下所有(包含子目录)规则文件。
kbase的default属性,标示当前KieBase是不是默认的,如果是默认的则不用名称就可以查找到该KieBase,但每个module最多只能有一个默认KieBase。
kbase下面可以有一个或多个ksession,ksession的name属性必须设置,且必须唯一。
以上为配置文件简单说明,后续会专门针对此配置文件进行详细介绍。
实例代码,本实例采用单元测试的方法进行编写:
@Test public void testRules() { // 构建KieServices KieServices ks = KieServices.Factory.get(); KieContainer kieContainer = ks.getKieClasspathContainer(); // 获取kmodule.xml中配置中名称为ksession-rule的session,默认为有状态的。 KieSession kSession = kieContainer.newKieSession("ksession-rule"); Product product = new Product(); product.setType(Product.GOLD); kSession.insert(product); int count = kSession.fireAllRules(); System.out.println("命中了" + count + "条规则!"); System.out.println("商品" +product.getType() + "的商品折扣为" + product.getDiscount() + "%。"); }
运行单元测试打印结果为:
命中了1条规则!
商品GOLD的商品折扣为25%。
1
2
以上实例首先定义了一个商品,支持DIAMOND和GOLD,并在规则文件中配置了这两种商品的折扣信息。然后传入商品类型为GLOD的FACT对象,并调用规则引擎,规则引擎执行了1条规则,并返回了此商品的折扣。
至此,我们已经完成了一个规则引擎的使用。通过上面的实例我们可以清楚的看到Drools7版本与Drools5版本之间所使用的API是完全两套API。