tdaq-develop-2025-02-12
CoreSupervisorBase.h
1 #ifndef _ots_CoreSupervisorBase_h_
2 #define _ots_CoreSupervisorBase_h_
3 
4 #include "otsdaq/FiniteStateMachine/RunControlStateMachine.h"
5 #include "otsdaq/SOAPUtilities/SOAPMessenger.h"
6 #include "otsdaq/WorkLoopManager/WorkLoopManager.h"
7 
8 #include "otsdaq/CoreSupervisors/CorePropertySupervisorBase.h"
9 
10 #include "otsdaq/CgiDataUtilities/CgiDataUtilities.h"
11 #include "otsdaq/SOAPUtilities/SOAPUtilities.h"
12 #include "otsdaq/XmlUtilities/HttpXmlDocument.h"
13 
14 #include "otsdaq/FiniteStateMachine/VStateMachine.h"
15 #include "otsdaq/WebUsersUtilities/RemoteWebUsers.h"
16 
17 #pragma GCC diagnostic push
18 #pragma GCC diagnostic ignored "-Wdeprecated-declarations"
19 #include <xdaq/Application.h>
20 #pragma GCC diagnostic pop
21 #include "otsdaq/Macros/XDAQApplicationMacros.h"
22 #include "xgi/Method.h"
23 
24 #include <toolbox/fsm/FailedEvent.h>
25 
26 #include <xdaq/NamespaceURI.h>
27 #include <xoap/Method.h>
28 
29 #include <time.h>
30 #include <map>
31 #include <memory>
32 #include <string> /*string and to_string*/
33 #include <vector>
34 
35 namespace ots
36 {
37 // clang-format off
38 
44 class CoreSupervisorBase : public xdaq::Application,
45  public SOAPMessenger,
48 {
49  friend class MacroMakerSupervisor;
51 
52  public:
53  CoreSupervisorBase(xdaq::ApplicationStub* stub);
54  virtual ~CoreSupervisorBase(void);
55 
56  void destroy(void);
57 
58  unsigned int getSupervisorLID (void) const { return getApplicationDescriptor()->getLocalId(); }
59 
60 
68  virtual void defaultPage (xgi::Input* in, xgi::Output* out);
69  virtual void request (const std::string& requestType,
70  cgicc::Cgicc& cgiIn,
71  HttpXmlDocument& xmlOut,
72  const WebUsers::RequestUserInfo& userInfo);
73  virtual void nonXmlRequest (const std::string& requestType,
74  cgicc::Cgicc& cgiIn,
75  std::ostream& out,
76  const WebUsers::RequestUserInfo& userInfo);
77  virtual std::string getStatusProgressDetail (void);
78  virtual std::vector<SupervisorInfo::SubappInfo> getSubappInfo (void) { return std::vector<SupervisorInfo::SubappInfo>(); }
79 
80  private:
81  xoap::MessageReference workLoopStatusRequestWrapper (xoap::MessageReference message);
82  void defaultPageWrapper (xgi::Input* in, xgi::Output* out);
83  void requestWrapper (xgi::Input* in, xgi::Output* out);
84  xoap::MessageReference TRACESupervisorRequest (xoap::MessageReference message);
85 
86  public:
88  void stateMachineXgiHandler (xgi::Input* in, xgi::Output* out);
89  xoap::MessageReference stateMachineXoapHandler (xoap::MessageReference message);
90 
91  xoap::MessageReference stateMachineStateRequest (xoap::MessageReference message);
92  xoap::MessageReference stateMachineErrorMessageRequest (xoap::MessageReference message);
93 
94  void sendAsyncExceptionToGateway (const std::string& errMsg, bool isPauseException, bool isStopException);
95 
96  virtual xoap::MessageReference workLoopStatusRequest (xoap::MessageReference message);
97  virtual xoap::MessageReference applicationStatusRequest (xoap::MessageReference message);
98 
99  bool stateMachineThread (toolbox::task::WorkLoop* workLoop);
100 
101  virtual void stateInitial (toolbox::fsm::FiniteStateMachine& fsm);
102  virtual void statePaused (toolbox::fsm::FiniteStateMachine& fsm);
103  virtual void stateRunning (toolbox::fsm::FiniteStateMachine& fsm);
104  virtual void stateHalted (toolbox::fsm::FiniteStateMachine& fsm);
105  virtual void stateConfigured (toolbox::fsm::FiniteStateMachine& fsm);
106  virtual void inError (toolbox::fsm::FiniteStateMachine& fsm);
107 
108  virtual void transitionConfiguring (toolbox::Event::Reference event);
109  protected:
110  void transitionConfiguringFSMs(void);
111  public:
112  virtual void transitionHalting (toolbox::Event::Reference event);
113  virtual void transitionInitializing (toolbox::Event::Reference event);
114  virtual void transitionPausing (toolbox::Event::Reference event);
115  virtual void transitionResuming (toolbox::Event::Reference event);
116  virtual void transitionStarting (toolbox::Event::Reference event);
117  virtual void transitionStopping (toolbox::Event::Reference event);
118  virtual void enteringError (toolbox::Event::Reference event);
119 
120  static const std::string WORK_LOOP_DONE, WORK_LOOP_WORKING;
121 
122  protected:
123  WorkLoopManager stateMachineWorkLoopManager_;
124  toolbox::BSem stateMachineSemaphore_;
125  std::vector<VStateMachine*> theStateMachineImplementation_;
126 
128  std::vector<bool> stateMachinesIterationDone_;
129  unsigned int stateMachinesIterationWorkCount_;
130  unsigned int subIterationWorkStateMachineIndex_;
131  void preStateMachineExecution(unsigned int i);
132  void postStateMachineExecution(unsigned int i);
133  void preStateMachineExecutionLoop(void);
134  void postStateMachineExecutionLoop(void);
135 
136  RemoteWebUsers theRemoteWebUsers_;
137 
138 };
139 // clang-format on
140 } // namespace ots
141 
142 #endif
virtual void transitionHalting(toolbox::Event::Reference event)
virtual void stateInitial(toolbox::fsm::FiniteStateMachine &fsm)
void stateMachineXgiHandler(xgi::Input *in, xgi::Output *out)
State Machine request handlers.
virtual void request(const std::string &requestType, cgicc::Cgicc &cgiIn, HttpXmlDocument &xmlOut, const WebUsers::RequestUserInfo &userInfo)
virtual void stateConfigured(toolbox::fsm::FiniteStateMachine &fsm)
virtual std::string getStatusProgressDetail(void)
virtual void statePaused(toolbox::fsm::FiniteStateMachine &fsm)
virtual void stateRunning(toolbox::fsm::FiniteStateMachine &fsm)
virtual void transitionInitializing(toolbox::Event::Reference event)
virtual void defaultPage(xgi::Input *in, xgi::Output *out)
virtual void nonXmlRequest(const std::string &requestType, cgicc::Cgicc &cgiIn, std::ostream &out, const WebUsers::RequestUserInfo &userInfo)
std::vector< bool > stateMachinesIterationDone_
for managing transition iterations
void sendAsyncExceptionToGateway(const std::string &errMsg, bool isPauseException, bool isStopException)
virtual void stateHalted(toolbox::fsm::FiniteStateMachine &fsm)