com.google.gwt.event.shared
Class EventBus

java.lang.Object
  com.google.web.bindery.event.shared.EventBus
      com.google.gwt.event.shared.EventBus

All Implemented Interfaces:

HasHandlers

Direct Known Subclasses:

CountingEventBus, ResettableEventBus, SimpleEventBus

public abstract class EventBus
extends EventBus
implements HasHandlers

Extends {com.google.web.bindery.event.shared.EventBus} for legacy compatibility.

EventBus

public EventBus()

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

addHandler

public abstract <H extends EventHandler> HandlerRegistration addHandler(GwtEvent.Type<H> type,
                                                                        H handler)

addHandlerToSource

public <H> HandlerRegistration addHandlerToSource(Event.Type<H> type,
                                                  java.lang.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

addHandlerToSource

public abstract <H extends EventHandler> HandlerRegistration addHandlerToSource(GwtEvent.Type<H> type,
                                                                                java.lang.Object source,
                                                                                H handler)

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

fireEvent

public abstract void fireEvent(GwtEvent<?> event)

Description copied from interface: HasHandlers

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:

fireEvent in interface HasHandlers

Parameters:

event - the event

fireEventFromSource

public void fireEventFromSource(Event<?> event,
                                java.lang.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

fireEventFromSource

public abstract void fireEventFromSource(GwtEvent<?> event,
                                         java.lang.Object source)

castFireEvent

protected void castFireEvent(GwtEvent<?> event)

castFireEventFromSource

protected void castFireEventFromSource(GwtEvent<?> event,
                                       java.lang.Object source)

wrap

protected HandlerRegistration wrap(HandlerRegistration reg)