LocalTimeServer Class Reference

A local time server that gets its time from the MasterTimeServer. More...

#include <ArmarXCore/core/time/LocalTimeServer.h>

+ Inheritance diagram for LocalTimeServer:

Public Member Functions

std::string getDefaultName () const override
 
Ice::Float getSpeed (const ::Ice::Current &=Ice::emptyCurrent) override
 
Ice::Int getStepTimeMS (const ::Ice::Current &=Ice::emptyCurrent) override
 
Ice::Long getTime (const ::Ice::Current &=Ice::emptyCurrent) override
 
void registerTimer (IceUtil::Time endTime, CallbackReceiver *callback)
 register a callack to call at endTime More...
 
void reportTime (::Ice::Long, const ::Ice::Current &=Ice::emptyCurrent) override
 
void setSpeed (Ice::Float newSpeed, const ::Ice::Current &=Ice::emptyCurrent) override
 
void start (const ::Ice::Current &=Ice::emptyCurrent) override
 
void step (const ::Ice::Current &=Ice::emptyCurrent) override
 
void stop (const ::Ice::Current &=Ice::emptyCurrent) override
 
void unregisterTimer (CallbackReceiver *callback)
 unregister a timer More...
 
- 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 ()
 

Static Public Member Functions

static LocalTimeServerPtr getApplicationTimeServer ()
 Get the applications LocalTimeServer instance. More...
 
- 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)
 

Protected Member Functions

 LocalTimeServer ()
 Please use LocalTimeServer::getApplicationtimeserver() to access your local timeserver. More...
 
void onConnectComponent () override
 
void onDisconnectComponent () override
 Hook for subclass. More...
 
void onInitComponent () override
 
- 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 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
 

Static Protected Member Functions

static void setApplicationTimeServerName (const std::string &name)
 

Protected Attributes

std::vector< RegisteredTimerscheduledTasks
 
std::mutex scheduledTasksMutex
 used for locking scheduledTasks More...
 
IceUtil::Time time
 the current time More...
 
std::shared_mutex timeMutex
 
TimeServerInterfacePrx timeServerPrx
 a handle for the MasterTimeServer More...
 
TimeServerListenerPrx timeTopicPrx
 a handle for the topic "Time" More...
 
- Protected Attributes inherited from Logging
MessageTypeT minimumLoggingLevel
 
SpamFilterDataPtr spamFilter
 
LogTag tag
 

Friends

class ArmarXManager
 

Additional Inherited Members

- Public Types inherited from ManagedIceObject
using PeriodicTaskPtr = IceUtil::Handle< SimplePeriodicTask< std::function< void(void)> >>
 
- 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...
 

Detailed Description

A local time server that gets its time from the MasterTimeServer.

The LocalTimeServer runs as a component in every application and offers the time it gets from the MasterTimeServer to the other compnents.

Definition at line 67 of file LocalTimeServer.h.

Constructor & Destructor Documentation

◆ LocalTimeServer()

LocalTimeServer ( )
protected

Please use LocalTimeServer::getApplicationtimeserver() to access your local timeserver.

Definition at line 31 of file LocalTimeServer.cpp.

+ Here is the caller graph for this function:

Member Function Documentation

◆ getApplicationTimeServer()

LocalTimeServerPtr getApplicationTimeServer ( )
static

Get the applications LocalTimeServer instance.

Returns
The applications LocalTimeServer instance

Definition at line 109 of file LocalTimeServer.cpp.

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

◆ getDefaultName()

std::string getDefaultName ( ) const
overridevirtual
See also
armarx::ManagedIceObject::getDefaultName()

Implements ManagedIceObject.

Definition at line 36 of file LocalTimeServer.cpp.

◆ getSpeed()

Ice::Float getSpeed ( const ::Ice::Current &  = Ice::emptyCurrent)
override

Definition at line 140 of file LocalTimeServer.cpp.

◆ getStepTimeMS()

Ice::Int getStepTimeMS ( const ::Ice::Current &  = Ice::emptyCurrent)
override

