1 // File: Events_Loop.hxx
2 // Created: Thu Mar 13 2014
3 // Author: Mikhail PONIKAROV
8 #include <Events_Message.h>
9 #include <Events_Listener.h>
14 class Events_MessageGroup;
18 * \brief Base class that manages the receiving and sending of all
19 * not Qt-events in the application.
21 * One per application, initialized on start. Listeners must register in this loop
22 * to get events, called by senders. Sending of events is very fast (just adding to container).
23 * Performing of events is processed in separated thread, so, sender takes
24 * control back immideately.
27 /// map from event ID to sender pointer to listeners that must be called for this
28 std::map<char*, std::map<void*, std::list<Events_Listener*> > >
31 /// map from event ID to groupped messages (accumulated on flush)
32 std::map<char*, Events_MessageGroup*> myGroups;
34 //! The empty constructor, will be called at startup of the application, only once
37 ///! Returns the main object of the loop, one per application.
38 EVENTS_EXPORT static Events_Loop* loop();
39 //! Returns the unique event by the given name. Call this method only on initialization of object
40 //! to speedup the events processing without parsing of the string.
41 EVENTS_EXPORT static Events_ID eventByName(const char* theName);
43 //! Allows to send an event
44 //! \param isGroup is true for grouping messages if possible
45 EVENTS_EXPORT void send(Events_Message& theMessage, bool isGroup = true);
47 //! Registers (or adds if such listener is already registered) a listener
48 //! that will be called on the event and from the defined sender
49 EVENTS_EXPORT void registerListener(Events_Listener* theListener, const Events_ID theID,
52 //! Initializes sending of a group-message by the given ID
53 EVENTS_EXPORT void flush(const Events_ID& theID);