StatechartEventDistributor Class Reference

The StatechartEventDistributor class is used to distribute incomming events (via Ice) to the correct states. More...

#include <ArmarXCore/statechart/StatechartEventDistributor.h>

+ Inheritance diagram for StatechartEventDistributor:

Classes

struct  EventListenerMapEntry
 

Public Types

using EventListenerMap = std::map< std::string, EventListenerMapEntry >
 
- Public Types inherited from ManagedIceObject
using PeriodicTaskPtr = IceUtil::Handle< SimplePeriodicTask< std::function< void(void)> >>
 

Public Member Functions

void clearEventMap ()
 
std::string getDefaultName () const override
 Retrieve default name of component. More...
 
EventListenerInterfacePrx getListener ()
 
std::string getUniqueEventIdentifier (const StateBasePtr &eventProcessor, const EventPtr &event, long visitId)
 
std::string registerEvent (const EventPtr &event, StateBasePtr eventProcessor, long visitId)
 
void reportEvent (const EventBasePtr &event, const Ice::Current &) override
 
void setStatechartManager (const StatechartManagerPtr &statechartManager)
 
void setStatechartName (std::string statechartName)
 
 StatechartEventDistributor ()
 
- Public Member Functions inherited from ManagedIceObject
void enableProfiler (bool enable)
 setProfiler allows setting ManagedIceObject::profiler to a new instance (if the new instance is actually not a null pointer) More...
 
std::string generateSubObjectName (const std::string &subObjectName)
 Generates a unique name for a sub object from a general name. More...
 
ArmarXManagerPtr getArmarXManager () const
 Returns the ArmarX manager used to add and remove components. More...
 
ManagedIceObjectConnectivity getConnectivity () const
 Retrieve connectivity of the object (topcis as well as proxies) More...
 
IceManagerPtr getIceManager () const
 Returns the IceManager. More...
 
VariantBasePtr getMetaInfo (const std::string &id)
 
StringVariantBaseMap getMetaInfoMap () const
 
std::string getName () const
 Retrieve name of object. More...
 
Ice::ObjectAdapterPtr getObjectAdapter () const
 Returns object's Ice adapter. More...
 
ArmarXObjectSchedulerPtr getObjectScheduler () const
 
PeriodicTaskPtr getPeriodicTask (const std::string &name)
 
Profiler::ProfilerPtr getProfiler () const
 getProfiler returns an instance of armarx::Profiler More...
 
template<class ProxyTarg , class... Args>
void getProxy (const char *name, IceInternal::ProxyHandle< ProxyTarg > &proxy, Args &&...args)
 
template<class ProxyType >
ProxyType getProxy (const std::string &name, bool addToDependencies=false, const std::string &endpoints="", bool throwOnProxyError=true)
 Retrieves a proxy object. More...
 
template<class ProxyTarg , class... Args>
void getProxy (const std::string &name, IceInternal::ProxyHandle< ProxyTarg > &proxy, Args &&...args)
 
template<class ProxyTarg , class... Args>
void getProxy (IceInternal::ProxyHandle< ProxyTarg > &proxy, const char *name, Args &&...args)
 
template<class ProxyTarg , class... Args>
void getProxy (IceInternal::ProxyHandle< ProxyTarg > &proxy, const std::string &name, Args &&...args)
 Assigns a proxy to proxy. More...
 
Ice::ObjectPrx getProxy (long timeoutMs=0, bool waitForScheduler=true) const
 Returns the proxy of this object (optionally it waits for the proxy) More...
 
template<class Prx >
Prx getProxy (long timeoutMs=0, bool waitForScheduler=true) const
 
template<class ProxyType >
void getProxy (ProxyType &proxy, const char *name, bool addToDependencies=false, const std::string &endpoints="", bool throwOnProxyError=true)
 Overload to allow using string literals as name (solve ambiguous overload). More...
 
template<class Prx >
void getProxy (Prx &prx, long timeoutMs=0, bool waitForScheduler=true) const
 
