MeVisLab Toolbox Reference
mlBackgroundTaskMessageQueue.h
Go to the documentation of this file.
1 /*************************************************************************************
2 **
3 ** Copyright 2009, MeVis Medical Solutions AG
4 **
5 ** The user may use this file in accordance with the license agreement provided with
6 ** the Software or, alternatively, in accordance with the terms contained in a
7 ** written agreement between the user and MeVis Medical Solutions AG.
8 **
9 ** For further information use the contact form at https://www.mevislab.de/contact
10 **
11 **************************************************************************************/
12 
13 #ifndef ML_BACKGROUND_TASK_MESSAGE_QUEUE_H
14 #define ML_BACKGROUND_TASK_MESSAGE_QUEUE_H
15 
16 // Local includes
18 
19 #include <ThirdPartyWarningsDisable.h>
20 #include <deque>
21 #include <boost/thread/mutex.hpp>
22 #include <boost/thread/condition.hpp>
23 #include <ThirdPartyWarningsRestore.h>
24 
25 ML_START_NAMESPACE
26 
27 //-----------------------------------------------------------------------
28 
29 class BackgroundTaskMessage;
30 class BackgroundTaskMessageReceiver;
31 
33 {
35 
36 public:
39 
44 
48 
53 
57  BackgroundTaskMessage* nextMessage(int& availableMessages);
58 
63 
67 
69  bool isCanceled() const { return _isCanceled; }
70 
72  void cancel();
73 
76 
77 private:
79  std::deque<BackgroundTaskMessage*> _queue;
81  boost::mutex _mutex;
83  boost::condition _messageAvailable;
84 
86  bool _isCanceled;
87 };
88 
89 ML_END_NAMESPACE
90 
91 #endif
92 
93 
#define MLBACKGROUNDTASKS_EXPORT
Project global and OS specific declarations.
void removeMessagesForReceiver(BackgroundTaskMessageReceiver *receiver)
Remove all messages for the given receiver.
BackgroundTaskMessage * nextMessage()
Returns the next message without blocking, returns NULL if no message was available.
void cancelAndNotify()
Sets that the queue is canceled and notifies it if it is waiting for new messages.
BackgroundTaskMessage * nextMessage(int &availableMessages)
Returns the next message and the number of available messages (including the returned message) withou...
bool isCanceled() const
Returns if the queue has been canceled.
BackgroundTaskMessage * waitForMessage()
wait for the next message (the returned message is owned by the user and needs to be deleted by the u...
BackgroundTaskMessage * nextMessageNoLock()
Returns the next message without locking the queue (ONLY use for synchronous case!...
void addMessage(BackgroundTaskMessage *message)
put the message into the queue, pass ownership to the queue (do not delete the message!...
void cancel()
Sets that the queue is canceled.
The background task receiver is a light-weight base class which can be inherited (e....
The base class of all background messages.
#define ML_DISALLOW_COPY_AND_ASSIGN(className)
Defines basic macros.
Definition: mlMacros.h:23