The Gaudi Framework  v30r4 (9b837755)
ApplicationMgr.h
Go to the documentation of this file.
1 #ifndef GAUDI_APPLICATIONMGR_H
2 #define GAUDI_APPLICATIONMGR_H
3 
11 #include "GaudiKernel/IProperty.h"
12 #include "GaudiKernel/IStateful.h"
14 #include "GaudiKernel/Kernel.h"
16 #include "GaudiKernel/Service.h"
17 
18 // STL include files
19 #include <list>
20 #include <vector>
21 
22 // Forward declarations
23 class ISvcLocator;
24 class ServiceManager;
25 class AlgorithmManager;
26 class DLLClassManager;
27 
28 class IMessageSvc;
29 class IIncidentSvc;
30 class IRunable;
31 class IDataManagerSvc;
32 class IConversionSvc;
33 class IJobOptionsSvc;
34 
48  : public PropertyHolder<
49  CommonMessaging<implements<IAppMgrUI, IEventProcessor, IService, IStateful, INamedInterface, IProperty>>>
50 {
51 public:
52  // default creator
53  ApplicationMgr( IInterface* = nullptr );
54 
55  // implementation of IInterface::queryInterface
56  StatusCode queryInterface( const InterfaceID& iid, void** pinterface ) override;
57 
58  // implementation of IAppMgrUI::run
59  StatusCode run() override;
60  // implementation of IAppMgrUI::configure
61  StatusCode configure() override;
62  // implementation of IAppMgrUI::terminate
63  StatusCode terminate() override;
64  // implementation of IAppMgrUI::initialize
65  StatusCode initialize() override;
66  // implementation of IAppMgrUI::start
67  StatusCode start() override;
68  // implementation of IAppMgrUI::stop
69  StatusCode stop() override;
70  // implementation of IAppMgrUI::finalize
71  StatusCode finalize() override;
72  // implementation of IAppMgrUI::nextEvent
73  StatusCode nextEvent( int maxevt ) override;
74  // implementation of IAppMgrUI::name
75  const std::string& name() const override;
77  StatusCode executeEvent( void* par ) override;
79  StatusCode executeRun( int evtmax ) override;
81  StatusCode stopRun() override;
82 
83  // implementation of IStateful::state
84  Gaudi::StateMachine::State FSMState() const override;
85  // implementation of IStateful::targetState
87  // implementation of IStateful::reinitialize
88  StatusCode reinitialize() override;
89  // implementation of IStateful::reinitialize
90  StatusCode restart() override;
91  // implementation of IService::sysItinitilaize
93  // implementation of IService::sysStart
94  StatusCode sysStart() override { return StatusCode::SUCCESS; }
95  // implementation of IService::sysStop
96  StatusCode sysStop() override { return StatusCode::SUCCESS; }
97  // implementation of IService::sysFinalize
99  // implementation of IService::sysReinitialize
101  // implementation of IService::sysRestart
103 
105 
115 
116  template <class I>
118  {
119  return m_managers[I::interfaceID().id()];
120  }
121 
123  {
124  // Cache the casted pointer to ISvcManager
125  if ( !m_svcManager ) {
126  m_svcManager = getManager<IService>();
127  }
128  return m_svcManager;
129  }
130 
132  {
133  // Cache the casted pointer to IAlgManager
134  if ( !m_algManager ) {
135  m_algManager = getManager<IAlgorithm>();
136  }
137  return m_algManager;
138  }
139 
141  SmartIF<ISvcLocator>& serviceLocator() const override { return m_svcLocator; }
142 
144  void outputLevelUpdate() override;
145 
146 protected:
147  // implementation of IService::setServiceManager
148  void setServiceManager( ISvcManager* ) override {}
149 
152 
157  StatusCode GoToState( Gaudi::StateMachine::State state, bool ignoreFailures = false );
158 
165  ManagersMap m_managers;
168 
171 
174 
175  // data members
179 
181  [this]( auto& ) {
182  // Re-initialize everything
183  this->reinitialize().ignore();
184  // Execute a number of events
185  this->executeRun( m_evtMax ).ignore();
186  },
187  "For SI's \"Go\" command via callback"};
189  [this]( auto& ) {
190  finalize().ignore();
191  terminate().ignore();
192  ::exit( 0 );
193  },
194  "For SI's \"Exit\" command via callback"};
196  this, "TopAlg", {}, &ApplicationMgr::evtLoopPropertyHandler, "List of top level algorithms names"};
198  this, "OutStream", {}, &ApplicationMgr::evtLoopPropertyHandler, "List of output stream names"};
199  Gaudi::Property<std::string> m_outStreamType{this, "OutStreamType", "OutputStream",
201  "[[deprecated]] Output stream type"};
202  Gaudi::Property<std::string> m_messageSvcType{this, "MessageSvcType", "MessageSvc", "MessageSvc type"};
203  Gaudi::Property<std::string> m_jobOptionsSvcType{this, "JobOptionsSvcType", "JobOptionsSvc", "JobOptionsSvc type"};
204 
205  std::string m_name = "ApplicationMgr";
208 
209  Gaudi::Property<std::vector<std::string>> m_svcMapping{this, "SvcMapping", {}, "Default mapping of services"};
211  this, "SvcOptMapping", {}, "Default mapping of optional services"};
212 
217 
218  //
219  // The public ApplicationMgr properties
220  //
221 
222  Gaudi::Property<int> m_evtMax{this, "EvtMax", -1, "Number of events to be processed (-1 means all events)"};
223  Gaudi::Property<std::vector<std::string>> m_extSvcNameList{this, "ExtSvc", {}, "List of external services names"};
224  Gaudi::Property<bool> m_extSvcCreates{this, "ExtSvcCreates", true,
225  "LHCb (default) or ATLAS definition of \"ExtSvc\""};
226 
227  Gaudi::Property<std::vector<std::string>> m_dllNameList{this, "Dlls", {}, "List of DDL's names"};
228  Gaudi::Property<std::string> m_jobOptionsType{this, "JobOptionsType", "FILE", "Source type (e.g. dbase, file...)"};
229  Gaudi::Property<std::string> m_jobOptionsPath{this, "JobOptionsPath", {}, "The \"file\" to look for properties"};
231  this, "JobOptionsPostAction", {}, "additional command to run on config"};
233  this, "JobOptionsPreAction", {}, "additional command to run on config"};
234  Gaudi::Property<std::string> m_runableType{this, "Runable", "AppMgrRunable", "Runable type"};
235  Gaudi::Property<std::string> m_eventLoopMgr{this, "EventLoop", "EventLoopMgr", "Processing manager type"};
236  Gaudi::Property<std::string> m_evtsel{this, "EvtSel", {}, "Event selection"};
237  Gaudi::Property<std::string> m_histPersName{this, "HistogramPersistency", "NONE", "Name of the Hist Pers Svc"};
238  Gaudi::Property<int> m_outputLevel{this, "OutputLevel", MSG::INFO, "Message output level"};
239  Gaudi::Property<std::string> m_appName{this, "AppName", "ApplicationMgr", "The name of the application"};
240  Gaudi::Property<std::string> m_appVersion{this, "AppVersion", {}, "The version of the application"};
241  Gaudi::Property<bool> m_actHistory{this, "ActivateHistory", false, "Activate HistorySvc"};
242  Gaudi::Property<bool> m_codeCheck{this, "StatusCodeCheck", false, "Activate StatusCode checking"};
244  this, "PluginDebugLevel", 0,
245  [this]( auto& ) {
246  // Setup debug level for the plugin system
247  MsgStream log( m_messageSvc, this->name() );
248  log << MSG::INFO << "Updating Gaudi::PluginService::SetDebug(level) to level=" << m_pluginDebugLevel << endmsg;
250  },
251  "Debug level for the plugin system"};
252 
254  this, "CreateSvc", {}, "List of extra services to be created"};
255 
257  Gaudi::Property<bool> m_auditTools{this, "AuditTools", false};
258  Gaudi::Property<bool> m_auditSvcs{this, "AuditServices", false};
259  Gaudi::Property<bool> m_auditAlgs{this, "AuditAlgorithms", false};
260 
262  this, "Environment", {}, "Environment variables to set"};
263 
264  Gaudi::Property<bool> m_loopCheck{this, "InitializationLoopCheck", true,
265  [this]( auto& ) { this->svcManager()->setLoopCheckEnabled( m_loopCheck ); },
266  "For ServiceMgr initialization loop checking"};
267 
271  this, "StopOnSignal", false, "Flag to enable/disable the signal handler that schedule a stop of the event loop"};
272 
276  this, "StalledEventMonitoring", false, "Flag to enable/disable the monitoring and reporting of stalled events"};
277 
278  Gaudi::Property<bool> m_propertiesPrint{this, "PropertiesPrint", false,
279  "Flag to activate the printout of properties"};
280 
283  "Return code of the application. Set internally in case of error conditions."};
284 
285  // For concurrency
287 
288 private:
290 };
291 #endif // GAUDI_APPLICATIONMGR_H
The ServiceManager class is in charge of the creation of concrete instances of Services.
Gaudi::StateMachine::State m_targetState
Internal State.
The AlgorithmManager class is in charge of the creation of concrete instances of Algorithms.
StatusCode initialize() override
Definition of the MsgStream class used to transmit messages.
Definition: MsgStream.h:24
Gaudi::Property< bool > m_propertiesPrint
The ISvcLocator is the interface implemented by the Service Factory in the Application Manager to loc...
Definition: ISvcLocator.h:25
StatusCode decodeDllNameList()
Gaudi::Property< int > m_returnCode
Property to record the error conditions occurring during the running.
Gaudi::Property< bool > m_stopOnSignal
Property to enable/disable the "stop on signal" service.
Gaudi::Property< bool > m_auditSvcs
Gaudi::Property< bool > m_codeCheck
std::map< unsigned long, SmartIF< IComponentManager > > ManagersMap
Typedef for the map of component managers, the key is the "id" field of the basic InterfaceID of the ...
Gaudi::Property< int > m_evtMax
SmartIF< IRunable > m_runable
Reference to the runable object.
Implementation of property with value of concrete type.
Definition: Property.h:383
The ISvcManager is the interface implemented by the Service Factory in the Application Manager to sup...
Definition: ISvcManager.h:28
ManagersMap m_managers
Map of known component managers.
StatusCode sysStart() override
Gaudi::Property< std::string > m_outStreamType
Gaudi::Property< std::string > m_jobOptionsType
const std::string & name() const override
Gaudi::Property< int > m_SIGo
Gaudi::Property< std::map< std::string, std::string > > m_environment
void outputLevelUpdate() override
Function to call to update the outputLevel of the components (after a change in MessageSvc).
Gaudi::Property< bool > m_auditAlgs
Gaudi::Property< std::string > m_appVersion
std::vector< std::string > m_okDlls
names of successfully loaded dlls
StatusCode sysRestart() override
State
Allowed states for classes implementing the state machine (ApplicationMgr, Algorithm, Service, AlgTool).
Definition: StateMachine.h:14
StatusCode sysFinalize() override
StatusCode nextEvent(int maxevt) override
SmartIF< IJobOptionsSvc > m_jobOptionsSvc
Reference to JobOption service.
void createSvcNameListHandler(Gaudi::Details::PropertyBase &)
STL class.
Gaudi::Property< std::vector< std::string > > m_outStreamNameList
SmartIF< IEventProcessor > m_processingMgr
Reference to processing manager object.
StatusCode terminate() override
SmartIF< ISvcManager > & svcManager()
SmartIF< IComponentManager > & getManager()
Gaudi::Property< std::string > m_eventLoopMgr
STL class.
Gaudi::Property< std::string > m_evtsel
StatusCode sysReinitialize() override
void evtLoopPropertyHandler(Gaudi::Details::PropertyBase &theProp)
Interface ID class.
Definition: IInterface.h:29
Gaudi::Property< int > m_outputLevel
Main interface for the JobOptions service.
StatusCode executeRun(int evtmax) override
implementation of IEventProcessor::executeRun(int)
Gaudi::Property< std::vector< std::string > > m_topAlgNameList
Gaudi::StateMachine::State targetFSMState() const override
void extSvcNameListHandler(Gaudi::Details::PropertyBase &theProp)
SmartIF< ISvcLocator > m_svcLocator
Reference to its own service locator (must be instantiated prior to any service!) ...
This class is used for returning status codes from appropriate routines.
Definition: StatusCode.h:51
Definition of the basic interface.
Definition: IInterface.h:277
Gaudi::Property< std::vector< std::string > > m_extSvcNameList
The IMessage is the interface implemented by the message service.
Definition: IMessageSvc.h:38
void dllNameListHandler(Gaudi::Details::PropertyBase &theProp)
Gaudi::Property< std::string > m_runableType
Gaudi::Property< std::vector< std::string > > m_declaredManagers
Property to declare the list of known managers.
StatusCode sysStop() override
Gaudi::Property< int > m_SIExit
Gaudi::Property< bool > m_stalledEventMonitoring
Property to enable/disable the monitoring and reporting of stalled events.
PropertyBase base class allowing PropertyBase* collections to be "homogeneous".
Definition: Property.h:34
SmartIF< ISvcManager > m_svcManager
Cached pointer to the manager of services.
StatusCode GoToState(Gaudi::StateMachine::State state, bool ignoreFailures=false)
Reach a state from current state (whichever it is) going through the correct transitions.
StatusCode finalize() override
Gaudi::Property< std::vector< std::string > > m_svcOptMapping
constexpr static const auto SUCCESS
Definition: StatusCode.h:87
Gaudi::Property< std::string > m_jobOptionsPreAction
Gaudi::Property< std::vector< std::string > > m_svcMapping
Gaudi::Property< std::vector< std::string > > m_dllNameList
StatusCode executeEvent(void *par) override
implementation of IEventProcessor::executeEvent(void*)
The Application Manager class.
Gaudi::Property< bool > m_actHistory
StatusCode queryInterface(const InterfaceID &iid, void **pinterface) override
StatusCode decodeExtSvcNameList()
Gaudi::Property< bool > m_extSvcCreates
Gaudi::Property< bool > m_auditTools
Defaults for auditors.
SmartIF< DLLClassManager > m_classManager
Reference to the class manager.
Gaudi::Property< std::string > m_jobOptionsSvcType
StatusCode start() override
Gaudi::Property< std::vector< std::string > > m_createSvcNameList
StatusCode restart() override
StatusCode configure() override
ApplicationMgr(IInterface *=nullptr)
void pluginDebugPropertyHandler(Gaudi::Details::PropertyBase &theProp)
StatusCode stopRun() override
implementation of IEventProcessor::stopRun()
StatusCode decodeCreateSvcNameList()
const StatusCode & ignore() const
Ignore/check StatusCode.
Definition: StatusCode.h:165
Gaudi::Property< std::string > m_jobOptionsPostAction
Runable interface definition.
Definition: IRunable.h:18
Helper class to implement the IProperty interface.
SmartIF< IAlgManager > m_algManager
Cached pointer to the manager of algorithms.
StatusCode i_startup()
Internal startup routine.
StatusCode stop() override
std::string m_name
Name.
Gaudi::Property< std::string > m_messageSvcType
StatusCode reinitialize() override
Gaudi::StateMachine::State m_state
Internal State.
Gaudi::Property< std::string > m_appName
Gaudi::StateMachine::State FSMState() const override
Gaudi::Property< std::string > m_histPersName
SmartIF< ISvcLocator > & serviceLocator() const override
Needed to locate the message service.
virtual void setLoopCheckEnabled(bool en=true)=0
Set the value of the initialization loop check flag.
int maxevt
Definition: Bootstrap.cpp:276
constexpr int Success
Definition: AppReturnCode.h:18
StatusCode run() override
GAUDIPS_API void SetDebug(int debugLevel)
Backward compatibility with Reflex.
SmartIF< IAlgManager > & algManager()
void setServiceManager(ISvcManager *) override
SmartIF< IMessageSvc > m_messageSvc
Reference to the message service.
StatusCode sysInitialize() override
MsgStream & endmsg(MsgStream &s)
MsgStream Modifier: endmsg. Calls the output method of the MsgStream.
Definition: MsgStream.h:209
Gaudi::Property< int > m_pluginDebugLevel
Gaudi::Property< std::string > m_jobOptionsPath
The interface implemented by the IncidentSvc service.
Definition: IIncidentSvc.h:23
bool m_useHiveAlgorithmManager
Gaudi::Property< bool > m_loopCheck