最終更新:ID:D6FCvle4DQ 2016年12月09日(金) 20:26:09履歴
Namespace : AL
#include <alcommon/almodule.h>
タスク管理
- ALModule::isRunning
- ALModule::wait
- ALModule::stop
- ALModule::exit
- ALModule::getBrokerName
- ALModule::getMethodList
- ALModule::getMethodHelp
- ALModule::getModuleHelp
- ALModule::getUsage
- ALModule::ping
- ALModule::version
bool ALModule::isRunning(const int& id)
Determines if the method created with a ‘post’ is still running.
- Parameters: id – The ID of the method that was returned by ‘post’
- Returns: true if the method is still running, false otherwise
bool ALModule::wait(const int& id, const int& timeout)
Waits until the end of a long running method using the ID that was returned from a method started with ‘post’
- Parameters: id – The ID of the method that was returned by ‘post
- timeout – The wait timeout period in ms. If 0 wait indefinitely.
- Returns: true if the timeout period expired, false otherwise
qi::FutureSync<void> ALModule::wait(const int& id)
Waits until the end of a long running method using the ID that was returned from a method started with ‘post’
- Parameters: id – The ID of the method that was returned by ‘post’
- Returns: a cancelable future that will call stop(id) upon cancel
void ALModule::stop(const int& id)
Stops a module’s method using the ID given returned by a ‘post’ call. Module authors are encouraged to implement this if they have long running methods that they wish to allow users to interrupt.
- Parameters: id – The ID of the method that was returned by ‘post’
void ALModule::exit()
Unregisters the module from the parent broker. Once this is called the method of your module will no longer be available. Module authors who override this method are expected to perform a clean shutdown.
! | 注意 It is not advised to call exit on Core modules such as ALMemory or ALMotion while other module or code are accessing them. |
std::string ALModule::getBrokerName()
Gets the name of the parent broker
- Returns: The name of the parent broker
std::vector<std::string> ALModule::getMethodList()
Retrieves the module’s method list
- Returns: A vector of method names
AL::ALValue ALModule::getMethodHelp(const std::string& methodName)
Retrieves a method’s description
- Parameters: methodName – The name of the method
- Returns: A structure containing the method’s description
[ std::string methodName, [ parameter, ...], std::string returnName, std::string returnDescription ] Where parameter is [ std::string parameterName, std::string parameterDescription ]
AL::ALValue ALModule::getModuleHelp()
Retrieves a structure containing the module’s description:
- Returns: A structure describing the module
[ std::string moduleDescription, [ moduleExample, ...] ] Where moduleExample is [ std::string language, std::string example ]
std::string ALModule::getUsage(const std::string& methodName)
Gets the method usage string. This summarizes how to use the method.
- Parameters: methodName – The name of the method
- Returns: A string that summarizes the usage of the method
bool ALModule::ping()
Just a ping to test connectivity. Always returns true
- Returns: returns true
std::string ALModule::version()
Returns the version of the module
- Returns: The version as a string
Event: "ClientConnected"
callback(std::string eventName, const std::string &brokerName, std::string subscriberIdentifier)
The broker brokerName is connected.
Event: "ClientDisconnected"
callback(std::string eventName, const std::string &brokerName, std::string subscriberIdentifier)
The broker brokerName has been disconnect.
コメントをかく