Definition at line 160 of file LocalTimeServer.cpp.

◆ getTime()

Ice::Long getTime ( const ::Ice::Current &  = Ice::emptyCurrent)
override

Definition at line 103 of file LocalTimeServer.cpp.

◆ onConnectComponent()

void onConnectComponent ( )
overrideprotectedvirtual

◆ onDisconnectComponent()

void onDisconnectComponent ( )
overrideprotectedvirtual

Hook for subclass.

Is called if a dependency of the object got lost (crash, network error, stopped, ...). This hook should be the inverse to onConnectComponent(). So that onDisconnectComponent() and onConnectComponent() can be called alternatingly and the ManagedIceObject remains in valid states. *

See also
onConnectComponent

Reimplemented from ManagedIceObject.

Definition at line 54 of file LocalTimeServer.cpp.

◆ onInitComponent()

void onInitComponent ( )
overrideprotectedvirtual
See also
armarx::ManagedIceObject::onInitComponent()

Implements ManagedIceObject.

Definition at line 41 of file LocalTimeServer.cpp.

+ Here is the call graph for this function:

◆ registerTimer()

void registerTimer ( IceUtil::Time  endTime,
CallbackReceiver callback 
)

register a callack to call at endTime

Parameters
endTimewhen to call
callbackwhom to call (has to implement CallbackReceiver)

Register a callback that is called when the endTime is reached. Always takes at least one timeserver tick when virtual time is active

A registered timer must be unregistered if it is destroyed before the endTime is reached!

Definition at line 145 of file LocalTimeServer.cpp.

◆ reportTime()

void reportTime ( ::Ice::Long  ,
const ::Ice::Current &  = Ice::emptyCurrent 
)
override

Definition at line 60 of file LocalTimeServer.cpp.

+ Here is the call graph for this function:

◆ setApplicationTimeServerName()

void setApplicationTimeServerName ( const std::string &  name)
staticprotected

Definition at line 115 of file LocalTimeServer.cpp.

+ Here is the call graph for this function:

◆ setSpeed()

void setSpeed ( Ice::Float  newSpeed,
const ::Ice::Current &  = Ice::emptyCurrent 
)
override

Definition at line 135 of file LocalTimeServer.cpp.

◆ start()

void start ( const ::Ice::Current &  = Ice::emptyCurrent)
override

Definition at line 125 of file LocalTimeServer.cpp.

◆ step()

void step ( const ::Ice::Current &  = Ice::emptyCurrent)
override

Definition at line 130 of file LocalTimeServer.cpp.

◆ stop()

void stop ( const ::Ice::Current &  = Ice::emptyCurrent)
override

Definition at line 120 of file LocalTimeServer.cpp.

◆ unregisterTimer()

void unregisterTimer ( CallbackReceiver callback)

unregister a timer

Parameters
theCallbackReceiver to unregister

Cancels all scheduled callbacks registered by the given CallbackReceiver

Definition at line 151 of file LocalTimeServer.cpp.

Friends And Related Function Documentation

◆ ArmarXManager

friend class ArmarXManager
friend

Definition at line 153 of file LocalTimeServer.h.

Member Data Documentation

◆ scheduledTasks

std::vector<RegisteredTimer> scheduledTasks
protected

Definition at line 151 of file LocalTimeServer.h.

◆ scheduledTasksMutex

std::mutex scheduledTasksMutex
protected

used for locking scheduledTasks

Definition at line 150 of file LocalTimeServer.h.

◆ time

IceUtil::Time time
protected

the current time

Definition at line 121 of file LocalTimeServer.h.

◆ timeMutex

std::shared_mutex timeMutex
protected

Definition at line 122 of file LocalTimeServer.h.

◆ timeServerPrx

TimeServerInterfacePrx timeServerPrx
protected

a handle for the MasterTimeServer

Definition at line 127 of file LocalTimeServer.h.

◆ timeTopicPrx

TimeServerListenerPrx timeTopicPrx
protected

a handle for the topic "Time"

Definition at line 132 of file LocalTimeServer.h.


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