Package com.google.web.bindery.event.shared

Class SimpleEventBus

java.lang.Object
com.google.web.bindery.event.shared.EventBus
com.google.web.bindery.event.shared.SimpleEventBus
public class SimpleEventBus extends EventBus
Basic implementation of EventBus.

  • Constructor Details

    • SimpleEventBus

      public SimpleEventBus()

    • SimpleEventBus

      @Deprecated protected SimpleEventBus(boolean fireInReverseOrder)
      Deprecated.
      This is a legacy feature, required by GWT's old HandlerManager. Reverse order is not honored for handlers tied to a specific event source (via addHandlerToSource(com.google.web.bindery.event.shared.Event.Type<H>, java.lang.Object, H).
      Allows creation of an instance that fires its handlers in the reverse of the order in which they were added, although filtered handlers all fire before unfiltered handlers.

  • Method Details

    • addHandler

      public <H> HandlerRegistration addHandler(Event.Type<H> type, H handler)
      Description copied from class: EventBus
      Adds an unfiltered handler to receive events of this type from all sources.

      It is rare to call this method directly. More typically an Event subclass will provide a static register method, or a widget will accept handlers directly.

      Specified by:
      addHandler in class EventBus
      Type Parameters:
      H - The type of handler
      Parameters:
      type - the event type associated with this handler
      handler - the handler
      Returns:
      the handler registration, can be stored in order to remove the handler later

    • addHandlerToSource

      public <H> HandlerRegistration addHandlerToSource(Event.Type<H> type, Object source, H handler)
      Description copied from class: EventBus
      Adds a handler to receive events of this type from the given source.

      It is rare to call this method directly. More typically a Event subclass will provide a static register method, or a widget will accept handlers directly.

      Specified by:
      addHandlerToSource in class EventBus
      Type Parameters:
      H - The type of handler
      Parameters:
      type - the event type associated with this handler
      source - the source associated with this handler
      handler - the handler
      Returns:
      the handler registration, can be stored in order to remove the handler later

    • fireEvent

      public void fireEvent(Event<?> event)
      Description copied from class: EventBus
      Fires the event from no source. Only unfiltered handlers will receive it.

      Any exceptions thrown by handlers will be bundled into a UmbrellaException and then re-thrown after all handlers have completed. An exception thrown by a handler will not prevent other handlers from executing.

      Specified by:
      fireEvent in class EventBus
      Parameters:
      event - the event to fire

    • fireEventFromSource

      public void fireEventFromSource(Event<?> event, Object source)
      Description copied from class: EventBus
      Fires the given event to the handlers listening to the event's type.

      Any exceptions thrown by handlers will be bundled into a UmbrellaException and then re-thrown after all handlers have completed. An exception thrown by a handler will not prevent other handlers from executing.

      Specified by:
      fireEventFromSource in class EventBus
      Parameters:
      event - the event to fire

    • doRemove

      @Deprecated protected <H> void doRemove(Event.Type<H> type, Object source, H handler)
      Deprecated.
      required by legacy features in GWT's old HandlerManager

    • getHandler

      @Deprecated protected <H> H getHandler(Event.Type<H> type, int index)
      Deprecated.
      required by legacy features in GWT's old HandlerManager

    • getHandlerCount

      @Deprecated protected int getHandlerCount(Event.Type<?> eventKey)
      Deprecated.
      required by legacy features in GWT's old HandlerManager

    • isEventHandled

      @Deprecated protected boolean isEventHandled(Event.Type<?> eventKey)
      Deprecated.
      required by legacy features in GWT's old HandlerManager