int getState () const
 Retrieve current state of the ManagedIceObject. More...
 
template<class TopicProxyType >
TopicProxyType getTopic (const std::string &name)
 Returns a proxy of the specified topic. More...
 
template<class TopicProxyType >
void getTopic (TopicProxyType &topicProxy, const std::string &name)
 Assigns a proxy of the specified topic to topicProxy. More...
 
std::vector< std::string > getUnresolvedDependencies () const
 returns the names of all unresolved dependencies More...
 
 ManagedIceObject (ManagedIceObject const &other)
 
void offeringTopic (const std::string &name)
 Registers a topic for retrival after initialization. More...
 
void preambleGetTopic (std::string const &name)
 
void setMetaInfo (const std::string &id, const VariantBasePtr &value)
 Allows to set meta information that can be queried live via Ice interface on the ArmarXManager. More...
 
void startPeriodicTask (const std::string &uniqueName, std::function< void(void)> f, int periodMs, bool assureMeanInterval=false, bool forceSystemTime=true)
 
bool stopPeriodicTask (const std::string &name)
 
bool unsubscribeFromTopic (const std::string &name)
 Unsubscribe from a topic. More...
 
bool usingProxy (const std::string &name, const std::string &endpoints="")
 Registers a proxy for retrieval after initialization and adds it to the dependency list. More...
 
void usingTopic (const std::string &name, bool orderedPublishing=false)
 Registers a proxy for subscription after initialization. More...
 
void waitForObjectScheduler ()
 Waits until the ObjectScheduler could resolve all dependencies. More...
 
void waitForProxy (std::string const &name, bool addToDependencies)
 
- Public Member Functions inherited from Logging
SpamFilterDataPtr deactivateSpam (float deactivationDurationSec=10.0f, const std::string &identifier="", bool deactivate=true) const
 disables the logging for the current line for the given amount of seconds. More...
 
MessageTypeT getEffectiveLoggingLevel () const
 
 Logging ()
 
void setLocalMinimumLoggingLevel (MessageTypeT level)
 With setLocalMinimumLoggingLevel the minimum verbosity-level of log-messages can be set. More...
 
void setTag (const LogTag &tag)
 
void setTag (const std::string &tagName)
 
virtual ~Logging ()
 

Protected Attributes

std::queue< std::pair< StateControllerPtr, EventPtr > > eventBuffer
 
EventListenerMap eventMap
 
std::string statechartName
 
- Protected Attributes inherited from Logging
MessageTypeT minimumLoggingLevel
 
SpamFilterDataPtr spamFilter
 
LogTag tag
 

Additional Inherited Members

- Static Public Member Functions inherited from ManagedIceObject
static std::string generateSubObjectName (const std::string &superObjectName, const std::string &subObjectName)
 Generates a unique name for a sub object from a general name and unique name. More...
 
static std::string GetObjectStateAsString (int state)
 
- Static Public Attributes inherited from ManagedIceObject
static const ManagedIceObjectPtr NullPtr
 A nullptr to be used when a const ref to a nullptr is required. More...
 
- Protected Member Functions inherited from ManagedIceObject
template<class PluginT , class... ParamsT>
PluginT * addPlugin (const std::string prefix="", ParamsT &&...params)
 
template<class PluginT , class... ParamsT>
void addPlugin (PluginT *&targ, const std::string prefix="", ParamsT &&...params)
 
template<class PluginT , class... ParamsT>
void addPlugin (std::experimental::observer_ptr< PluginT > &targ, const std::string prefix="", ParamsT &&...params)
 
Ice::CommunicatorPtr getCommunicator () const
 
std::unique_ptr< ManagedIceObjectPlugin > & getPluginPointer (std::type_info const &type, std::string const &prefix)
 
 ManagedIceObject ()
 Protected default constructor. More...
 
virtual void onDisconnectComponent ()
 Hook for subclass. More...
 
virtual void onExitComponent ()
 Hook for subclass. More...
 
