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对应章节中进行详细介绍。
原创文章,作者:ItWorker,如若转载,请注明出处:https://blog.ytso.com/15213.html