Drools KIE API

搭建Drools开发环境中我们接触了几个Drools的API,例如:

  • KieServices
  • KieContainer
  • KieSession

还有kmodule.xml文件中的几个选项:

  • kmodule
  • kbase
  • ksession

那么这些东西都是什么概念呢

Kie是什么

KIE是jBoss里面一些相关项目的统称,例如jBPM和Drools
这些项目都有一定的关联关系,并且存在一些通用的API,比如说涉及到构建(building)、部署(deploying)和加载(loading)等方面的
这些API就都会以KIE作为前缀来表示这些是通用的API
前面看到的一些KieServices、KieContainer、KieSession类就都是KIE的公共API

Kie生命周期

Kie项目的生命周期都会包含以下几个过程:

1.编写:编写规则文件等
2.构建:构建一个可以发布部署的组件(jar文件)
3.测试:部署之前对规则进行测试
4.部署:利用Maven仓库将jar部署到应用程序
5.使用:程序中加载jar文件并通过KieContainer对jar文件进行解析创建KieSession
6.执行:通过KieSession对象的API跟Drools引擎进行交互执行规则
7.交互:用户通过命令行或者UI跟引擎进行交互
8.管理:管理KieSession或者KieContainer对象

使用Kie项目的流程就是以上生命周期的过程,之前的Hello World例子就是生命周期中的测试、使用、执行等部分

API概述

了解了Kie是什么之后,现在回头看看我们用到的API

KieServices

通过KieServices.Factory.get()方式获得,是一个单例的、线程安全的,为其他Kie工具提供服务
KieServices是Kie项目的中心,通过其可以获取的各种对象来完成规则构建、管理和执行等操作
其中有的方法分为两大类:getX()和newX(),其中,get只会返回一个对应单例对象的引用,new则会重新创建一个对象

KieRepository

是一个单例的存放所有KieModule的仓库,无论KieModule是存放在Maven仓库中还是动态配置的
KieModule由kmodule.xml文件定义,也可以由代码来定义

KieContainer

从KieServices中获得,其会借助KieProject来**初始化、构造**KieModule并将放入KieRepository中
是一个给定的KieModule中所有KieBase的存放容器

KieProject

KieContainer可以通过KieProject来**查找**KieModule定义的信息,并根据这些信息构造KieBase和KieSession

ClasspathKieProject

ClasspathKieProject实现了KieProject接口,它提供了根据类路径中的META-INF/kmodule.xml文件构造KieModule的能力

KieBase

KieBase就是一个知识仓库,包含了若干的规则、流程、方法等,但是不包含运行时的数据

KieSession

KieSession就是一个跟Drools引擎打交道的会话,其基于KieBase创建
KieContainer创建KieSession是一种较为方便的做法,其实他本质上是从KieBase中创建出来

为了理解方便,我们可以将整个Kie项目看成是一个KieProject
这个KieProject包含了一个kmodule.xml文件
其中定义了kmodule、kbase和ksession等选项,可以将其看成API中对应的KieModule等工具

要使用这个Kie项目,首先创建KieServices
通过getKieClasspathContainer方法获得KieContainer
KieContainer通过KieProject加载kmodule文件(ClasspathKieProject实现的)
创建KieModule放入KieRepository
KieContainer又可以通过KieProject到KieRepository中找到对应的KieModule创建KieBase知识库(也就是各个规则文件中的规则)
通过KieBase创建KieSession规则会话到规则引擎(KieContainer创建KieSession其实是通过KieBase)

kmodule.xml中的属性

该文件中的每个选项都有很多属性,列出几个常用属性作为参考

kbase的属性

属性名 默认值 合法的值 描述
name none any KieBase的名称,必须设置
includes none 逗号分隔的KieBase名称列表 意味着该KieBase会包含所有include的KieBase的rule等文件
packages all 逗号分隔的字符串列表 默认情况下将包含resources目录下面(子目录)的所有规则文件,也可以指定具体目录下面的规则文件
default false true, false 表示当前KieBase是不是默认的,如果是默认的话,不用名称就可以查找到该KieBase,但是每一个module最多只能有一个KieBase
equalsBehavior identity identity, equality 判断Working Memory中对象相等的依据,identity可以理解为用==判断;equality就是通过Fact对象的equals方法来判断

ksession的属性

属性名 默认值 合法的值 描述
name none any KieSession的名称,该值必须唯一,必须设置
type stateful stateful, stateless 定义该session到底是有状态的还是无状态的,有状态的session可以利用Working Memory执行多次,而无状态的则只能执行一次
default false true, false 定义该session是否是默认的,如果是默认的话则可以不用通过session的name来创建session,在同一个module中最多只能有一个默认的session

参考:

Drools官方文档
KIE JAVA API
Drools入门系列

作者:@小黑

相关文章
相关标签/搜索