Drools Fusion(CEP)定义及使用方法讲解

时间:2022-02-21 09:54:22

从 Drools 统一行为建模平台的视野看,Drools Fusion 是负责启用事件处理行 为的一个模块。

定义

支持复杂事件处理,是比简单的理解事件是什么要更多得多,cep场景具有几个共同而明显的特点:

  • 通常需要处理巨量的事件,但是只有少部分事件是真正关心的。
  • 事件通常是不变的,因为它们是状态改变的一条记录。
  • 通常有关事件的规则和查询必须是运行在被动模式(reactive modes),即,对事件模式(patterns)的检测作出反应。
  • 通常在相关的事件之间有强烈的时间关系。
  • 个别事件通常是不重要的。系统关心相关事件的模式(patterns)和它们的关系
  • 通常,要求系统执行组合和聚合的事件。

用fusion,要把插入drools的数据声明为事件。

drools处理数据有两种方式,云模式和流模式,默认是云模式,用fusion,需要设置为流模式。流模式,插入的数据叫事件,有时间顺序,云模式没有,

流(stream)支持

大部分 CEP 用例必须处理事件流(stream)。

流的特性:

  • 在流中的事件通过时间戳被排序。
  • 事件的数量(volumes)总是很高的。
  • 原子事件自己是很少有用的。通常根据多个事件之间的相关性或流或其他来源提取含义。
  • 流可以是相似的,即包含单一类型的事件;或者是异类的,即包含多种类型的事件。

声明流模式

在kmodule.xml 中添加配置 eventProcessingMode=“stream” 为流模式

<kbase name="fusionAge" eventProcessingMode="stream" packages="com.us.fusion">
    <ksession name="fusionAgeKS" type="stateful"/>
</kbase>

事件声明

用fusion,要把插入drools的数据声明为事件,声明事件使用@role标签

@role

把@role元数据标签指派给该事实类行

例如:

Person 为java bean 也就是一个事实类型

declare Person
  @role(event)
end

Person 的属性如下:

public class Person {
  private String name;
  private Integer age;
  private String like;
  private String sex;
  private String desc;
  private String address;
  private Date createTime;
  // getter setter 省略

@timestamp

每一个事件都要有一个关联的时间戳指派给它。默认时,一个给定事件的时间戳是在事件被插入到工作内存时,从 Session Clock 读取,并且分配给该事件。有些时候,事件用时间戳作为它自己的一个属性。在这情况下,用户可以用@timestamp 标记用户属性为时间戳

例如:用Person的 createTime 属性为时间戳

declare Person
  @role(event)
  @timestamp( createTime )
end

@expires

重要:这个标签只有引擎运行在流(STREAM)模式之下才会被考虑.

该标签显示定义 一个事件在什么时候应该到期,事件到期,事件可能不再匹配和激活任何规则时。

使用如下

