Encapsulates service runtime data. More...

#include <serviceruntimedata.hpp>

Classes
class	ModifiedCallback
	Old school modification callback. More...

Public Types
typedef function< void(const string &path)	ModifiedFunction)
	Callback function type for change subscriptions.

typedef shared_ptr< void >	ModifiedSubscriptionToken
	Token type that can be used to identify the change subscription.

Public Member Functions
ModifiedSubscriptionToken	addModifiedNotificationHandler (ModifiedFunction callback)
	Allows to subscribe to modifications in this data context.

ModifiedSubscriptionToken	addModifiedNotificationHandlerEx (ModifiedCallback *callback)
	Subscribes to modification notifications within this object.

bool	createElement (const string &parentPath, const string &xml)
	Create a new element to the runtime data in the given path.

RuntimeDataObjectBoolSharedPtr	getBoolObject (const string &path) const
	Retrieve boolean object at specific path.

bool	getBoolValue (const string &path, bool defaultValue=false)
	Retrieve boolean value from runtime data parameter.

RuntimeDataObjectIntSharedPtr	getIntObject (const string &path) const
	Retrieve int object at specific path.

int	getIntValue (const string &path, int defaultValue=0)
	Retrieve int value from runtime data parameter.

size_t	getListItemCount (const string &path) const
	Returns the amount of list items the pointed list has.

RuntimeDataObjectListSharedPtr	getListObject (const string &path) const
	Retrieve list object at specific path.

RuntimeDataObjectSharedPtr	getObject (const string &path) const
	Retrieves object.

RuntimeDataObject::Type	getObjectType (const string &path) const
	Retrieves the type of the object at specific path.

RuntimeDataObjectRealSharedPtr	getRealObject (const string &path) const
	Retrieve real object at specific path.

double	getRealValue (const string &path, double defaultValue=0)
	Retrieve real value from runtime data parameter.

RuntimeDataObjectSharedPtr	getRoot ()
	Retrieve the root node.

const string &	getSchema ()
	Returns the data schema in XML.

const string &	getServiceName () const
	Retrieves the service name to which the runtime data belongs.

RuntimeDataObjectStringSharedPtr	getStringObject (const string &path) const
	Retrieve string object at specifi path.

string	getStringValue (const string &path, string defaultValue="")
	Retrieve string value from runtime data parameter.

bool	hasObject (const string &path) const
	Checks whether object exists in specific path.

void	invalidateSchema ()
	Purge XML Schema cache. When a schema is requested next time, the tree structure is to be scanned.

void	notifyModified (string path="")
	Notifies subscriptions when the content changes.

bool	parseFromXML (const string &serviceIdentifier, const string &xml)
	Parses the structure from a XML file.

bool	parseFromXMLElement (const tinyxml2::XMLElement *element)
	Parses structure from xml structure.

bool	processMessage (const MessagePackage &message, shared_ptr< GenericRPCReplyMessage > &ret)
	Offer received message directly to service to implement a short path for scripts and built-in methods. Intended for internal use.

bool	removeElement (const string &path)
	Remove the given element from the runtime data, removes intermediate elements if they become empty.

void	removeMethodRecursive (const string &path)
	Remove all existing methods under the given path.

void	removeModifiedNotificationHandler (ModifiedSubscriptionToken token)
	Allows to unsubscribe from modifications in this data context.

	ServiceRuntimeData (ConnectDomainSharedPtr domain, const persistence::SettingFactory *settingFactory)
	Runtime data of a service.

	ServiceRuntimeData (ConnectDomainSharedPtr domain, const persistence::SettingFactory *settingFactory, const string &service_name)
	Runtime data of a service.

bool	setSerializedValue (const string &path, const string &serializedValue)
	Set value for a runtime data parameter.

bool	setValue (const string &path, bool value)
	Set value for a runtime data parameter.

bool	setValue (const string &path, const char *value)
	Set value for a runtime data parameter.

bool	setValue (const string &path, double value)
	Set value for a runtime data parameter.

bool	setValue (const string &path, int value)
	Set value for a runtime data parameter.

bool	setValue (const string &path, string value)
	Set value for a runtime data parameter.

virtual	~ServiceRuntimeData ()

Protected Member Functions
void	createServiceExtensionForRuntimeData (const string &parentPath, const tinyxml2::XMLElement *element, const string &operation, RuntimeDataObjectSharedPtr node)
	Create a method or event for a writable or method-readable runtime data.

RuntimeDataObjectSharedPtr	getObjectInternal (const string &path, bool passLists) const
	Retrieves object.

void	processNode (const tinyxml2::XMLElement *element, RuntimeDataObjectSharedPtr parent)
	Processes a single node during construction.

void	processNode (const tinyxml2::XMLElement *element, RuntimeDataObjectSharedPtr parent, bool createMethod)
	Processes a single node during construction.

void	validateHashCodes (RuntimeDataObjectSharedPtr object)
	Processes a node tree and checks that it does not contain duplicate hash values that might collide.

Detailed Description

Encapsulates service runtime data.

Member Typedef Documentation

