Robotics Service Bus

h1. Guarantees

h2. Quality of Service

For listeners, any guarantee applies to the stream of events received from the bus (not to the entire processing of a given event). In particular, it is possibly that the effective guarantees are weaker than those specified for the listener (if the informer has weaker guarantees than the listener).

For informer, any guarantee applies to the submitting of events to the bus. Guarantees at the receiving end may effectively be weakened depending on the listener configuration.

_In the following lists of guarantees, subsequent items include all guarantees given by preceding items._

h3. Ordering

# Unordered: Events are delivered in (potentially) arbitrary order.

# Ordered: Every listener receives the events of one informer in the order the informer sent the events. No guarantees are given for events of multiple informers.

Independent of the requested ordering, no relation is guaranteed for events arriving at multiple listeners.

h3. Reliability

# Unreliable: Events may be dropped and not be visible to a listener.

# Reliable: Messages are guaranteed to be delivered. Otherwise an error is raised.

h2. Threading

* Informer is thread-safe

* Listener is thread-safe. This implies:

** Adding/Removing filters from arbitrary threads does 

** Add/Remove handlers