Drools入门(二)——组件讲解

KieFileSystem

文件系统,用来存放构建规则引擎所需要的规则文件,以及构建规则时其他的组件配置信息,当规则构建过程中会将该文件系统的所有相关文件拷贝到MemoryFileSystem作为构建规则的文件系统使用,即当初始化完成后KieFileSystem里面的修改将不会对规则引擎有影响

KieModuleModel

全局模块管理器,一个规则引擎有且仅有一个全局模块,以xml的形式进行定义,可以理解为maven的pom文件的project节点,定义路径为src/main/resources/META-INF/kmodule.xml,路径源码中已规定不得修改,如果项目没有指定kmodule.xml文件,则默认生产一份默认的配置文件,内容如下

<kmodule xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
         xmlns="http://www.drools.org/xsd/kmodule">
  <kbase name="defaultKieBase" default="true" eventProcessingMode="cloud" equalsBehavior="identity" declarativeAgenda="disabled" sequential="false" sessionsPool="-1" scope="javax.enterprise.context.ApplicationScoped" packages="*">
    <ksession name="defaultStatelessKieSession" type="stateless" default="true" clockType="realtime" beliefSystem="simple"/>
    <ksession name="defaultKieSession" type="stateful" default="true" clockType="realtime" beliefSystem="simple"/>
  </kbase>
</kmodule>

源码在KieBuilderImpl.classbuildKieModuleModel()方法,srcMfs为文件系统,KieModuleModelImpl.KMODULE_SRC_PATH就是路径src/main/resources/META-INF/kmodule.xml,检查到文件系统中不存在则创建一个默认的新的KieModuleModel

private void buildKieModuleModel() {
    if ( srcMfs.isAvailable( KieModuleModelImpl.KMODULE_SRC_PATH ) ) {
        kModuleModelXml = srcMfs.getBytes( KieModuleModelImpl.KMODULE_SRC_PATH );
        try {
            kModuleModel = KieModuleModelImpl.fromXML( new ByteArrayInputStream( kModuleModelXml ) );
        } catch ( Exception e ) {
            results.addMessage( Level.ERROR,
                                "kmodule.xml",
                                "kmodule.xml found, but unable to read\n" + e.getMessage() );
            // Create a default kModuleModel in the event of errors parsing the XML
            kModuleModel = KieServices.Factory.get().newKieModuleModel();
        }
    } else {
        // There's no kmodule.xml, create a default one
        kModuleModel = KieServices.Factory.get().newKieModuleModel();
    }
    
    if ( setDefaultsforEmptyKieModule( kModuleModel ) ) {
        kModuleModelXml = kModuleModel.toXML().getBytes( IoUtils.UTF8_CHARSET );
    }
}

KieBaseModel

规则基础组件,在kmodule.xml中定义的kbase节点,一个全局模块管理器kmodule节点下可以包含多个kbase节点,作用是用来对规则引擎中的规则进行模块划分,划分依据是kbase节点上的packages属性对应规则文件drl中的package,同一个package下的所有规则将交给一个KieBaseModel处理。

需要注意:一个kmodule.xml只能有一个默认的kbase节点,缺省时能获取默认的KieBaseModel,由kbase节点上的default属性设置

源码在CompositeKnowledgeBuilderImpl.class中的buildPackageDescr()方法

private Collection<CompositePackageDescr> buildPackageDescr() {
    Map<String, CompositePackageDescr> packages = new HashMap<>();
    buildResource(packages, ResourceType.DRL, ResourceToPkgDescrMapper.DRL_TO_PKG_DESCR);
    buildResource(packages, ResourceType.GDRL,ResourceToPkgDescrMapper. DRL_TO_PKG_DESCR);
    buildResource(packages, ResourceType.RDRL, ResourceToPkgDescrMapper.DRL_TO_PKG_DESCR);
    buildResource(packages, ResourceType.DESCR, ResourceToPkgDescrMapper.DRL_TO_PKG_DESCR);
    buildResource(packages, ResourceType.DSLR, ResourceToPkgDescrMapper.DSLR_TO_PKG_DESCR);
    buildResource(packages, ResourceType.RDSLR, ResourceToPkgDescrMapper.DSLR_TO_PKG_DESCR);
    buildResource(packages, ResourceType.XDRL, ResourceToPkgDescrMapper.XML_TO_PKG_DESCR);
    buildResource(packages, ResourceType.DTABLE, ResourceToPkgDescrMapper.DTABLE_TO_PKG_DESCR);
    buildResource(packages, ResourceType.TDRL, ResourceToPkgDescrMapper.DRL_TO_PKG_DESCR);
    buildResource(packages, ResourceType.TEMPLATE, ResourceToPkgDescrMapper.TEMPLATE_TO_PKG_DESCR);
    buildResource(packages, ResourceType.GDST, ResourceToPkgDescrMapper.GUIDED_DTABLE_TO_PKG_DESCR);
    this.resourcesByType.remove(ResourceType.DRT); // drt is a template for dtables but doesn't have to be built on its own
    return packages.values();
}

private void buildResource(Map<String, CompositePackageDescr> packages, ResourceType resourceType, ResourceToPkgDescrMapper mapper) {
    List<ResourceDescr> resourcesByType = this.resourcesByType.remove(resourceType);
    if (resourcesByType != null) {
        for (ResourceDescr resourceDescr : resourcesByType) {
            try {
                registerPackageDescr(resourceDescr, packages, resourceDescr.resource, mapper.map(kBuilder, resourceDescr));
            } catch (RuntimeException e) {
                if (buildException == null) {
                    buildException = e;
                }
            } catch (Exception e) {
                if (buildException == null) {
                    buildException = new RuntimeException( e );
                }
            }
        }
    }
}

KieSessionModel

规则引擎执行器,规则引擎加载完成后用来执行规则的使用入口,设置入参并生成最后结果集等,在kbase节点中的ksession节点上定义,一个kbase节点下可以有多个ksession节点。

KieSessionModel分为两种,第一种是“有状态的KieSession”、一种是“无状态的StatelessKieSession”,由ksession节点上的type属性设置,type="stateful"时是“有状态的”,type="stateless"时是无状态的
KieSession可以理解为web项目中的session,它与用户相关有缓存的概念,使用完时需调用dispose()释放资源,StatelessKieSession则相反,没有缓存与用户无关,使用后无需调用dispose()释放资源

需要注意:一个kmodule.xml中两种session只能各自有一个默认的ksession节点,可以是在不同的kbase节点,缺省时能获取默认的KieSessionModel,由ksession节点上的default属性设置

源码在KieContainerImpl.classnewKieSession()newStatelessKieSession()

//获取默认的有状态session
public KieSession newKieSession() {
    return newKieSession((Environment)null, null);
}
//根据session名字获取有状态session
public KieSession newKieSession(String kSessionName) {
    return newKieSession(kSessionName, null, null);
}
//获取默认的无状态session
public StatelessKieSession newStatelessKieSession() {
    return newStatelessKieSession((KieSessionConfiguration)null);
}
//根据session名字获取无状态session
public StatelessKieSession newStatelessKieSession(String kSessionName) {
    return newStatelessKieSession(kSessionName, null);
}

KieContainer

最终容器,存放上述所有内容,同时用作生成KieSessionStatelessKieSession及规则引擎的版本控制

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,245评论 6 497
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,749评论 3 391
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 160,960评论 0 350
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,575评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,668评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,670评论 1 294
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,664评论 3 415
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,422评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,864评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,178评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,340评论 1 344
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,015评论 5 340
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,646评论 3 323
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,265评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,494评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,261评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,206评论 2 352

推荐阅读更多精彩内容