com.espertech.esper.epl.join.table

Class PropertySortedEventTable

java.lang.Object

com.espertech.esper.epl.join.table.PropertySortedEventTable

All Implemented Interfaces:

EventTable, Iterable<EventBean>

Direct Known Subclasses:

PropertySortedEventTableImpl

public abstract class PropertySortedEventTable
extends Object
implements EventTable

Index that organizes events by the event property values into a single TreeMap sortable non-nested index with Object keys that store the property values.

Field Summary

Fields

Modifier and Type	Field and Description
protected EventTableOrganization	organization
protected EventPropertyGetter	propertyGetter

Constructor Summary

Constructors

Constructor and Description
PropertySortedEventTable(EventPropertyGetter propertyGetter, EventTableOrganization organization)

Method Summary

Modifier and Type	Method and Description
void	add(EventBean[] events, ExprEvaluatorContext exprEvaluatorContext) Add an array of events.
void	addRemove(EventBean[] newData, EventBean[] oldData, ExprEvaluatorContext exprEvaluatorContext) Add and remove events from table.
protected Object	getIndexedValue(EventBean theEvent) Determine multikey for index access.
Integer	getNumberOfEvents() If the number of events is readily available, an implementation will return that number or it may return null to indicate that the count is not readily available.
EventTableOrganization	getOrganization()
abstract Set<EventBean>	lookupConstants(RangeIndexLookupValue lookupValueBase)
abstract Set<EventBean>	lookupGreater(Object keyStart)
abstract Collection<EventBean>	lookupGreaterColl(Object keyStart)
abstract Set<EventBean>	lookupGreaterEqual(Object keyStart)
abstract Collection<EventBean>	lookupGreaterEqualColl(Object keyStart)
abstract Set<EventBean>	lookupLess(Object keyStart)
abstract Set<EventBean>	lookupLessEqual(Object keyStart)
abstract Collection<EventBean>	lookupLessEqualColl(Object keyStart)
abstract Collection<EventBean>	lookupLessThenColl(Object keyStart)
abstract Set<EventBean>	lookupRange(Object keyStart, boolean includeStart, Object keyEnd, boolean includeEnd, boolean allowRangeReversal)
abstract Collection<EventBean>	lookupRangeColl(Object keyStart, boolean includeStart, Object keyEnd, boolean includeEnd, boolean allowRangeReversal)
abstract Set<EventBean>	lookupRangeInverted(Object keyStart, boolean includeStart, Object keyEnd, boolean includeEnd)
abstract Collection<EventBean>	lookupRangeInvertedColl(Object keyStart, boolean includeStart, Object keyEnd, boolean includeEnd)
protected static Set<EventBean>	normalize(SortedMap<Object,Set<EventBean>> submap)
protected static Set<EventBean>	normalize(SortedMap<Object,Set<EventBean>> submapOne, SortedMap<Object,Set<EventBean>> submapTwo)
protected static Collection<EventBean>	normalizeCollection(SortedMap<Object,Set<EventBean>> submap)
protected static Collection<EventBean>	normalizeCollection(SortedMap<Object,Set<EventBean>> submapOne, SortedMap<Object,Set<EventBean>> submapTwo)
void	remove(EventBean[] events, ExprEvaluatorContext exprEvaluatorContext) Remove events.
String	toQueryPlan()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.espertech.esper.epl.join.table.EventTable

add, clear, destroy, getIndex, getNumKeys, getProviderClass, isEmpty, iterator, remove

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Detail

propertyGetter

protected final EventPropertyGetter propertyGetter

organization

protected final EventTableOrganization organization

Constructor Detail

PropertySortedEventTable

public PropertySortedEventTable(EventPropertyGetter propertyGetter,
                                EventTableOrganization organization)

Method Detail

lookupRange

public abstract Set<EventBean> lookupRange(Object keyStart,
                                           boolean includeStart,
                                           Object keyEnd,
                                           boolean includeEnd,
                                           boolean allowRangeReversal)

lookupRangeColl

