RSC  0.16.0
RepetitiveTask.h
Go to the documentation of this file.
1 /* ============================================================
2  *
3  * This file is a part of the RSC project.
4  *
5  * Copyright (C) 2011 by Johannes Wienke <jwienke at techfak dot uni-bielefeld dot de>
6  *
7  * This file may be licensed under the terms of the
8  * GNU Lesser General Public License Version 3 (the ``LGPL''),
9  * or (at your option) any later version.
10  *
11  * Software distributed under the License is distributed
12  * on an ``AS IS'' basis, WITHOUT WARRANTY OF ANY KIND, either
13  * express or implied. See the LGPL for the specific language
14  * governing rights and limitations.
15  *
16  * You should have received a copy of the LGPL along with this
17  * program. If not, go to http://www.gnu.org/licenses/lgpl.html
18  * or write to the Free Software Foundation, Inc.,
19  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
20  *
21  * The development of this software was supported by:
22  * CoR-Lab, Research Institute for Cognition and Robotics
23  * Bielefeld University
24  *
25  * ============================================================ */
26 
27 #pragma once
28 
29 #include <iostream>
30 #include <set>
31 
32 #include <boost/function.hpp>
33 #include <boost/thread.hpp>
34 #include <boost/thread/condition.hpp>
35 #include <boost/timer.hpp>
36 
37 #include "Task.h"
38 
39 namespace rsc {
40 namespace threading {
41 
59 class RSC_EXPORT RepetitiveTask: public Task {
60 public:
61 
63 
64  virtual ~RepetitiveTask();
65 
71  virtual void pre();
72 
76  virtual void execute() = 0;
77 
82  virtual void post();
83 
88  virtual void cancel();
89 
97  virtual bool isCancelRequested();
98 
108  virtual bool continueExec();
109 
114  void run();
115 
116  virtual void waitDone();
117  virtual bool isDone();
118 
119  friend std::ostream& operator<<(std::ostream& out, const RepetitiveTask& t);
120 
121 protected:
122 
123  mutable boost::recursive_mutex doneMutex;
124  boost::condition doneCondition;
125 
126 private:
127 
128  void markDone();
129 
130  void timerBeforeCycle();
131 
132  void timerAfterCycle();
133 
134  volatile bool cancelRequest;
135  volatile bool done;
136 
138  // TODO boost::timer measures cpu time, not really used time
139  boost::timer timer;
140 
141 };
142 
143 std::ostream& operator<<(std::ostream& out, const RepetitiveTask& t);
144 
145 }
146 }
147 
boost::recursive_mutex doneMutex
ostream & operator<<(ostream &out, const RepetitiveTask &t)
A task is a self.contained piece of work that can be executed by another thread.
Definition: Task.h:52
A task that already provides a base frame for common logic of interruptible tasks.
rsc::logging::LoggerPtr logger
boost::shared_ptr< Logger > LoggerPtr
Definition: Logger.h:41