org.mule.runtime.core.routing

Class EventGroup

java.lang.Object

org.mule.runtime.core.routing.EventGroup

All Implemented Interfaces:

Serializable, Comparable<EventGroup>, DeserializationPostInitialisable

public class EventGroup
extends Object
implements Comparable<EventGroup>, Serializable, DeserializationPostInitialisable

EventGroup is a holder over events grouped by a common group Id. This can be used by components such as routers to managed related events.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	EventGroup.ArrivalOrderEventComparator

Nested classes/interfaces inherited from interface org.mule.runtime.core.util.store.DeserializationPostInitialisable

DeserializationPostInitialisable.Implementation

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_STORE_PREFIX
static Event[]	EMPTY_EVENTS_ARRAY
static String	MULE_ARRIVAL_ORDER_PROPERTY

Constructor Summary

Constructors

Constructor and Description
EventGroup(Object groupId, MuleContext muleContext)
EventGroup(Object groupId, MuleContext muleContext, Optional<Integer> expectedSize, String storePrefix)

Method Summary

Modifier and Type	Method and Description
void	addEvent(Event event) Add the given event to this group.
void	clear() Removes all events from this group.
int	compareTo(EventGroup other) Compare this EventGroup to another one.
boolean	equals(Object obj) Compares two EventGroups for equality.
Optional<Integer>	expectedSize() Returns the number of events that this EventGroup is expecting before correlation can proceed.
long	getCreated() Return the creation timestamp of the current group in milliseconds.
Object	getGroupId() Returns an identifier for this EventGroup.
protected MuleSession	getMergedSession(Event[] events)
Event	getMessageCollectionEvent()
int	hashCode() The hashCode of an EventGroup is derived from the object returned by getGroupId().
void	initAfterDeserialisation(MuleContext context)
void	initEventsStore(PartitionableObjectStore<Event> events)
boolean	isInitialised()
Iterator<Event>	iterator() Returns an iterator over a snapshot copy of this group's collected events sorted by their arrival time.
Iterator<Event>	iterator(boolean sortByArrival) Returns an iterator over a snapshot copy of this group's collected events., optionally sorted by arrival order.
int	size() Returns the number of events collected so far.
Event[]	toArray() Returns a snapshot of collected events in this group sorted by their arrival time.
Event[]	toArray(boolean sortByArrival) Returns a snapshot of collected events in this group, optionally sorted by their arrival time.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

EMPTY_EVENTS_ARRAY

public static final Event[] EMPTY_EVENTS_ARRAY

MULE_ARRIVAL_ORDER_PROPERTY

public static final String MULE_ARRIVAL_ORDER_PROPERTY

See Also:

Constant Field Values

DEFAULT_STORE_PREFIX

public static final String DEFAULT_STORE_PREFIX

See Also:

Constant Field Values

Constructor Detail

EventGroup

public EventGroup(Object groupId,
                  MuleContext muleContext)

EventGroup

public EventGroup(Object groupId,
                  MuleContext muleContext,
                  Optional<Integer> expectedSize,
                  String storePrefix)

Method Detail

compareTo

public int compareTo(EventGroup other)

Compare this EventGroup to another one. If the receiver and the argument both have groupIds that are Comparable, they are used for the comparison; otherwise - since the id can be any object - the group creation time stamp is used as fallback. Older groups are considered "smaller".

Specified by:

compareTo in interface Comparable<EventGroup>

See Also:

Comparable.compareTo(java.lang.Object)

equals

public boolean equals(Object obj)

Compares two EventGroups for equality. EventGroups are considered equal if their groupIds (as returned by getGroupId()) are equal.

Overrides:

equals in class Object

See Also:

Object.equals(Object)

hashCode

public int hashCode()

The hashCode of an EventGroup is derived from the object returned by getGroupId().

Overrides:

hashCode in class Object

See Also:

Object.hashCode()

getGroupId

public Object getGroupId()

Returns an identifier for this EventGroup. It is recommended that this id is unique and Comparable e.g. a UUID.

Returns:

the id of this event group

iterator

public Iterator<Event> iterator()
                         throws org.mule.runtime.api.store.ObjectStoreException

Returns an iterator over a snapshot copy of this group's collected events sorted by their arrival time. If you need to iterate over the group and e.g. remove select events, do so via #removeEvent(Event). If you need to do so atomically in order to prevent e.g. concurrent reception/aggregation of the group during iteration, wrap the iteration in a synchronized block on the group instance.

Returns:

an iterator over collected Events.

Throws:

org.mule.runtime.api.store.ObjectStoreException

iterator

public Iterator<Event> iterator(boolean sortByArrival)
                         throws org.mule.runtime.api.store.ObjectStoreException

Returns an iterator over a snapshot copy of this group's collected events., optionally sorted by arrival order. If you need to iterate over the group and e.g. remove select events, do so via #removeEvent(Event). If you need to do so atomically in order to prevent e.g. concurrent reception/aggregation of the group during iteration, wrap the iteration in a synchronized block on the group instance.

Returns:

an iterator over collected Events.

Throws:

org.mule.runtime.api.store.ObjectStoreException

toArray

public Event[] toArray()
                throws org.mule.runtime.api.store.ObjectStoreException

Returns a snapshot of collected events in this group sorted by their arrival time.

Returns:

an array of collected Events.

Throws:

org.mule.runtime.api.store.ObjectStoreException

toArray

public Event[] toArray(boolean sortByArrival)
                throws org.mule.runtime.api.store.ObjectStoreException

Returns a snapshot of collected events in this group, optionally sorted by their arrival time.

Returns:

an array of collected Events.

Throws:

org.mule.runtime.api.store.ObjectStoreException

addEvent

public void addEvent(Event event)
              throws org.mule.runtime.api.store.ObjectStoreException

Add the given event to this group.

Parameters:

event - the event to add

Throws:

org.mule.runtime.api.store.ObjectStoreException

getCreated

public long getCreated()

Return the creation timestamp of the current group in milliseconds.

Returns:

the timestamp when this group was instantiated.

size

public int size()

Returns the number of events collected so far.

Returns:

number of events in this group or 0 if the group is empty.

expectedSize

public Optional<Integer> expectedSize()

Returns the number of events that this EventGroup is expecting before correlation can proceed.

Returns:

expected number of events or null if no expected size was specified.

clear

public void clear()
           throws org.mule.runtime.api.store.ObjectStoreException

Removes all events from this group.

Throws:

org.mule.runtime.api.store.ObjectStoreException

toString

public String toString()

Overrides:

toString in class Object

getMessageCollectionEvent

public Event getMessageCollectionEvent()

getMergedSession

protected MuleSession getMergedSession(Event[] events)
                                throws org.mule.runtime.api.store.ObjectStoreException

Throws:

org.mule.runtime.api.store.ObjectStoreException

initAfterDeserialisation

public void initAfterDeserialisation(MuleContext context)
                              throws org.mule.runtime.api.exception.MuleException

Throws:

org.mule.runtime.api.exception.MuleException

initEventsStore

public void initEventsStore(PartitionableObjectStore<Event> events)
                     throws org.mule.runtime.api.store.ObjectStoreException

Throws:

org.mule.runtime.api.store.ObjectStoreException

isInitialised

public boolean isInitialised()