Drools6 入门学习(二)——从HelloWorld看Drools为你做了哪些事

相信看过Drools的人一定看到过它最简单的HelloWorld的例子,接下来让我们看下它究竟为我们做了那些事情。
例子如下:
HelloWorld.java

public class HelloWorldExample {
    public static final void main(final String[] args) {
        KieServices ks = KieServices.Factory.get();
        KieContainer kc = ks.getKieClasspathContainer();
        KieSession ksession = kc.newKieSession("HelloWorldKS");
        final Message message = new Message();
        message.setMessage( "Hello World" );
        message.setStatus( Message.HELLO );
        ksession.insert( message );
        ksession.fireAllRules();
        ksession.dispose();
    }

    public static class Message {
        public static final int HELLO   = 0;
        public static final int GOODBYE = 1;
        private String          message;
        private int             status;
        //....
}

helloWorld.drl

package org.drools.examples.helloworld

import org.drools.examples.helloworld.HelloWorldExample.Message;

rule "Hello World"
    dialect "mvel"
    when
        m : Message( status == Message.HELLO, message : message )
    then
        System.out.println( message );
    modify ( m ) { message = "Goodbye cruel world",
                   status = Message.GOODBYE };
end

rule "Good Bye"
    dialect "java"
    when
        Message( status == Message.GOODBYE, message : message )
    then
        System.out.println( message );
end
<?xml version="1.0" encoding="UTF-8"?>
<kmodule xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xmlns="http://jboss.org/kie/6.0.0/kmodule">
    <kbase name="HelloWorldKB" packages="org.drools.examples.helloworld">
        <ksession name="HelloWorldKS"/>
    </kbase>
</kmodule>

关于Drools规则如何编写,KModule.xml如何写,如何调用规则这些请参考Drools-6.1.0.Final_入门文档。
我想通过对源码的解析来介绍KIE API为我们方便的操控引擎做了哪些事情。
KIE的API中有以下的几个类和接口需要介绍下:

KieServices
该接口提供了很多方法,可以通过这些方法访问KIE关于构建和运行的相关对象,比如说可以获取KieContainer,利用KieContainer来访问KBase和KSession等信息;可以获取KieRepository对象,利用KieRepository来管理KieModule等。
KieServices就是一个中心,通过它来获取的各种对象来完成规则构建、管理和执行等操作。

KieContainer
可以理解KieContainer就是一个KieBase的容器。

KieBase
KieBase就是一个知识仓库,包含了若干的规则、流程、方法等,在Drools中主要就是规则和方法,KieBase本身并不包含运行时的数据之类的,如果需要执行规则KieBase中的规则的话,就需要根据KieBase创建KieSession。

KieSession
KieSession就是一个跟Drools引擎打交道的会话,其基于KieBase创建,它会包含运行时数据,包含“事实 Fact”,并对运行时数据事实进行规则运算。我们通过KieContainer创建KieSession是一种较为方便的做法,其实他本质上是从KieBase中创建出来

KieRepository
KieRepository是一个单例对象,它是一个存放KieModule的仓库,KieModule由kmodule.xml文件定义(当然不仅仅只是用它来定义)。

KieProject
KieContainer通过KieProject来初始化、构造KieModule,并将KieModule存放到KieRepository中,然后KieContainer可以通过KieProject来查找KieModule定义的信息,并根据这些信息构造KieBase和KieSession。

ClasspathKieProject
ClasspathKieProject实现了KieProject接口,它提供了根据类路径中的META-INF/kmodule.xml文件构造KieModule的能力,也就是我们能够基于Maven构造Drools组件的基本保障之一。

KieServices ks = KieServices.Factory.get()

KieServices实际上是一个接口,但是接口中有一个静态工厂用来得到实例化的KieServicesImpl.

KieContainer kc = ks. getKieClasspathContainer()

得到的KieServices 通过调用方法读取配置文件然后得到Kie容器。

public KieContainer getKieClasspathContainer () {
        return getKieClasspathContainer( findParentClassLoader() );
}

ClassLoader是类加载器,用来加载Java类到Java虚拟机。首先根据findParentClassLoader()获得类加载器然后把相关的父类父接口都放进类加载器中。
然后调用getKieClasspathContainer(ClassLoader loader),返回当前存在的KieContainer或者实例化一个KieContainer返回。
实例化新的Container返回:

public KieContainer newKieClasspathContainer(ClassLoader classLoader) {
        return new KieContainerImpl(new ClasspathKieProject(classLoader, listener), null);
    }

ClasspathKieProject主要作用是根据根据类路径中的META-INF/kmodule.xml文件构造KieModule。他是什么时候进行构造呢?
是在ClasspathKieProject实例化然后传入KieContainerImpl的构造函数中:

