blob: 5f6aab47181f1fd06f2edcc0655c5552f012d6c6 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
|
/*
* Copyright (C) 2015 by Multi-Tech Systems
*
* This file is part of libmts.
*
* libmts is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 2 of the License, or
* (at your option) any later version.
*
* libmts is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with libmts. If not, see <http://www.gnu.org/licenses/>.
*
*/
/*! \file MTS_SignalThread.h
\brief An abstract worker thread
\date 01MAR13
\author Mike Fiore
A platform independent thread that executes a task when it is signaled.
*/
#ifndef _MTS_SIGNAL_THREAD_H_
#define _MTS_SIGNAL_THREAD_H_
#include <mts/MTS_Thread.h>
#include <mts/MTS_AutoPtr.h>
#include <mts/MTS_Lock.h>
#include <mts/MTS_Condition.h>
namespace MTS {
//! An abstract worker thread
/*!
A platform independent worker thread class
*/
class SignalThread: public Thread {
public:
~SignalThread(); //!< Destructs the thread
bool isExecuting() const; //!< Returns true if the thread is currently running executing the execute() function
void signal(); //!< Instructs the thread to run the execute() function
protected:
explicit SignalThread(const std::string& name); //!< Creates the thread
explicit SignalThread(const std::string& name, uint32_t waitMillis); //!< Creates the thread
private:
void run(); //!< Abstracts the running of the thread
virtual void execute() = 0; //!< main() of the thread which is executed each time signal() is called
void init(); //!< Startup code common to all constructors
AutoPtr<Lock> m_apStateLock; //!< Condition Lock
AutoPtr<Lock> m_apConditionLock; //!< Condition Lock
AutoPtr<Condition> m_apCondition; //!< Condition for signaling and waiting
bool m_bShouldExecute; //!< Should execute flag
bool m_bCurrentlyExecuting; //!< Currently executing flag
uint32_t m_ui32WaitMillis; //!< Max time to wait on condition before checking for shutdown
};
}
#endif
|