◆ ModifiedFunction

typedef function<void(const string& path) kanzi::connect::ServiceRuntimeData::ModifiedFunction)

Callback function type for change subscriptions.

◆ ModifiedSubscriptionToken

typedef shared_ptr<void> kanzi::connect::ServiceRuntimeData::ModifiedSubscriptionToken

Token type that can be used to identify the change subscription.

Constructor & Destructor Documentation

◆ ServiceRuntimeData() [1/2]

kanzi::connect::ServiceRuntimeData::ServiceRuntimeData	(	ConnectDomainSharedPtr	domain,
		const persistence::SettingFactory *	settingFactory )

explicit

Runtime data of a service.

Parameters

domain	the domain where the runtime data operates in.
settingFactory	factory to access persistence service

◆ ServiceRuntimeData() [2/2]

kanzi::connect::ServiceRuntimeData::ServiceRuntimeData	(	ConnectDomainSharedPtr	domain,
		const persistence::SettingFactory *	settingFactory,
		const string &	service_name )

explicit

Runtime data of a service.

Parameters

domain	the domain where the runtime data operates in.
settingFactory	factory to access persistence service
service_name	the service name to which the runtime data belongs to

◆ ~ServiceRuntimeData()

virtual kanzi::connect::ServiceRuntimeData::~ServiceRuntimeData ( )

virtual

Member Function Documentation

◆ addModifiedNotificationHandler()

ModifiedSubscriptionToken kanzi::connect::ServiceRuntimeData::addModifiedNotificationHandler ( ModifiedFunction callback )

Allows to subscribe to modifications in this data context.

Parameters

callback Callback that is invoked when a change occurs in this data context.

Returns: Token that can be used to identify and remove given subscription.

◆ addModifiedNotificationHandlerEx()

ModifiedSubscriptionToken kanzi::connect::ServiceRuntimeData::addModifiedNotificationHandlerEx ( ModifiedCallback * callback )

Subscribes to modification notifications within this object.

Parameters

callback the callback interface whom method is to be called on change.

Returns: token that can be used to identify and remove given subscription.

◆ createElement()

bool kanzi::connect::ServiceRuntimeData::createElement	(	const string &	parentPath,
		const string &	xml )

Create a new element to the runtime data in the given path.

Parameters

parentPath	Specifies where to add the new element.
xml	Contains the xml defining the element contents

Returns: True if the new element was successfully added

◆ createServiceExtensionForRuntimeData()

void kanzi::connect::ServiceRuntimeData::createServiceExtensionForRuntimeData	(	const string &	parentPath,
		const tinyxml2::XMLElement *	element,
		const string &	operation,
		RuntimeDataObjectSharedPtr	node )

protected

Create a method or event for a writable or method-readable runtime data.

Parameters

parentPath	parent path of the given element
element	the element contains runtime data contents
operation	"set","get","notify"
node	The node which processes the method arguments when called

◆ getBoolObject()

RuntimeDataObjectBoolSharedPtr kanzi::connect::ServiceRuntimeData::getBoolObject ( const string & path ) const

Retrieve boolean object at specific path.

Parameters

path	full path to object to retrieve.

Returns: boolean object or empty pointer.

◆ getBoolValue()

bool kanzi::connect::ServiceRuntimeData::getBoolValue	(	const string &	path,
		bool	defaultValue = false )

Retrieve boolean value from runtime data parameter.

Parameters

path	identify the data object.
defaultValue	value to return in case named parameter not found.

Returns: runtime data value

◆ getIntObject()

RuntimeDataObjectIntSharedPtr kanzi::connect::ServiceRuntimeData::getIntObject ( const string & path ) const

Retrieve int object at specific path.

Parameters

path	full path to object to retrieve.

Returns: int object or empty pointer.

◆ getIntValue()

int kanzi::connect::ServiceRuntimeData::getIntValue	(	const string &	path,
		int	defaultValue = 0 )

Retrieve int value from runtime data parameter.

Parameters

path	identify the data object.
defaultValue	value to return in case named parameter not found.

Returns: runtime data value

◆ getListItemCount()

size_t kanzi::connect::ServiceRuntimeData::getListItemCount ( const string & path ) const

Returns the amount of list items the pointed list has.

Shall the path point to something else than a list then 0 is returned.

Parameters

path	the path to list to inspect

Returns: amount of objects. >= 0.

◆ getListObject()

RuntimeDataObjectListSharedPtr kanzi::connect::ServiceRuntimeData::getListObject ( const string & path ) const

Retrieve list object at specific path.

Parameters

path	full path to object to retrieve.

Returns: string object or empty pointer.

◆ getObject()

RuntimeDataObjectSharedPtr kanzi::connect::ServiceRuntimeData::getObject ( const string & path ) const

Retrieves object.

Parameters

path	Full path to object

Returns: object or empty pointer.

◆ getObjectInternal()

RuntimeDataObjectSharedPtr kanzi::connect::ServiceRuntimeData::getObjectInternal	(	const string &	path,
		bool	passLists ) const

protected

Retrieves object.

Parameters