    @expires( 1h35m )

在person 例子中假设过期时间为20S

declare Person
  @role(event)
  @timestamp( createTime )
  @expires(20s)
end

滑动时间窗口

滑动时间窗口允许用户编写规则,其将仅匹配在最近的 X 时间单元内发生的事件

rule "boy"
   when
      $p : Person(age < 25) over window:time(3s)
   then
      $p.setDesc("少年");
      retract($p);
end

例如:只匹配最近3秒内,年龄小于25的人

调用代码如下:

package com.us.fusion;
import com.us.model.Person;
import org.kie.api.KieServices;
import org.kie.api.runtime.KieContainer;
import org.kie.api.runtime.KieSession;
import java.util.Date;
/**
 * Created by yangyibo on 17/1/3.
 * @author yangyibo
 */
public class Application {
  private static KieSession getSession() {
    KieServices ks = KieServices.Factory.get();
    KieContainer kc = ks.getKieClasspathContainer();
    return kc.newKieSession("fusionAgeKS");
  }
  public static void run() {
    KieSession ks = getSession();
    Person p1 = new Person("白展堂", 2,new Date());
    Person p2 = new Person("佟湘玉", 7,new Date());
    try {
      Thread.sleep(4000);
    } catch (InterruptedException e) {
      System.out.println(e);
    }
    Person p3 = new Person("李大嘴", 16,new Date());
    ks.insert(p1);
    ks.insert(p2);
    ks.insert(p3);
    int count = ks.fireAllRules();
    System.out.println("总执行了" + count + "条规则------------------------------");
//    ks.dispose();
  }
  public static void main(String[] args) {
    run();
  }
}

规则代码如下:

package com.us.fusion7
import com.us.model.Person
function void printName(String streamName,String name,int age,String desc) {
      System.out.println("streamName:"+streamName+" name:"+name+" age:"+age+" desc:"+ desc);
    }
declare Person
  @role(event)
  @timestamp( createTime )
  @expires(20s)
end
rule "boy"
   when
      $p : Person(age > 0) over window:time(3s)
   then
      $p.setDesc("少年");
      retract($p);
      printName("boy",$p.getName(),$p.getAge(),$p.getDesc());
end

由于Thread.sleep(4000);所以最近3秒内只有李大嘴一条记录所以

结果如下:

streamName:boy  name:李大嘴 age:16 desc:少年
总执行了1条规则------------------------------

范例2 10S 内的平均年龄

滑动长度窗口

和滑动时间窗口很类似,其将仅匹配最近几次发生的事件,用法如图,只匹配最近1次发生的事件。

rule "old"
   when
      $p : Person(age > 49) over window:length(2)
   then
      $p.setDesc("老年");
      retract($p);
end

例如年领大于49岁的最近两条记录

调用代码:

public class Application {
  private static KieSession getSession() {
    KieServices ks = KieServices.Factory.get();
    KieContainer kc = ks.getKieClasspathContainer();
    return kc.newKieSession("fusionAgeKS");
  }
  public static void run() {
    KieSession ks = getSession();
    Person p1 = new Person("白展堂", 52,new Date());
    Person p2 = new Person("佟湘玉", 57,new Date());
    try {
      Thread.sleep(4000);
    } catch (InterruptedException e) {
      System.out.println(e);
    }
    Person p3 = new Person("李大嘴", 56,new Date());
    ks.insert(p1);
    ks.insert(p2);
    ks.insert(p3);
    int count = ks.fireAllRules();
    System.out.println("总执行了" + count + "条规则------------------------------");
    ks.dispose();
  }
  public static void main(String[] args) {
    run();
  }
}

规则代码

package com.us.fusion7
import com.us.model.Person
function void printName(String streamName,String name,int age,String desc) {
      System.out.println("streamName:"+streamName+" name:"+name+" age:"+age+" desc:"+ desc);
    }
declare Person
  @role(event)
  @timestamp( createTime )
  @expires(20s)
end
rule "old"
   when
      $p : Person(age > 49) over window:length(2)
   then
      $p.setDesc("老年");
      retract($p);
      printName("boy",$p.getName(),$p.getAge(),$p.getDesc());
end

只匹配符合规则的最近的两条记录,所以舍弃“白展堂记录”

执行结果

streamName:boy  name:李大嘴 age:56 desc:老年
streamName:boy  name:佟湘玉 age:57 desc:老年
总执行了2条规则------------------------------

本文所有测试例子的pom 依赖

    <dependency>
      <groupId>org.kie</groupId>
      <artifactId>kie-api</artifactId>
      <version>6.5.0.Final</version>
    </dependency>
    <dependency>
      <groupId>org.drools</groupId>
      <artifactId>drools-core</artifactId>
      <version>6.5.0.Final</version>
    </dependency>
    <dependency>
      <groupId>org.drools</groupId>
      <artifactId>drools-compiler</artifactId>
      <version>6.5.0.Final</version>
    </dependency>
    <dependency>
      <groupId>org.drools</groupId>
      <artifactId>drools-decisiontables</artifactId>
      <version>6.5.0.Final</version>
    </dependency>
    <dependency>
      <groupId>org.drools</groupId>
      <artifactId>drools-templates</artifactId>
      <version>6.5.0.Final</version>
    </dependency>

本文所有测试例子的kmodule.xml 配置

 <kbase name="fusionAge" eventProcessingMode="stream" packages="com.us.fusion">
    <ksession name="fusionAgeKS" type="stateful"/>
 </kbase>

其他关键字: After, Before, During, Meet 等关键字 都是用于比较两个事件的发生时间顺序,用法待以后再叙

总结

以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,谢谢大家对服务器之家的支持。