virtual void postOnConnectComponent ()
 
virtual void postOnDisconnectComponent ()
 
virtual void postOnExitComponent ()
 
virtual void postOnInitComponent ()
 
virtual void preOnConnectComponent ()
 
virtual void preOnDisconnectComponent ()
 
virtual void preOnExitComponent ()
 
virtual void preOnInitComponent ()
 
bool removeProxyDependency (const std::string &name)
 This function removes the dependency of this object on the in parameter name specified object. More...
 
void setName (std::string name)
 Override name of well-known object. More...
 
void terminate ()
 Initiates termination of this IceManagedObject. More...
 
 ~ManagedIceObject () override
 
- Protected Member Functions inherited from Logging
bool checkLogLevel (MessageTypeT level) const
 
const LogSenderPtrgetLogSender () const
 Retrieve log sender. More...
 
LogSenderPtr loghelper (const char *file, int line, const char *function) const
 

Detailed Description

The StatechartEventDistributor class is used to distribute incomming events (via Ice) to the correct states.


The events must be registered before they can be distributed. The normal process is to register events here, when the condition or something else is registered on the observer. The registerEvent()-function returns a unique event-string that is to be passed to the observer.
A pointer to this class is passed to the observer, so that the observer can call back.

Note
This class is an internal statechart-class and is used by the classes StatechartContext and StateUtility. There is usually only one instance per statechart (it is located in the StatechartContext).

Definition at line 65 of file StatechartEventDistributor.h.

Member Typedef Documentation

◆ EventListenerMap

using EventListenerMap = std::map<std::string, EventListenerMapEntry>

Definition at line 95 of file StatechartEventDistributor.h.

Constructor & Destructor Documentation

◆ StatechartEventDistributor()

Definition at line 32 of file StatechartEventDistributor.cpp.

+ Here is the call graph for this function:

Member Function Documentation

◆ clearEventMap()

void clearEventMap ( )

Definition at line 127 of file StatechartEventDistributor.cpp.

◆ getDefaultName()

std::string getDefaultName ( ) const
inlineoverridevirtual

Retrieve default name of component.

Implement this method in each IceManagedObject. The default name of a is used if no name is specified in the factory method.

Returns
default name of the component (e.g. "KinematicUnit")

Implements ManagedIceObject.

Definition at line 90 of file StatechartEventDistributor.h.

+ Here is the caller graph for this function:

◆ getListener()

EventListenerInterfacePrx getListener ( )

Definition at line 132 of file StatechartEventDistributor.cpp.

◆ getUniqueEventIdentifier()

std::string getUniqueEventIdentifier ( const StateBasePtr eventProcessor,
const EventPtr event,
long  visitId 
)

Definition at line 115 of file StatechartEventDistributor.cpp.

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ registerEvent()

std::string registerEvent ( const EventPtr event,
StateBasePtr  eventProcessor,
long  visitId 
)

Definition at line 43 of file StatechartEventDistributor.cpp.

+ Here is the call graph for this function:

◆ reportEvent()

void reportEvent ( const EventBasePtr &  event,
const Ice::Current &  c 
)
override

Definition at line 81 of file StatechartEventDistributor.cpp.

◆ setStatechartManager()

void setStatechartManager ( const StatechartManagerPtr statechartManager)

Definition at line 38 of file StatechartEventDistributor.cpp.

◆ setStatechartName()

void setStatechartName ( std::string  statechartName)
inline

Definition at line 84 of file StatechartEventDistributor.h.

+ Here is the call graph for this function:

Member Data Documentation

◆ eventBuffer

std::queue< std::pair<StateControllerPtr, EventPtr > > eventBuffer
protected

Definition at line 104 of file StatechartEventDistributor.h.

◆ eventMap

EventListenerMap eventMap
protected

Definition at line 105 of file StatechartEventDistributor.h.

◆ statechartName

std::string statechartName
protected

Definition at line 106 of file StatechartEventDistributor.h.


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