path	Full path to object
passLists	if true, then also lists are gone through

Returns: object or empty pointer.

◆ getObjectType()

RuntimeDataObject::Type kanzi::connect::ServiceRuntimeData::getObjectType ( const string & path ) const

Retrieves the type of the object at specific path.

Parameters

path	Full path to object.

Returns: type of object.

◆ getRealObject()

RuntimeDataObjectRealSharedPtr kanzi::connect::ServiceRuntimeData::getRealObject ( const string & path ) const

Retrieve real object at specific path.

Parameters

path	full path to object to retrieve.

Returns: real object or empty pointer.

◆ getRealValue()

double kanzi::connect::ServiceRuntimeData::getRealValue	(	const string &	path,
		double	defaultValue = 0 )

Retrieve real value from runtime data parameter.

Parameters

path	identify the data object.
defaultValue	value to return in case named parameter not found.

Returns: runtime data value

◆ getRoot()

RuntimeDataObjectSharedPtr kanzi::connect::ServiceRuntimeData::getRoot ( )

Retrieve the root node.

Returns: the root node.

◆ getSchema()

const string & kanzi::connect::ServiceRuntimeData::getSchema ( )

Returns the data schema in XML.

Returns: XML Schema.

◆ getServiceName()

const string & kanzi::connect::ServiceRuntimeData::getServiceName ( ) const

Retrieves the service name to which the runtime data belongs.

Returns: the service name to which the runtime data belongs

◆ getStringObject()

RuntimeDataObjectStringSharedPtr kanzi::connect::ServiceRuntimeData::getStringObject ( const string & path ) const

Retrieve string object at specifi path.

Parameters

path	full path to object to retrieve.

Returns: string object or empty pointer.

◆ getStringValue()

string kanzi::connect::ServiceRuntimeData::getStringValue	(	const string &	path,
		string	defaultValue = "" )

Retrieve string value from runtime data parameter.

Parameters

path	identify the data object.
defaultValue	value to return in case named parameter not found.

Returns: runtime data value

◆ hasObject()

bool kanzi::connect::ServiceRuntimeData::hasObject ( const string & path ) const

Checks whether object exists in specific path.

Parameters

path	Full path to object, using dotted format First.Second.Third

Returns: true if path points to a valid object.

◆ invalidateSchema()

void kanzi::connect::ServiceRuntimeData::invalidateSchema ( )

Purge XML Schema cache. When a schema is requested next time, the tree structure is to be scanned.

◆ notifyModified()

void kanzi::connect::ServiceRuntimeData::notifyModified ( string path = "" )

Notifies subscriptions when the content changes.

Framework reports changed values to clients asynchronously if an instance of ConnectDomainSharedPtr is given to the class during construction. However, by manually notifying changes, one can flush the pending notifications and also patch several changes into single notification. It is up to subscription, what values will be actually sent to client.

Parameters

path	the path that needs to be reported.

◆ parseFromXML()

bool kanzi::connect::ServiceRuntimeData::parseFromXML	(	const string &	serviceIdentifier,
		const string &	xml )

Parses the structure from a XML file.

Parameters

serviceIdentifier	Identifies the service for which the runtime data belongs to
xml	structure

Returns: true if file parsed successfully

◆ parseFromXMLElement()

bool kanzi::connect::ServiceRuntimeData::parseFromXMLElement ( const tinyxml2::XMLElement * element )

Parses structure from xml structure.

Parameters

element the element whom childs are to be enumerated

Returns: true if success, false otherwise.

◆ processMessage()

bool kanzi::connect::ServiceRuntimeData::processMessage	(	const MessagePackage &	message,
		shared_ptr< GenericRPCReplyMessage > &	ret )

Offer received message directly to service to implement a short path for scripts and built-in methods. Intended for internal use.

◆ processNode() [1/2]

void kanzi::connect::ServiceRuntimeData::processNode	(	const tinyxml2::XMLElement *	element,
		RuntimeDataObjectSharedPtr	parent )

protected

Processes a single node during construction.

Parameters

element	the element to process
parent	parent node

◆ processNode() [2/2]

void kanzi::connect::ServiceRuntimeData::processNode	(	const tinyxml2::XMLElement *	element,
		RuntimeDataObjectSharedPtr	parent,
		bool	createMethod )

protected

Processes a single node during construction.

Parameters

element	the element to process
parent	parent node
createMethod	if true, create method for writable runtime data

◆ removeElement()

bool kanzi::connect::ServiceRuntimeData::removeElement ( const string & path )

Remove the given element from the runtime data, removes intermediate elements if they become empty.

Parameters

path	Identifies the element to remove

Returns: True if removal succeeded

◆ removeMethodRecursive()

void kanzi::connect::ServiceRuntimeData::removeMethodRecursive ( const string & path )

Remove all existing methods under the given path.

◆ removeModifiedNotificationHandler()

void kanzi::connect::ServiceRuntimeData::removeModifiedNotificationHandler ( ModifiedSubscriptionToken token )

Allows to unsubscribe from modifications in this data context.

Parameters

token Token to identify the subscription that should be removed.