程序员的量化交易之路（5）--Esper之Map事件（4）

2.6 java.util.Map事件

2.6.1 概述

实现事件的类可以是一个实现java.util.Map接口的类。映射事件的事件属性是其通过get方法能够获得的值。

 

和数组对象事件类型一样，映射事件类型考虑了系统中的综合类型，是的不需要使用Java类来描述事件类型，这是的更容易在运行时更改事件，或者从其他类型生成类型信息。

 

一个给定的Map事件类型可以有一个或者多个超类型，这些超类型也必须是map 事件类型。所以在超类中可以获取的属性在该映射事件中也可以获得。此外，在EPL中任何一个Map超类被使用，那么其子类都可以匹配该表达式。

 

应用可以通过configurationoperation（配置操作）updateMapEventType在运行时为一个已经存在的映射事件类型添加属性。属性只能增加，不能更新或者删除。运行时配置允许删除一个映射事件类型并修改后再添加回系统中。

 

通过数组可以在映射事件类型中表示一对多的关系。映射事件类型中的一个属性可以是一个内置类型的数组，java对象的数组，Map的数组以及数组的数组，都是可以的。

 

引擎通过EPRuntime接口中的sendEvent（Map map,String eventTypeName）方法处理java.util.Map事件。映射中的条目代表这属性。关键字必须是java.util.String类型，为了使引擎能够通过匹配名字取查找事件属性。

 

引擎并不验证映射事件属性名和值。应用必须保证事件属性匹配create schema属性名和类型。

2.6.2 映射属性

映射事件属性可以是任意类型。它可以是Java应用对象、java.util.Map类型、Object[]数组类型等。这些复杂的类型可以提供一下更强的功能：

1）  使用java application object的属性可以嵌套、索引、映射以及使用动态属性等。

2）  使用Map作为事件属性可以表达更为复杂的事件，并且该属性可以被嵌套、索引、动态属性等。

3）  使用数组对象作为事件属性也是如此。。。。

为了使用映射事件类型，事件类型名称和属性名以及属性类型等必须让引擎知道，可以通过Configuration或者create schema EPL语法实现。具体例子参见5.15节“Declaring anEventType:Create Schema”和第16.4.2节“Eventsrepresed by java.util.Map”

下面的代码定义了一个映射事件类型，穿件一个映射事件并将该事件发送到引擎中。示例中通过运行时配置接口（create schema 和静态配置也可以）。

 

// Define CarLocUpdateEvent event type(example for runtime-configuration interface)

Map<String, Object> def = newHashMap<String, Object>;

def.put("carId", String.class);

def.put("direction", int.class);

 

epService.getEPAdministrator().getConfiguration().

 addEventType("CarLocUpdateEvent", def);

 

CarLocUpdateEvent事件类型可以在如下语句中使用：

 

select carId fromCarLocUpdateEvent.win:time(1 min) where direction = 1

 

创建一个CarLocUpdateEvent事件并将它发送到引擎中：

 

// Create a CarLocUpdateEvent event andsend it into the engine for processing

Map<String, Object> event = newHashMap<String, Object>();

event.put("carId", carId);

event.put("direction",direction);

 

epRuntime.sendEvent(event,"CarLocUpdateEvent");

 

通过嵌套属性，引擎允许把一个对象当做映射事件中的属性值来查询。这样Map就可以用来聚合多个数据结构到单个事件中。下面是这样的一个例子。

 

Map event = new HashMap();

event.put("txn", txn);

event.put("account", account);

epRuntime.sendEvent(event,"TxnEvent");

 

一个示例语句可以如下：

 

select account.id, account.rate *txn.amount

from TxnEvent.win:time(60 sec)

group by account.id

 

2.6.3 映射超类（Map Supertypes）

你的映射事件类型可以声明一个或者多个超类。

映射事件的超类也必须是映射事件类型。超类的所有属性名和类型在子类中都可以获取，并且是同名覆盖。此外，在EPL中使用超类的地方，子类的对象也可以匹配该表达式。

 

下面AccountUpdate有一个BaseUpdate超类。

epService.getEPAdministrator().getConfiguration().

   addEventType("AccountUpdate", accountUpdateDef,

   new String[] {"BaseUpdate"});

下面是EPL语句，子类对象都可以匹配：

 

// Receive BaseUpdate and any subtypesincluding subtypes of subtypes

select * from BaseUpdate

 

2.6.4 映射属性类型的高级用法

2.6.4.1 嵌套属性

 

下面通过一个示例说明映射事件的嵌套属性。

 

事件类型的定义：

 

Map<String, Object> updatedFieldDef =new HashMap<String, Object>();

updatedFieldDef.put("name",String.class);

updatedFieldDef.put("addressLine1",String.class);

updatedFieldDef.put("history",UpdateHistory.class);

epService.getEPAdministrator().getConfiguration().

   addEventType("UpdatedFieldType", updatedFieldDef);

 

Map<String, Object> accountUpdateDef= new HashMap<String, Object>();

accountUpdateDef.put("accountId",long.class);

accountUpdateDef.put("fields","UpdatedFieldType");

// the latter can also be:  accountUpdateDef.put("fields",updatedFieldDef);

 

epService.getEPAdministrator().getConfiguration().

addEventType("AccountUpdate",accountUpdateDef);

 

 

定义和发送事件：

 

Map<String, Object> updatedField =new HashMap<String, Object>();

updatedField.put("name","Joe Doe");

updatedField.put("addressLine1","40 Popular Street");

updatedField.put("history", newUpdateHistory());

 

Map<String, Object> accountUpdate =new HashMap<String, Object>();

accountUpdate.put("accountId",10009901);

accountUpdate.put("fields",updatedField);

 

epService.getEPRuntime().sendEvent(accountUpdate,"AccountUpdate");

 

 

最后查询事件：

 

select accountId, fields.name, fields.addressLine1,fields.history.lastUpdate

from AccountUpdate

 

2.6.4.2 一对多模型

使用数组作为属性。

 

Map<String, Object> sale = newHashMap<String, Object>();

sale.put("userids", int[].class);

sale.put("salesPersons",SalesPerson[].class);

sale.put("items","OrderItem[]");  // Theproperty type is the name itself appended by []

 

epService.getEPAdministrator().getConfiguration().

   addEventType("SaleEvent", sale);

 

select userids[0], salesPersons[1].name,

   items[1], items[1].price.amount from SaleEvent