projects/smsdaemon/Task.h

#ifndef __TASK_H__
#define __TASK_H__

#include <string>

class ISmsTransceiver;

/* A Task is some piece of code that must be executed regularly, no matter whether
 * the daemon has received any SMS.
 *
 * Tasks exist in two flavours: persistant and temporary.
 *
 * A persistant task is one which lives throughout the execution of the smsdaemon instance.
 * A pointer to a persistant task can be retrieved via TaskManager::GetTask(std::string name),
 * and thus it must have a unique name.
 *
 * A temporary tasks is of a more short-lived nature. It behaves like a fire-and-forget piece of code.
 * A temporary task can be created at any time by any piece of code. This creation must be dynamicaly
 * through the new() operator. When created it registers itself with the task manager, and here after any
 * references to the task must be nulled.
 * When the temporary task has done its work it must set the protected variale to true, and the
 * task instance will here after be deleted by the task-manager.
 * Temporary tasks does not need a unique name, and once created you cannot get a pointer to it again.
 */

class Task
{
public:
        Task(std::string name, bool isTemporary);

        std::string GetName()
        {
                return _name;
        }

        virtual void ExecuteTask(ISmsTransceiver& modem) = 0;

        bool IsTemporary()
        {
                return _isTemporary;
        }
        bool IsFinished()
        {
                return _isFinished;
        }

        virtual ~Task() {}
protected:
        bool _isFinished;

private:
        std::string _name;
        bool _isTemporary;
};

#endif // __TASK_H__
1	#ifndef __TASK_H__
2	#define __TASK_H__
3
4	#include <string>
5
6	class ISmsTransceiver;
7
8	/* A Task is some piece of code that must be executed regularly, no matter whether
9	* the daemon has received any SMS.
10	*
11	* Tasks exist in two flavours: persistant and temporary.
12	*
13	* A persistant task is one which lives throughout the execution of the smsdaemon instance.
14	* A pointer to a persistant task can be retrieved via TaskManager::GetTask(std::string name),
15	* and thus it must have a unique name.
16	*
17	* A temporary tasks is of a more short-lived nature. It behaves like a fire-and-forget piece of code.
18	* A temporary task can be created at any time by any piece of code. This creation must be dynamicaly
19	* through the new() operator. When created it registers itself with the task manager, and here after any
20	* references to the task must be nulled.
21	* When the temporary task has done its work it must set the protected variale to true, and the
22	* task instance will here after be deleted by the task-manager.
23	* Temporary tasks does not need a unique name, and once created you cannot get a pointer to it again.
24	*/
25
26	class Task
27	{
28	public:
29	Task(std::string name, bool isTemporary);
30
31	std::string GetName()
32	{
33	return _name;
34	}
35
36	virtual void ExecuteTask(ISmsTransceiver& modem) = 0;
37
38	bool IsTemporary()
39	{
40	return _isTemporary;
41	}
42	bool IsFinished()
43	{
44	return _isFinished;
45	}
46
47	virtual ~Task() {}
48	protected:
49	bool _isFinished;
50
51	private:
52	std::string _name;
53	bool _isTemporary;
54	};
55
56	#endif // __TASK_H__