com.espertech.esper.client
Interface EventSender

All Known Implementing Classes:

EventSenderBean, EventSenderImpl, EventSenderMap, EventSenderObjectArray, EventSenderXMLDOM

public interface EventSender

Returns a facility to process event objects that are of a known type.

Obtained via the method EPRuntime.getEventSender(String) the sender is specific to a given event type and may not process event objects of any other event type; See the method documentatiom for more details.

Obtained via the method EPRuntime.getEventSender(java.net.URI[]) the sender cooperates with plug-in event representations to reflect upon the event object to determine an appropriate event type to process the event.

Method Summary

void	route(java.lang.Object theEvent) Route the event object back to the event stream processing runtime for internal dispatching, to avoid the possibility of a stack overflow due to nested calls to sendEvent.
void	sendEvent(java.lang.Object theEvent) Processes the event object.

Method Detail

sendEvent

void sendEvent(java.lang.Object theEvent)
               throws EPException

Processes the event object.

Use the route method for sending events into the runtime from within UpdateListener code. to avoid the possibility of a stack overflow due to nested calls to sendEvent.

Parameters:

theEvent - to process

Throws:

EPException - if a runtime error occured.

route

void route(java.lang.Object theEvent)
           throws EPException

Route the event object back to the event stream processing runtime for internal dispatching, to avoid the possibility of a stack overflow due to nested calls to sendEvent. The route event is processed just like it was sent to the runtime, that is any active expressions seeking that event receive it. The routed event has priority over other events sent to the runtime. In a single-threaded application the routed event is processed before the next event is sent to the runtime through the EPRuntime.sendEvent method.

Parameters:

theEvent - to process

Throws:

EPException - is thrown when the processing of the event lead to an error