Starts, stops and restarts applications and scenarios. Can also be used to request the status of an application. The proper system-specific stopstrategy and starter have to be set in the constructor. More...

#include <ArmarXCore/util/ScenarioManagerCommon/executor/Executor.h>

Public Member Functions
	Executor (StopStrategyPtr strategy, ApplicationStarterPtr starter)
	Constructor that sets StopStrategy and ApplicationStarter. More...

std::string	getApplicationStatus (Data_Structure::ApplicationInstancePtr application)
	Returns the status of an application. More...

StopStrategyPtr	getDefaultStopStrategy ()

ApplicationStarterPtr	getStarter (Data_Structure::ScenarioPtr scenario)

StopStrategyPtr	getStopStrategy (Data_Structure::ScenarioPtr scenario)

void	loadAndSetCachedProperties (Data_Structure::ApplicationPtr application, std::string path, bool reload=false, bool set=true)
	Generates an XML file of the given application and saves it in the specified path. More...

std::future< void >	restartApplication (Data_Structure::ApplicationInstancePtr application, bool printOnly=false)
	Restarts an application. More...

std::future< void >	restartScenario (Data_Structure::ScenarioPtr scenario, bool printOnly=false)
	Restarts a scenario. More...

void	setDefaultStarter (ApplicationStarterPtr appStarter)
	Sets the appStarter this Executor uses to start applications and request statuses. More...

void	setDefaultStopStrategy (StopStrategyPtr strategy)
	Sets the strategy this Executor uses to stop applications. More...

void	setStarter (ApplicationStarterPtr appStarter, Data_Structure::ScenarioPtr scenario)

void	setStopStrategy (StopStrategyPtr strategy, Data_Structure::ScenarioPtr scenario)

std::future< void >	startApplication (Data_Structure::ApplicationInstancePtr application, bool printOnly=false, const std::string &commandLineParameters="")
	Starts an application. More...

std::future< void >	startScenario (Data_Structure::ScenarioPtr scenario, bool printOnly=false, const std::string &commandLineParameters="")
	Starts a scenario. More...

std::future< void >	stopApplication (Data_Structure::ApplicationInstancePtr application)
	Stops an application. More...

std::future< void >	stopScenario (Data_Structure::ScenarioPtr scenario)
	Stops a scenario. More...

Detailed Description

Starts, stops and restarts applications and scenarios. Can also be used to request the status of an application. The proper system-specific stopstrategy and starter have to be set in the constructor.

Definition at line 54 of file Executor.h.

Constructor & Destructor Documentation

◆ Executor()

Executor	(	Exec::StopStrategyPtr	strategy,
		Exec::ApplicationStarterPtr	starter
	)

Constructor that sets StopStrategy and ApplicationStarter.

Parameters

strategy	Strategy used to stop applications.
starter	Starter used to start applications and request their status.

Definition at line 39 of file Executor.cpp.

Here is the call graph for this function:

Member Function Documentation

◆ getApplicationStatus()

std::string getApplicationStatus ( Data_Structure::ApplicationInstancePtr application )

Returns the status of an application.

Uses the ApplicationStarter to request the status, therefore the proper system-specific starter has to be set, even to use this method.

Parameters

application application whose status is returned

Returns: status of the application

Definition at line 125 of file Executor.cpp.

◆ getDefaultStopStrategy()

Exec::StopStrategyPtr getDefaultStopStrategy ( )

Definition at line 283 of file Executor.cpp.

◆ getStarter()

Exec::ApplicationStarterPtr getStarter ( Data_Structure::ScenarioPtr scenario )

Definition at line 265 of file Executor.cpp.

◆ getStopStrategy()

Exec::StopStrategyPtr getStopStrategy ( Data_Structure::ScenarioPtr scenario )

Definition at line 274 of file Executor.cpp.

◆ loadAndSetCachedProperties()

void loadAndSetCachedProperties	(	Data_Structure::ApplicationPtr	application,
		std::string	path,
		bool	reload = `false`,
		bool	set = `true`
	)

Generates an XML file of the given application and saves it in the specified path.

If there already is an XML file at that location it only reloads the file if the executable is more recently changed than the Xml file

Parameters