 public KieContainerImpl(KieProject kProject, KieRepository kr) {
        this.kr = kr;
        this.kProject = kProject;
        kProject.init();//这才是关键
    }

调用的是ClasspathKieProject实现的KieProject的init()方法.

public void init() {
        this.classLoader = createProjectClassLoader(parentCL);
        discoverKieModules();
        indexParts(kieModules.values(), kJarFromKBaseName);
    }

其中this.classLoader = createProjectClassLoader(parentCL)因为classLoader没怎么深入的了解,所以有点不清不楚。

discoverKieModules()

很关键的一个方法,他通过两个路径KMODULE_JAR_PATH、KMODULE_SPRING_JAR_PATH来查找相应的META-INF下的kmodule.xml或者是kmodule-spring.xml,通过这两个配置文件来构造相应的kieModules。然后将得到的KieModules放入Map

String[] configFiles = {KieModuleModelImpl.KMODULE_JAR_PATH, KieModuleModelImpl.KMODULE_SPRING_JAR_PATH};

比如我在META-INF中放了一个kmodule.xml,Jar包中引入了一个drools-examples-6.2.0.CR4.jar,因此里面也有一个kmodule.xml。所以在运行完后kieModules如下:

{org.drool:droolDemo:0.0.1-SNAPSHOT=FileKieModule[ ReleaseId=org.drool:droolDemo:0.0.1-SNAPSHOTfile=E:\java\workspace2\droolDemo\target\classes], org.drools:drools-examples:6.2.0.CR4=ZipKieModule[ ReleaseId=org.drools:drools-examples:6.2.0.CR4file=C:\Users\Administrator.m2\repository\org\drools\drools-examples\6.2.0.CR4\drools-examples-6.2.0.CR4.jar]}

可以看出一个是Jar包中读取到的配置文件,一个是项目中的classpath下配置文件。

indexParts(..)

protected void indexParts(Collection<InternalKieModule> kieModules,Map<String, InternalKieModule> kJarFromKBaseName);

源码太长不引人了,主要功能是根据上一步的到的kieModules,获得相应KieModuleModel、KieBaseModel、KieSessionModel然后放入AbstractKieProject所对应的Map以及对象中。

private KieBaseModel    defaultKieBase  = null;
private KieSessionModel defaultKieSession  = null;
private KieSessionModel defaultStatelessKieSession = null;

这些用来放Kmodule.xml中定义为default的KieBase、KieSession、StatelessKieSession。而这边只有一个对象,所以为什么默认的只有一个的缘故。当然要是有多个,newKieSession()怎么知道哪一个。

protected final Map<String, KieBaseModel>    kBaseModels;
Map<KieBaseModel, Set<String>> includesInKieBase;
protected final Map<String, KieSessionModel> kSessionModels;

之后我们都是通过KieSession的name找到相应KieSessionModel,通过KieBase的name找到相应的KieBaseModel。然后通过相应的KieSessionModel、KieBaseModel来得到相应的KieSession以及KieBase。

KieSession ksession = kc.newKieSession(“HelloWorldKS”);

KieSession ksession = kc.newKieSession("HelloWorldKS");
KieBase kiebase = kc.getKieBase("kieBase");
 public KieSession newKieSession(String kSessionName, Environment environment, KieSessionConfiguration conf) {
        //传入的environment、conf都是null。KieSessionConfiguration用法在Drools6新特性中有提到过。
        KieSessionModelImpl kSessionModel = (KieSessionModelImpl) getKieSessionModel(kSessionName);
        //DO1 验证是否找到相应的Model
        //DO2 验证生成Model是否是StateFul,默认生成的KieSession都是stateFul
        //DO3 找到相应的KieBase
        //DO4 根绝KieBase以及KSessionModel生成相应的KieSession
        //DO5 放入一个存储有状态的KieSession的Map,之后可以在需要的时候先从Map里面找。 
    }

ksession.insert( message );

public FactHandle insert(final Object object) {
        return insert( object, /* Not-Dynamic */
 null,false,false,null,null );
 }
public FactHandle insert(final Object object,final Object tmsValue,final boolean dynamic,boolean logical,final RuleImpl rule,final Activation activation) {
        checkAlive();
        return this.defaultEntryPoint.insert( object,
tmsValue,dynamic,logical,rule,activation );
}

在向KieSession插入fact,规则引擎首先检查的是KieSession是否还能使用。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章