The EventBus allows publish-subscribe-style communication between components without requiring the components to explicitly register with one another (and thus be aware of each other). It is designed exclusively to replace traditional Java in-process event distribution using explicit registration. It is not a general-purpose publish-subscribe system, nor is it intended for interprocess communication.
post(Object)method. The EventBus instance will determine the type of event and route it to all registered listeners.
Events are routed based on their type — an event will be delivered to any handler for any type to which the event is assignable. This includes implemented interfaces, all superclasses, and all interfaces implemented by superclasses.
post is called, all registered handlers for an event are run
in sequence, so handlers should be reasonably quick. If an event may trigger
an extended process (such as a database load), spawn a thread or queue it for
later. (For a convenient way to do this, use an
Handlers should not, in general, throw. If they do, the EventBus will catch and log the exception. This is rarely the right solution for error handling and should not be relied upon; it is intended solely to help find problems during development.
The EventBus guarantees that it will not call a handler method from
multiple threads simultaneously, unless the method explicitly allows it by
AllowConcurrentEvents annotation. If this annotation is
not present, handler methods need not worry about being reentrant, unless
also called from outside the EventBus.
If a handler for a supertype of all events (such as Object) is registered,
no event will ever be considered dead, and no DeadEvents will be generated.
Accordingly, while DeadEvent extends
Object, a handler registered to
receive any Object will never receive a DeadEvent.
This class is safe for concurrent use.
See the Guava User Guide article on
|Constructor and Description|
Creates a new EventBus named "default".
Creates a new EventBus with the given
|Modifier and Type||Method and Description|
Posts an event to all registered handlers.
Registers all handler methods on
Unregisters all handler methods on a registered
objectto receive events. Handler methods are selected and classified using this EventBus's
HandlerFindingStrategy; the default strategy is the
object- object whose handler methods should be registered.
public void unregister(Object object)
object- object whose handler methods should be unregistered.
IllegalArgumentException- if the object was not previously registered.
If no handlers have been subscribed for
event's class, and
event is not already a
DeadEvent, it will be wrapped in a
DeadEvent and reposted.
event- event to post.
Copyright © 2010-2013. All Rights Reserved.