Esper支持原生Java Map结构的事件。相对于POJO来说,Map的结构更利于事件类型的热加载,毕竟不是class,所以不需要重启JVM。所以如果系统对重启比较敏感, 建议使用Map来定义事件的结构。Map的结构很简单,主要分为事件定义名和事件属性列表。我们继续拿Person来讲解.
Java代码
- import java.util.HashMap;
- import java.util.List;
- import java.util.Map;
- import com.espertech.esper.client.EPAdministrator;
- import com.espertech.esper.client.EPServiceProvider;
- import com.espertech.esper.client.EPServiceProviderManager;
- public class PersonMap
- {
- public static void main(String[] args)
- {
- EPServiceProvider epService = EPServiceProviderManager.getDefaultProvider();
- EPAdministrator admin = epService.getEPAdministrator();
- // Person定义
- Map<String,Object> person = new HashMap<String,Object>();
- person.put("name", String.class);
- person.put("age", int.class);
- person.put("children", List.class);
- person.put("phones", Map.class);
- // 注册Person到Esper
- admin.getConfiguration().addEventType("Person", person);
- }
- }
如上所示,Map结构的事件需要将属性名作为key,属性的数据类型作为value保存到Map中,然后再通过Esper的接口注册到Esper。其中addEventType的两个参数分别代表事件定义的名称和所定义的结构。
对应的EPL和POJO的没有区别
- // 当Person类型的事件中name为luonanqin时,Esper能得到对应的age,children
- select age,children from Person where name="Jordan"
Map对于嵌套类的定义比较特别。如果嵌套的类是POJO,那就如上面所示。如果嵌套的还是Map,那么定义方式就需要改变。我们为Person加上Address,示例如下:
Java代码
- import java.util.HashMap;
- import java.util.List;
- import java.util.Map;
- import com.espertech.esper.client.EPAdministrator;
- import com.espertech.esper.client.EPServiceProvider;
- import com.espertech.esper.client.EPServiceProviderManager;
- public class PersonMap
- {
- public static void main(String[] args)
- {
- EPServiceProvider epService = EPServiceProviderManager.getDefaultProvider();
- EPAdministrator admin = epService.getEPAdministrator();
- // Address定义
- Map<String, Object> address = new HashMap<String, Object>();
- address.put("road", String.class);
- address.put("street", String.class);
- address.put("houseNo", int.class);
- // Person定义
- Map<String, Object> person = new HashMap<String, Object>();
- person.put("name", String.class);
- person.put("age", int.class);
- person.put("children", List.class);
- person.put("phones", Map.class);
- person.put("address", "Address");
- // 注册Address到Esper
- admin.getConfiguration().addEventType("Address", address);
- // 注册Person到Esper
- admin.getConfiguration().addEventType("Person", person);
- }
- }
Java代码
如上所示,有两个关键点:
1.Person在定义Address属性时,map的value不是Address.class,而是Address字符串,而这就代表引擎里的Address对应的Map结构定义
2.事件定义注册必须是Address先于Person,因为Person用到了Address,而引擎是根据Address注册时用的名字去查找Address定义的,所以如果名字写错,引擎就找不到Address了 。
另外对于Map,Esper只支持增量更新,也就是说只能增加Map中的属性定义,而不能修改或者删除某个属性(实际上属性增多并不影响其处理性能,所以 没有删除在我看来也没什么。至于修改,也只能是先注销再注册了)。我们为Person增加一个gender属性,示例如下:
Java代码
- import java.util.Arrays;
- import java.util.HashMap;
- import java.util.List;
- import java.util.Map;
- import com.espertech.esper.client.EPAdministrator;
- import com.espertech.esper.client.EPServiceProvider;
- import com.espertech.esper.client.EPServiceProviderManager;
- import com.espertech.esper.client.EventType;
- public class PersonMap
- {
- public static void main(String[] args)
- {
- EPServiceProvider epService = EPServiceProviderManager.getDefaultProvider();
- EPAdministrator admin = epService.getEPAdministrator();
- // Address定义
- Map<String, Object> address = new HashMap<String, Object>();
- address.put("road", String.class);
- address.put("street", String.class);
- address.put("houseNo", int.class);
- // Person定义
- Map<String, Object> person = new HashMap<String, Object>();
- person.put("name", String.class);
- person.put("age", int.class);
- person.put("children", List.class);
- person.put("phones", Map.class);
- person.put("address", "Address");
- // 注册Address到Esper
- admin.getConfiguration().addEventType("Address", address);
- // 注册Person到Esper
- admin.getConfiguration().addEventType("Person", person);
- // 新增一个gender属性
- person.put("gender", int.class);
- admin.getConfiguration().updateMapEventType("Person", person);
- /** 输出结果:
- * Person props: [address, age, name, children, phones, gender]
- */
- EventType event = admin.getConfiguration().getEventType("Person");
- System.out.println("Person props: " + Arrays.asList(event.getPropertyNames()));
- }
- }
3.Object Array
对象数组和Map很像,基本没有差别。只是定义方式不一样,Esper同样也只支持增量更新。这里继续用Person作为例子:
Java代码
- import java.util.Arrays;
- import java.util.Map;
- import com.espertech.esper.client.EPAdministrator;
- import com.espertech.esper.client.EPServiceProvider;
- import com.espertech.esper.client.EPServiceProviderManager;
- import com.espertech.esper.client.EventType;
- public class PersonArray
- {
- /**
- * @param args
- */
- public static void main(String[] args)
- {
- EPServiceProvider epService = EPServiceProviderManager.getDefaultProvider();
- EPAdministrator admin = epService.getEPAdministrator();
- // Address定义
- String[] addressPropNames = { "road", "street", "houseNo" };
- Object[] addressPropTypes = { String.class, String.class, int.class };
- // Child定义
- String[] childPropNames = { "name", "age" };
- Object[] childPropTypes = { String.class, int.class };
- // Person定义
- String[] personPropNames = { "name", "age", "children", "phones", "address" };
- Object[] personPropTypes = { String.class, int.class, "Child[]", Map.class, "Address" };
- // 注册Address到Esper
- admin.getConfiguration().addEventType("Address", addressPropNames, addressPropTypes);
- // 注册Child到Esper
- admin.getConfiguration().addEventType("Child", childPropNames, childPropTypes);
- // 注册Person到Esper
- admin.getConfiguration().addEventType("Person", personPropNames, personPropTypes);
- // 新增一个gender属性
- admin.getConfiguration().updateObjectArrayEventType("Person", new String[] { "gender" }, new Object[] { int.class });
- /** 输出结果:
- * Person props: [name, age, children, phones, address, gender]
- */
- EventType event = admin.getConfiguration().getEventType("Person");
- System.out.println("Person props: " + Arrays.asList(event.getPropertyNames()));
- }
- }
上面的例子包含了对象数组这种事件格式的所有特性。