application	Application whose XML file is to be generate
path	location to save the XML, must be a folder
reload	forces to reload the cached XML
set	if true the newly Cached Xml gets loaded into the Application (Warning: If you load an ApplicationInstance the cfg parameter have to be reloaded)

Definition at line 205 of file Executor.cpp.

Here is the call graph for this function:

◆ restartApplication()

std::future< void > restartApplication	(	Data_Structure::ApplicationInstancePtr	application,
		bool	printOnly = `false`
	)

Restarts an application.

Stops and starts an application.

Parameters

application application to be restarted

Returns: true

if the application was successfully restarted. Successfull restart requires successfull stop and successfull start. An already stopped application also counts as successfully restarted, if successfully started.

Definition at line 108 of file Executor.cpp.

◆ restartScenario()

std::future< void > restartScenario	(	Data_Structure::ScenarioPtr	scenario,
		bool	printOnly = `false`
	)

Restarts a scenario.

Iterates over the applications in the scenario and restarts them.

Parameters

scenario scenario to be restarted

Returns: true

if all applications were successfully restarted

Definition at line 196 of file Executor.cpp.

◆ setDefaultStarter()

void setDefaultStarter ( ApplicationStarterPtr appStarter )

Sets the appStarter this Executor uses to start applications and request statuses.

Needs to be system specific. Use the Factory-Classes to get the proper appStarter for your system.

Parameters

appStarter appStarter to be set

See also: StarterFactory; StarterFactoryLinux

Definition at line 250 of file Executor.cpp.

Here is the caller graph for this function:

◆ setDefaultStopStrategy()

void setDefaultStopStrategy ( StopStrategyPtr strategy )

Sets the strategy this Executor uses to stop applications.

Needs to be system specific. Use the Factory-Classes to get the proper strategy for your system.

Parameters

strategy strategy to be set

See also: StopStrategyFactory

Definition at line 246 of file Executor.cpp.

Here is the caller graph for this function:

◆ setStarter()

void setStarter	(	ApplicationStarterPtr	appStarter,
		Data_Structure::ScenarioPtr	scenario
	)

Definition at line 260 of file Executor.cpp.

◆ setStopStrategy()

void setStopStrategy	(	StopStrategyPtr	strategy,
		Data_Structure::ScenarioPtr	scenario
	)

Definition at line 255 of file Executor.cpp.

◆ startApplication()

std::future< void > startApplication	(	Data_Structure::ApplicationInstancePtr	application,
		bool	printOnly = `false`,
		const std::string &	commandLineParameters = `""`
	)

Starts an application.

Parameters

application application to be started.

Returns: true

if the application was successfully started

Definition at line 45 of file Executor.cpp.

Here is the call graph for this function:

◆ startScenario()

std::future< void > startScenario	(	Data_Structure::ScenarioPtr	scenario,
		bool	printOnly = `false`,
		const std::string &	commandLineParameters = `""`
	)

Starts a scenario.

Iterates over the applications in the scenario and starts them.

Parameters

scenario scenario to be started

Returns: true

if all applications were successfully started

Definition at line 134 of file Executor.cpp.

Here is the call graph for this function:

◆ stopApplication()

std::future< void > stopApplication ( Data_Structure::ApplicationInstancePtr application )

Stops an application.

Parameters

application application to be stopped

Returns: true

if the application was successfully stopped

Definition at line 68 of file Executor.cpp.

Here is the call graph for this function:

◆ stopScenario()

std::future< void > stopScenario ( Data_Structure::ScenarioPtr scenario )

Stops a scenario.

Iterates over the applications in the scenario and stops them.

Parameters

scenario scenario to be stopped

Returns: true

if all applications were successfully stopped

Definition at line 173 of file Executor.cpp.

The documentation for this class was generated from the following files:

ArmarXCore/util/ScenarioManagerCommon/executor/Executor.h
ArmarXCore/util/ScenarioManagerCommon/executor/Executor.cpp

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ Executor()

Member Function Documentation

◆ getApplicationStatus()

◆ getDefaultStopStrategy()

◆ getStarter()

◆ getStopStrategy()

◆ loadAndSetCachedProperties()

◆ restartApplication()

◆ restartScenario()

◆ setDefaultStarter()

◆ setDefaultStopStrategy()

◆ setStarter()

◆ setStopStrategy()

◆ startApplication()

◆ startScenario()

◆ stopApplication()

◆ stopScenario()