Package gaiasky.event

Class EventManager

java.lang.Object
gaiasky.event.EventManager
All Implemented Interfaces:
IObserver
public class EventManager extends Object implements IObserver
Event manager that allows for subscription of observers to events (identified by strings), and also for the creation of event objects by anyone.

  • Field Details

    • instance

      public static final EventManager instance
      Singleton pattern

  • Constructor Details

    • EventManager

      public EventManager()

  • Method Details

    • subscribe

      public void subscribe​(IObserver observer, Events... events)
      Subscribes the given observer to the given event types.
      Parameters:
      observer - The observer to subscribe.
      events - The event types to subscribe to.

    • subscribe

      public void subscribe​(IObserver listener, Events msg)
      Registers a listener for the specified message code. Messages without an explicit receiver are broadcasted to all its registered listeners.
      Parameters:
      msg - the message code
      listener - the listener to add

    • unsubscribe

      public void unsubscribe​(IObserver listener, Events... events)

    • unsubscribe

      public void unsubscribe​(IObserver listener, Events events)
      Unregister the specified listener for the specified message code.
      Parameters:
      events - The message code.
      listener - The listener to remove.

    • removeAllSubscriptions

      public void removeAllSubscriptions​(IObserver... listeners)
      Unregisters all the subscriptions of the given listeners.
      Parameters:
      listeners - The listeners to remove.

    • clearSubscriptions

      public void clearSubscriptions​(Events msg)
      Unregisters all the listeners for the specified message code.
      Parameters:
      msg - the message code

    • clearAllSubscriptions

      public void clearAllSubscriptions()

    • post

      public void post​(Events event, Object... data)
      Posts or registers a new event type with the given data.
      Parameters:
      event - The event type.
      data - The event data.

    • postDelayed

      public void postDelayed​(Events event, long delayMs, Object... data)
      Posts or registers a new event type with the given data and the default time frame. The default time frame can be changed using the event Events.EVENT_TIME_FRAME_CMD. The event will be passed along after the specified delay time [ms] in the given time frame has passed.
      Parameters:
      event - The event type.
      delayMs - Milliseconds of delay in the given time frame.
      data - The event data.

    • postDelayed

      public void postDelayed​(Events event, long delayMs, EventManager.TimeFrame frame, Object... data)
      Posts or registers a new event type with the given data. The event will be passed along after the specified delay time [ms] in the given time frame has passed.
      Parameters:
      event - The event type.
      delayMs - Milliseconds of delay in the given time frame.
      frame - The time frame, either real time (user) or simulation time (simulation clock time).
      data - The event data.

    • getCurrentTime

      public static long getCurrentTime()
      Returns the current time in milliseconds.

    • dispatchDelayedMessages

      public void dispatchDelayedMessages()
      Dispatches any telegrams with a timestamp that has expired. Any dispatched telegrams are removed from the queue.

      This method must be called each time through the main loop.

    • hasSubscriptors

      public boolean hasSubscriptors​(Events event)

    • isSubscribedToAny

      public boolean isSubscribedToAny​(IObserver o)

    • isSubscribedTo

      public boolean isSubscribedTo​(IObserver o, Events event)

    • notify

      public void notify​(Events event, Object... data)
      Specified by:
      notify in interface IObserver