A Guice enabled implementation of the mbassador high performance event bus for use with an implementation-independent API

There are two singleton instances available, one which expects messages (that is, implementations of BusMessage), and the other which accepts Object

The publish element is implementation independent, and subscribe can be independent. Handler implementations, however, but still require MBassador specific annotations

Available from JCenter only

Gradle

compile 'uk.q3c.krail:eventbus:x.x.x.x'

Maven

<dependency>
  <groupId>uk.q3c.krail</groupId>
  <artifactId>eventbus</artifactId>
  <version>x.x.x.x</version>
  <type>pom</type>
</dependency>

Include EventBusModule as part of your Guice injector creation. Inject the providers where you need them (usually only to publish messages):

• MessageBusProvider, or
• EventBusProvider

and call provider.get()

A class must be annotated with MBassador's @Listener annotation to receive events. Without any further annotation, this will subscribe the class to the MessageBus The class can also annotated with @SubscribeTo, which enables explicit subscription to either MessageBus, EventBus or both

@Listener
@SubscribeTo({GlobalMessageBus.class, GlobalEventBus.class})
public class WigglyThing {
}

For a full description of the use of handlers, and the many other features available, see the MBassador documentation