Esper系列(八)Method Definition、Schema

Method Definition

作用：以公共静态方法的方式去访问外部数据。

 

应用说明：

1、返回数据的方法必须是公共静态方法(方法参数可以有多个也可以没有)；
2、如果返回一条数据或无返回数据，则方法的返回类型可以是Java类或者Map类型数据。如果返回多条数据（包括一条），则方法返回类型必须是Java类的数组或者Map数组；
3、如果方法的返回类型是Java类或者Java类数组，则Java的类定义必须包含针对属性的get方法。
4、如果方法的返回类型是Map或者Map数组，则Map的key-value定义固定为<String, Object>；
5、如果返回的数据是Map或者Map数组，除了定义返回数据的方法外，还要定义返回元数据的方法（这个元数据针对返回的数据）。方法是公共静态方法，且必须是无参数方法。方法返回类型为Map<String, Class>，String表示返回的数据的名称，Class表示返回的数据的类型。返回元数据的方法名称=返回数据的方法名称+Metadata。

 

例子：

文件名：MyEvent.java

1	public class MyEvent {
2	public static Map<String, Object> getMapEvent(){
3	Map<String, Object> map = new HashMap<String, Object>();
4	map.put("key", "chenx1");
5	map.put("value",1);
6	return map;
7	}
8
9	public static Map<String, Class> getMapEventMetadata(){
10	Map<String, Class> map = new HashMap<String, Class>();
11	map.put("key", String.class);
12	map.put("value", int.class);
13	return map;
14	}
15	}

文件名：orderMainTest.java

1	String epsql = "select * from method:MyEvent.getMapEvent() where value > 0";
2	EPStatement epstate = epAdmin.createEPL(epsql);
3	Iterator<EventBean> iter = epstate.iterator();
4	while (iter.hasNext()) {
5	EventBean bean = iter.next();
6	System.out.println(bean.getUnderlying());
7	}

Schema

格式：

1	create [map | objectarray] schema schema_name [as]
2	(property_name property_type [,property_name property_type [,...])
3	[inherits inherited_event_type[, inherited_event_type] [,...]]
4	[starttimestamp timestamp_property_name]
5	[endtimestamp timestamp_property_name]
6	[copyfrom copy_type_name [, copy_type_name] [,...]]

参数说明：

1. map、objectarray分别表示当前定义的schema是map结构还是数组结构。
2. schema_name表示schema的名字，全局唯一（as为可选内容）。
3. property_name表示schema所包含的属性名称，property_type为属性的类型，多个属性用逗号分隔，所有属性用圆括号括起来可以使用的类型有：int、String等已经内置的Java类型；已经通过Configuration接口注册的事件类型，比如Map，数组，schema等；可以使用POJO类，如果没有import就要写全名，否则写类名即可。
4. inherits表示继承别的事件类型，后面跟着的是要继承的事件类型。如果使用了继承，则当前定义的schema包含了继承的事件类型的所有属性。并且可以继承多个，用逗号分隔。
5. starttimestamp和endtimestamp是两个特殊的关键字。单独使用starttimestamp时，表示为schema记一个时间戳。后面跟着已经声明的属性并且能够返回一个data-time值。如果联合endtimestamp使用，则表示这个schema只能在某段事件内使用。后面跟着的同样也是已经声明的属性并且能够返回一个data-time值。注意endtimestamp不能单独使用。
6. copyfrom表示复制别的事件的所有属性到当前定义的schema中，并且可以copy多个事件，用逗号分隔。

示例：

1	// 创建schema
2	String inepl = "create schema myevent as orderEvent";
3	epAdmin.createEPL(inepl);
4	// 查询
5	EPStatement epstate = epAdmin.createEPL("select * from myevent");