public abstract Collection<EventBean> lookupRangeColl(Object keyStart,
                                                      boolean includeStart,
                                                      Object keyEnd,
                                                      boolean includeEnd,
                                                      boolean allowRangeReversal)

lookupRangeInverted

public abstract Set<EventBean> lookupRangeInverted(Object keyStart,
                                                   boolean includeStart,
                                                   Object keyEnd,
                                                   boolean includeEnd)

lookupRangeInvertedColl

public abstract Collection<EventBean> lookupRangeInvertedColl(Object keyStart,
                                                              boolean includeStart,
                                                              Object keyEnd,
                                                              boolean includeEnd)

lookupLess

public abstract Set<EventBean> lookupLess(Object keyStart)

lookupLessThenColl

public abstract Collection<EventBean> lookupLessThenColl(Object keyStart)

lookupLessEqual

public abstract Set<EventBean> lookupLessEqual(Object keyStart)

lookupLessEqualColl

public abstract Collection<EventBean> lookupLessEqualColl(Object keyStart)

lookupGreaterEqual

public abstract Set<EventBean> lookupGreaterEqual(Object keyStart)

lookupGreaterEqualColl

public abstract Collection<EventBean> lookupGreaterEqualColl(Object keyStart)

lookupGreater

public abstract Set<EventBean> lookupGreater(Object keyStart)

lookupGreaterColl

public abstract Collection<EventBean> lookupGreaterColl(Object keyStart)

lookupConstants

public abstract Set<EventBean> lookupConstants(RangeIndexLookupValue lookupValueBase)

getIndexedValue

protected Object getIndexedValue(EventBean theEvent)

Determine multikey for index access.

Parameters:

theEvent - to get properties from for key

Returns:

multi key

addRemove

public void addRemove(EventBean[] newData,
                      EventBean[] oldData,
                      ExprEvaluatorContext exprEvaluatorContext)

Description copied from interface: EventTable

Add and remove events from table.

It is up to the index to decide whether to add first and then remove, or whether to remove and then add.

It is important to note that a given event can be in both the removed and the added events. This means that unique indexes probably need to remove first and then add. Most other non-unique indexes will add first and then remove since the an event can be both in the add and the remove stream.

Specified by:

addRemove in interface EventTable

Parameters:

newData - to add

oldData - to remove

exprEvaluatorContext - evaluator context

add

public void add(EventBean[] events,
                ExprEvaluatorContext exprEvaluatorContext)

Add an array of events. Same event instance is not added twice. Event properties should be immutable. Allow null passed instead of an empty array.

Specified by:

add in interface EventTable

Parameters:

events - to add

exprEvaluatorContext - evaluator context

Throws:

IllegalArgumentException - if the event was already existed in the index

remove

public void remove(EventBean[] events,
                   ExprEvaluatorContext exprEvaluatorContext)

Remove events.

Specified by:

remove in interface EventTable

Parameters:

events - to be removed, can be null instead of an empty array.

exprEvaluatorContext - evaluator context

Throws:

IllegalArgumentException - when the event could not be removed as its not in the index

getNumberOfEvents

public Integer getNumberOfEvents()

Description copied from interface: EventTable

If the number of events is readily available, an implementation will return that number or it may return null to indicate that the count is not readily available.

Specified by:

getNumberOfEvents in interface EventTable

Returns:

number of events

normalize

protected static Set<EventBean> normalize(SortedMap<Object,Set<EventBean>> submap)

normalizeCollection

protected static Collection<EventBean> normalizeCollection(SortedMap<Object,Set<EventBean>> submap)

normalizeCollection

protected static Collection<EventBean> normalizeCollection(SortedMap<Object,Set<EventBean>> submapOne,
                                                           SortedMap<Object,Set<EventBean>> submapTwo)

normalize

protected static Set<EventBean> normalize(SortedMap<Object,Set<EventBean>> submapOne,
                                          SortedMap<Object,Set<EventBean>> submapTwo)

toQueryPlan

public String toQueryPlan()

Specified by:

toQueryPlan in interface EventTable

getOrganization

public EventTableOrganization getOrganization()

Specified by:

getOrganization in interface EventTable