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