CEP 引擎

语法

createCEPEngine(name, monitors, dummyTable, eventSchema, [deserializeParallelism=1], [timeColumn], [eventQueueDepth=1024], [outputTable], [dispatchKey], [dispatchBucket], [useSystemTime=true], [eventTimeField="eventTime"])

参数

name 字符串标量，表示 CEP 引擎的名称。可包含字母，数字和下划线，但必须以字母开头。

monitors 元代码或元代码元组，可包含一个或多个 Monitor 类的构造函数调用。如果指定了多个 Monitor 类的构造函数调用，在创建 subEngine 时，将按照指定的顺序构造这些对象。Monitor 的创建方法参见 简单的 Monitor 实例。

dummyTable 一个表对象，和订阅的流数据表的 schema 一致。

class event1 {
  var1:: STRING
  var2:: INT
  def event1(){
    var1 = ""
    var2 = 0
  }
}

class event2 {
  var1:: DOUBLE
  var2:: INT
  def event2(){
    var1 = 0.0
    var2 = 0
  }
}

//指定为标量
eventSchema = event1
//指定为向量
eventSchema = [event1, event2]

deserializeParallelism 整型标量，用于指定反序化的线程数，默认值为1。

timeColumn 可选参数，字符串标量或向量，用于指定 dummyTable 中的时间列。指定后，通过事件流序列化器（Stream Event Serializer）向 CEP 引擎插入事件时，该列将作为事件时间。

eventQueueDepth 整型标量，用于指定子引擎接收事件队列和输出队列的最大深度，默认值是1024。

outputTable 一个表对象，用于输出事件以供后续操作使用。如果调用了 emitEvent 接口，则需要指定该参数为 StreamEventSerializer 返回的表对象。

dispatchKey 字符串标量，用于指定事件中的属性，该属性中的每个唯一值被视为一个 key。若不指定 dispatchKey，则引擎将创建一个名为 name 的子引擎（与 CEP 引擎同名）。

dispatchBucket 整型标量，表示哈希分组的数量。如果指定该参数，引擎将对 dispatchKey 指定的字段进行哈希分组。

CEP 引擎根据 dispatchKey 和 dispatchBucket 自动创建子引擎，并行处理数据。各个子引擎之间互相独立。若未指定 dispatchKey，则 CEP 引擎只有一个处理线程，即只创建一个子引擎。

useSystemTime 布尔值，表示是否使用数据注入引擎时的系统时间进行计算。

• 当 useSystemTime = true 时（缺省值）时，CEP 引擎中的计算都基于数据注入引擎的时刻（以毫秒精度表示的本地系统时间）进行，与数据中的时间列无关。

• 当 useSystemTime = false 时，CEP 引擎中的计算都基于数据中的 timeColumn 列进行。

eventTimeField 可选参数，字符串标量或向量，用于指定事件中的时间字段，仅在 useSystemTime = false 有效。如果所有事件的时间字段名都相同，则 eventTimeField 是一个标量；否则，eventTimeField 是一个向量，其长度和 eventSchema 的长度相同，每个元素分别代表每个事件的时间字段。通过 appendEvent 直接向 CEP 引擎插入事件时，必须通过该参数指定事件的时间。

在 CEP 引擎中，通过 addEventListener 指定事件匹配规则和回调函数。事件监听器只能在 Monitor 内调用，其观察注入引擎的每个事件，当事件或事件模式与匹配规则相匹配时，会触发执行回调函数。

语法

addEventListener(handler, [eventType], [condition], [times="all"], [at], [wait], [within], [exceedTime])

参数

• 事件匹配：

  handler 回调函数，如果指定了 eventType 则为一元函数，参数为匹配的事件。如果指定为按时间触发，则没有参数。

  def actions1(stockVal){
      //将事件类型 stockVal 的属性写入一个共享表
      insert into objByName("sharedUSPrices") values([stockVal.price, stockVal.qty])
  } 

  handler 中可以动态添加新的监听器：

  def actions1(stockVal){
      //将事件类型 stockVal 的属性写入一个共享表
      insert into objByName("sharedUSPrices") values([stockVal.price, stockVal.qty])
      //新增加一个事件侦听器
      addEventListener(handler=action2, eventType="Stock", condition=<self.prices > stockVal.price>)
  }

  eventType字符串标量，表示事件类型。若指定为 “any”，则表示任意事件。

  condition 元代码类型，指定匹配的事件条件，即事件匹配规则。元代码的返回结果必须是布尔值。例如 eventType 为 Stock 时，指定 <Stock.price > 10 and Stock.qty < 10> 。

  times 可以是正整数或者 ”all”，表示在 handler 被触发指定次数后自动删除监听，默认为 ”all”。例如，若设置为 5，表示 handler 被触发 5 次后，将删除该监听器；若设置为 ”all”，则会持续监听事件，对每个匹配的事件都触发 handler，直至引擎被删除。

• 按时间触发（此时不会进行事件匹配，因此不可指定 eventType）：

  at 一个长度为 6 的元组，用于指定触发 handler 的时间频率。其形式为 (seconds，minutes, hours, days_of_the_week，days_of_the_month, month ) ，其中各元素依次表示秒（必须指定）、分钟、小时、一周中的第几天、当月的第几天、月份。如果times="all”，则表示每月/日/周几/小时/分钟的第 seconds 秒触发 handler。例如：(0, 5, , , )，表示在每小时的 05 分触发 handler。如果 times 指定为具体数字，则 handler 只会被触发指定次数。

  wait DURATION 类型，表示等待多长时间后触发 handler。如果 times=”all”，则表示每隔多久触发 handler。例如：wait = 60s, times =”all”，每隔 60秒触发一次 handler。如果 times 指定为具体数字，则 handler 只会被触发指定次数。

• 同时限定时间和事件：

  within 仅在限定的时间内收到匹配的事件时才触发 handler。例如：eventType="tickets", within=60s ，表示60秒内匹配到事件 tickets，则触发 handler，否则删除这个监听器。

  exceedTime 仅在限定的时间内没有匹配的事件时才触发 handler。例如：eventType="tickets", exceedTime=60s，表示若60秒内未匹配到事件 tickets，则触发 handler，否则删除这个监听器。

下面举例说明事件监听器的几种触发方式：

向 CEP 引擎注入事件有两种方法：

• 通过 appendEvent 接口，直接将事件实例写入 CEP 引擎。

• 将异构流表中的数据写入 CEP 引擎：在实时场景中，通过 subscribeTable 函数订阅异构流表，可以将不同类型的数据输入引擎。异构流表数据来自 replay 事件回放或者通过 API 写入。

这两种方式的主要区别在于，appendEvent 写入事件不需要序列化和反序列化；而通过异构流表写入事件则不需要进行这些操作，且可以将多个不同的事件类型写入到一个异构流数据表。

在 Monitor 中，事件通常有四种流向：插入事件输入队列的队尾、插入输入处理队列的队首、继续进行模式匹配、以及插入事件输出队列等待输出。其中，继续进行模式匹配是在监听器的 handler 中定义的另一个监听器。若要添加监听器，请参考上一节内容。本节将主要介绍将事件插入事件输入队列队尾、插入事件输入队列的队首以及插入输出队列的方法。

语法

stopSubEngine()

详情

关闭执行此函数的 Monitor 实例所在的子引擎。在关闭子引擎前，将调用其内部所有 Monitor 实例中已声明的 onunload 方法。如果存在通过 spawn 产生的 Monitor 实例，将首先调用这些由 spawn 产生的 Monitor 实例中已声明的 onDestroy 方法。