Class DeadEvent


  • @Beta
    public class DeadEvent
    extends Object
    Wraps an event that was posted, but which had no subscribers and thus could not be delivered.

    Subscribing a DeadEvent handler is useful for debugging or logging, as it can detect misconfigurations in a system's event distribution.

    Since:
    10.0
    • Constructor Detail

      • DeadEvent

        public DeadEvent​(Object source,
                         Object event)
        Creates a new DeadEvent.
        Parameters:
        source - object broadcasting the DeadEvent (generally the EventBus).
        event - the event that could not be delivered.
    • Method Detail

      • getSource

        public Object getSource()
        Returns the object that originated this event (not the object that originated the wrapped event). This is generally an EventBus.
        Returns:
        the source of this event.
      • getEvent

        public Object getEvent()
        Returns the wrapped, 'dead' event, which the system was unable to deliver to any registered handler.
        Returns:
        the 'dead' event that could not be delivered.