1 /*****************************************************************************
4 ** Name: backgroundsupr.h
5 ** Purpose: Header file for background supervisors
6 ** Programmer: Kevin Rosenberg
7 ** Date Started: February 2001
9 ** This is part of the CTSim program
10 ** Copyright (C) 1983-2001 Kevin Rosenberg
12 ** $Id: backgroundsupr.h,v 1.1 2001/02/25 06:32:12 kevin Exp $
14 ** This program is free software; you can redistribute it and/or modify
15 ** it under the terms of the GNU General Public License (version 2) as
16 ** published by the Free Software Foundation.
18 ** This program is distributed in the hope that it will be useful,
19 ** but WITHOUT ANY WARRANTY; without even the implied warranty of
20 ** MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 ** GNU General Public License for more details.
23 ** You should have received a copy of the GNU General Public License
24 ** along with this program; if not, write to the Free Software
25 ** Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
26 ******************************************************************************/
28 #ifndef _BACKGROUNDSUPR_H
29 #define _BACKGROUNDSUPR_H
32 #include <wx/thread.h>
33 #include <wx/progdlg.h>
36 // This thread creates a SupervisorTask event handler object
37 // The thread is detached and terminates when SupervisorTask terminates
38 class SupervisorThread : public wxThread {
43 : wxThread(wxTHREAD_DETACHED)
49 // Pure virtual class for BackgroundSupervisor that can communication
50 // with BackgroundManager via messages
51 class BackgroundWorkerThread;
53 class BackgroundSupervisor : public wxEvtHandler {
55 DECLARE_DYNAMIC_CLASS(BackgroundSupervisor)
57 typedef std::vector<BackgroundWorkerThread*> ThreadContainer;
58 ThreadContainer m_vecpThreads;
59 wxCriticalSection m_critsectThreadContainer;
60 wxFrame* m_pParentFrame;
61 wxDocument* m_pDocument;
62 const std::string m_strProcessTitle;
63 wxProgressDialog* m_pDialogProgress;
65 volatile bool m_bFail;
66 std::string m_strFailMessage;
68 volatile int m_iRunning;
69 unsigned int m_iUnitsDone;
70 const unsigned int m_iTotalUnits;
74 bool m_bBackgroundTaskAdded;
78 MSG_BACKGROUND_SUPERVISOR_ADD = 7500, // sends to BackgroundManager and Document
79 MSG_BACKGROUND_SUPERVISOR_REMOVE = 7501, // sends to BackgroundManager and Document
80 MSG_BACKGROUND_SUPERVISOR_UNIT_TICK = 7502, // sends to BackgroundManager for progress bars
81 MSG_BACKGROUND_SUPERVISOR_CANCEL = 7503, // *sent* to Supervisor to cancel process
82 MSG_DOCUMENT_ACK_REMOVE = 7504,
84 MSG_WORKER_THREAD_UNIT_TICK = 7505,
85 MSG_WORKER_THREAD_DONE = 7506,
86 MSG_WORKER_THREAD_FAIL = 7507, // sent by workers when they fail
89 BackgroundSupervisor (wxFrame* pParentFrame, wxDocument* pDocument, const char* const pszProcessTitle,
92 BackgroundSupervisor ()
93 : m_iTotalUnits(0), wxEvtHandler()
96 virtual ~BackgroundSupervisor();
98 virtual BackgroundWorkerThread* createWorker (int iThread, int iStartUnit, int iNumUnits)
102 void deleteAnyWorkers();
103 virtual void onDone() {};
105 virtual void OnWorkerFail(wxCommandEvent& event);
106 virtual void OnWorkerUnitTick(wxCommandEvent& event);
107 virtual void OnWorkerDone(wxCommandEvent& event);
108 virtual void OnCancel(wxCommandEvent& event);
109 virtual void OnAckDocumentRemove(wxCommandEvent& event);
111 bool anyWorkersRunning() const { return m_iRunning > 0 ? true : false; }
112 bool isDone() const {return m_bDone;}
113 void setDone() { m_bDone = true; }
114 bool fail() const {return m_bFail;}
115 const std::string& getFailMessage() const { return m_strFailMessage; }
117 int getNumWorkers() const { return m_iNumThreads; }
118 double getTimerEnd() { return m_pTimer->timerEnd(); }
120 static void cancelSupervisor (BackgroundSupervisor* pSupervisor);
122 DECLARE_EVENT_TABLE()
126 class BackgroundWorkerThread : public wxThread {
128 BackgroundSupervisor* m_pSupervisor;
129 const int m_iStartUnit;
130 const int m_iNumUnits;
134 BackgroundWorkerThread (BackgroundSupervisor* pSupervisor, int iThread, int iStartUnit, int iNumUnits)
135 : m_pSupervisor(pSupervisor), m_iThread(iThread), m_iStartUnit(iStartUnit), m_iNumUnits(iNumUnits),
136 wxThread (wxTHREAD_DETACHED)
140 #endif // _BACKGROUNDSUPR_H_