| 1 | /*
 | 
|---|
| 2 |  * ActionStatusList.hpp
 | 
|---|
| 3 |  *
 | 
|---|
| 4 |  *  Created on: Jun 19, 2014
 | 
|---|
| 5 |  *      Author: heber
 | 
|---|
| 6 |  */
 | 
|---|
| 7 | 
 | 
|---|
| 8 | 
 | 
|---|
| 9 | #ifndef ACTIONSTATUSLIST_HPP_
 | 
|---|
| 10 | #define ACTIONSTATUSLIST_HPP_
 | 
|---|
| 11 | 
 | 
|---|
| 12 | // include config.h
 | 
|---|
| 13 | #ifdef HAVE_CONFIG_H
 | 
|---|
| 14 | #include <config.h>
 | 
|---|
| 15 | #endif
 | 
|---|
| 16 | 
 | 
|---|
| 17 | #include <boost/thread.hpp>
 | 
|---|
| 18 | #include <list>
 | 
|---|
| 19 | #include <string>
 | 
|---|
| 20 | 
 | 
|---|
| 21 | #include "CodePatterns/Assert.hpp"
 | 
|---|
| 22 | #include "CodePatterns/Observer/Observable.hpp"
 | 
|---|
| 23 | 
 | 
|---|
| 24 | namespace MoleCuilder {
 | 
|---|
| 25 | 
 | 
|---|
| 26 | class ActionQueue;
 | 
|---|
| 27 | 
 | 
|---|
| 28 | /** Class contains list of status messages and can be observed by UI's StatusBars.
 | 
|---|
| 29 |  *
 | 
|---|
| 30 |  * It always belongs to the ActionQueue.
 | 
|---|
| 31 |  *
 | 
|---|
| 32 |  */
 | 
|---|
| 33 | class ActionStatusList : public Observable
 | 
|---|
| 34 | {
 | 
|---|
| 35 |   //!> only ActionQueue may create this class
 | 
|---|
| 36 |   friend class ActionQueue;
 | 
|---|
| 37 | private:
 | 
|---|
| 38 |   /** Constructor for class ActionStatusList.
 | 
|---|
| 39 |    *
 | 
|---|
| 40 |    */
 | 
|---|
| 41 |   ActionStatusList();
 | 
|---|
| 42 | 
 | 
|---|
| 43 |   /** Destructor for class ActionStatusList.
 | 
|---|
| 44 |    *
 | 
|---|
| 45 |    */
 | 
|---|
| 46 |   virtual ~ActionStatusList();
 | 
|---|
| 47 | 
 | 
|---|
| 48 |   /** Function to push a message to the list.
 | 
|---|
| 49 |    *
 | 
|---|
| 50 |    * This is only accessible to ActionQueue to prevent anything but Actions
 | 
|---|
| 51 |    * to give a Status message. ActionQueue::pushStatus() has access.
 | 
|---|
| 52 |    *
 | 
|---|
| 53 |    * \param _msg message to push
 | 
|---|
| 54 |    */
 | 
|---|
| 55 |   void pushMessage(const std::string &_msg);
 | 
|---|
| 56 | 
 | 
|---|
| 57 | public:
 | 
|---|
| 58 |   /** Get first message to enter list and remove from list.
 | 
|---|
| 59 |    *
 | 
|---|
| 60 |    * \return first message in list
 | 
|---|
| 61 |    */
 | 
|---|
| 62 |   std::string popFirstMessage();
 | 
|---|
| 63 | 
 | 
|---|
| 64 |   /** Get number of messages in the list.
 | 
|---|
| 65 |    *
 | 
|---|
| 66 |    * \return number of messages
 | 
|---|
| 67 |    */
 | 
|---|
| 68 |   size_t size() const
 | 
|---|
| 69 |   {
 | 
|---|
| 70 |     return m_StatusList.size();
 | 
|---|
| 71 |   }
 | 
|---|
| 72 | 
 | 
|---|
| 73 |   //!> enumeration of all notification channels
 | 
|---|
| 74 |   enum NotificationType {
 | 
|---|
| 75 |     StatusAdded,  // new status message added
 | 
|---|
| 76 |     NotificationType_MAX  // denotes the maximum of available notification types
 | 
|---|
| 77 |   };
 | 
|---|
| 78 | 
 | 
|---|
| 79 | private:
 | 
|---|
| 80 |   //!> typedef for the list of status message
 | 
|---|
| 81 |   typedef std::list<std::string> StatusList_t;
 | 
|---|
| 82 |   //> list of status message
 | 
|---|
| 83 |   StatusList_t m_StatusList;
 | 
|---|
| 84 |   //!> internal mutex to synchronize access to queue
 | 
|---|
| 85 |   boost::mutex mtx_queue;
 | 
|---|
| 86 | };
 | 
|---|
| 87 | 
 | 
|---|
| 88 | }
 | 
|---|
| 89 | 
 | 
|---|
| 90 | #endif /* ACTIONSTATUSLIST_HPP_ */
 | 
|---|