Special derived class of PropertyNode, that allows to handle "remote properties" transparently. More...

#include <serialization/PropertyNode.h>

Inheritance diagram for AbstractRemotePropertyNode:

Public Types
typedef std::vector< PropertyNode * >	NodeList

Public Member Functions
	AbstractRemotePropertyNode (const PropertyNodeInfo &info)

virtual	~AbstractRemotePropertyNode ()

void	addChild (PropertyNode *child, int index=-1)
	Adds the specified property node as child node. More...

template<typename T >
TypedPropertyNode< T > *	toTyped ()
	Specialized method that creates a TypedRemotePropertyNode. More...

virtual PropertyNode *	parent ()
	Returns the parent property node (or NULL, if this is a root node) More...

virtual const PropertyNode *	parent () const
	Returns the parent property node (or NULL, if this is a root node) More...

virtual NodeList &	children ()
	Returns a vector with all child property nodes. More...

virtual const NodeList &	children () const
	Returns a vector with all child property nodes. More...

const PropertyNode *	findChildNode (const std::vector< std::string > &ids, std::size_t level=0) const
	Searches for a child property node (which may also be a child of a child of a child, etc). More...

PropertyNode *	findChildNode (const std::vector< std::string > &ids, std::size_t level=0)

const PropertyNode *	findChildNode (const std::string &id) const
	Searches for a child property node (which may also be a child of a child of a child, etc). More...

PropertyNode *	findChildNode (const std::string &id)
	Searches for a child property node (which may also be a child of a child of a child, etc). More...

std::string	fullID (PropertyNode *p=NULL) const
	Returns the full qualified ID of this property, including the names of the parent properties separated by '. More...

virtual void	setFromJSON (const json::Value &value)=0
	Sets the value of the property, where the value is described as JSON value. More...

virtual json::Value	getAsJSON () const =0
	Returns the value of the property as JSON value. More...

virtual void	setFromString (const std::string &value)
	Sets the value of the property, where the value is given as string. More...

virtual std::string	getAsString () const
	Returns the value of the property as string. More...

template<typename T >
const TypedPropertyNode< T > *	toTyped () const
	Casts this property node to a typed property node, or returns NULL if the types do not match. More...

virtual void	synchronize ()=0
	Synchronize with the reflected object (update PropertyNode when reflected content changes) More...

virtual RootPropertyNode *	getRootNode ()

virtual const RootPropertyNode *	getRootNode () const

template<typename Reflector >
void	reflectCommon (Reflector &r)

template<typename Reflector >
void	reflectRead (Reflector &r)

template<typename Reflector >
void	reflectWrite (Reflector &r)

const std::string &	id () const
	Returns the unique id of this property. More...

const std::string &	name () const
	Returns the name of this property as specified in the reflect() method. More...

const std::string &	comment () const
	Returns the comment that is associated with this property. More...

const Typename &	type () const
	Returns the type of this property as Typename. More...

template<typename T >
T	getHint (const std::string &attribute, const T &defaultValue=T()) const
	Returns the specified value for the given property hint attribute. More...

bool	hasHint (const std::string &attribute) const
	Returns true if a hint with the specified attribute exists. More...

bool	isReadOnly () const
	Returns true, if this property is read-only and hence, can not be modified. More...

bool	isVolatile () const
	Returns true, if this property is volatile and hence, must be locked for access. More...

void	setName (const std::string &name)
	For internal use by PropertySerializer only: Overrides the name of the property. More...

Protected Member Functions
void	removeChild (int index)
	Removes child at specific index (without deleting it). More...

void	removeChild (int index, NodeList::iterator it)
	Removes child at specific index (without deleting it). More...

void	removeChildren (int index, int count)
	Removes contiguous children, starting at index (without deleting them). More...

void	removeChildren (int index, NodeList::iterator it, int count)
	Removes contiguous children, starting at index (without deleting them). More...

void	removeAllChildren ()
	Removes all child nodes (without deleting them). More...

void	moveChild (int index, int destination)
	Moves a child node from index to before element at destination. More...

void	moveChild (int index, NodeList::iterator it, int destination, NodeList::iterator destIt)
	Moves a child node from index to before element at destination. More...

virtual void	beginAddChildren (PropertyNodeListenerList &listeners, int index, int count)
	Caller must ensure to keep listeners locked between beginAddChildren and endAddChildren! More...

virtual void	endAddChildren (PropertyNodeListenerList &listeners)

virtual void	beginRemoveChildren (PropertyNodeListenerList &listeners, int index, NodeList::iterator it, int count)
	Caller must ensure to keep listeners locked between beginRemoveChildren and endRemoveChildren! More...

virtual void	endRemoveChildren (PropertyNodeListenerList &listeners)

virtual void	beginMoveChildren (PropertyNodeListenerList &listeners, int index, NodeList::iterator it, int count, int destination)
	Caller must ensure to keep listeners locked between beginMoveChildren and endMoveChildren! More...

virtual void	endMoveChildren (PropertyNodeListenerList &listeners)

Protected Attributes
std::string	mID
	the unique id of the property More...

std::string	mName
	the name of the property (mostly equal to mID) More...

std::string	mComment
	the comment that is associated to the property More...

PropertyHint	mHint
	the specified property hints More...

Typename	mType
	the type of the property More...

bool	mIsReadOnly
	indicates whether the property is read-only More...

bool	mIsVolatile
	indicates whether the property is volatile More...

Detailed Description

Special derived class of PropertyNode, that allows to handle "remote properties" transparently.

Remote properties, usually are not located in the local process and hence not in the local process memory. Instead, the calls to "get" and "set" need to be delegated to the other process, where the properties are located. Therefore, this class acts as a proxy that mirrors those remote properties in the local process.

Derived classes must implement the setFromJSON() and getAsJSON() methods and delegate the calls to the remote side.

This class provides a special toTyped() method. It creates a special TypedRemotePropertyNode of the correct type. For details see TypedRemotePropertyNode. The AbstractRemotePropertyNode holds this typed property node and will destroy it automatically.

Note: This class is for internal use by the property serialization framework

Member Typedef Documentation

◆ NodeList

typedef std::vector<PropertyNode*> NodeList

inherited

Constructor & Destructor Documentation

◆ AbstractRemotePropertyNode()

AbstractRemotePropertyNode ( const PropertyNodeInfo & info )

inline

◆ ~AbstractRemotePropertyNode()

virtual ~AbstractRemotePropertyNode ( )

inlinevirtual

Member Function Documentation

◆ addChild()

void addChild	(	PropertyNode *	child,
		int	index = `-1`
	)

inline

Adds the specified property node as child node.

◆ toTyped() [1/2]

TypedPropertyNode< T > * toTyped ( )

inline

Specialized method that creates a TypedRemotePropertyNode.

◆ parent() [1/2]

virtual PropertyNode* parent ( )

inlinevirtualinherited

Returns the parent property node (or NULL, if this is a root node)

Reimplemented in TypedRemotePropertyNode< T >.

◆ parent() [2/2]

virtual const PropertyNode* parent ( ) const

inlinevirtualinherited

Returns the parent property node (or NULL, if this is a root node)

Reimplemented in TypedRemotePropertyNode< T >.

◆ children() [1/2]

virtual NodeList& children ( )

inlinevirtualinherited

Returns a vector with all child property nodes.

Reimplemented in TypedRemotePropertyNode< T >.

◆ children() [2/2]

virtual const NodeList& children ( ) const

inlinevirtualinherited

Returns a vector with all child property nodes.

Reimplemented in TypedRemotePropertyNode< T >.

◆ findChildNode() [1/4]

const PropertyNode* findChildNode	(	const std::vector< std::string > &	ids,
		std::size_t	level = `0`
	)		const

inherited

Searches for a child property node (which may also be a child of a child of a child, etc).

The "path" to the child node is specified via the provided vector, where the first item corresponds to the id of the child property, the second item corresponds to the child property of the child property, etc. The parameter 'level' specifies the item where to start within the specified vector, this parameter usually will be 0 in the first call.

◆ findChildNode() [2/4]

PropertyNode* findChildNode	(	const std::vector< std::string > &	ids,
		std::size_t	level = `0`
	)

inherited

The "path" to the child node is specified via the provided vector, where the first item corresponds to the id of the child property, the second item corresponds to the child property of the child property, etc. The parameter 'level' specifies the item where to start within the specified vector, this parameter usually will be 0 in the first call.

◆ findChildNode() [3/4]

const PropertyNode* findChildNode ( const std::string & id ) const

inherited

Searches for a child property node (which may also be a child of a child of a child, etc).

The "path" to the property is addressed via its full name. The following example

myObject.myMember.value

addresses the child property "value" of the property "myMember" of the child property "myObject".

◆ findChildNode() [4/4]

PropertyNode* findChildNode ( const std::string & id )

inherited

Searches for a child property node (which may also be a child of a child of a child, etc).

The "path" to the property is addressed via its full name. The following example

myObject.myMember.value

addresses the child property "value" of the property "myMember" of the child property "myObject".

◆ fullID()

std::string fullID ( PropertyNode * p = NULL ) const

inlineinherited

Returns the full qualified ID of this property, including the names of the parent properties separated by '.

'

If no optional parameter is specified, the name is generated up to the root of the property hierarchy. If another parent node is specified as the name is generated relative to that node.

◆ setFromJSON()

virtual void setFromJSON ( const json::Value & value )

pure virtualinherited

Sets the value of the property, where the value is described as JSON value.

Implemented in TypedRemotePropertyNode< T >, TypedPropertyNodeImpl< Accessor< Getter, Setter > >, TypedPropertyNodeImpl< T * >, and TypedPropertyNodeImpl< T >.

◆ getAsJSON()

virtual json::Value getAsJSON ( ) const

pure virtualinherited

Returns the value of the property as JSON value.

Implemented in TypedRemotePropertyNode< T >, TypedPropertyNodeImpl< Accessor< Getter, Setter > >, TypedPropertyNodeImpl< T * >, and TypedPropertyNodeImpl< T >.

◆ setFromString()

virtual void setFromString ( const std::string & value )

virtualinherited

Sets the value of the property, where the value is given as string.

◆ getAsString()

virtual std::string getAsString ( ) const

virtualinherited

Returns the value of the property as string.

◆ toTyped() [2/2]

const TypedPropertyNode< T > * toTyped ( ) const

inlineinherited

Casts this property node to a typed property node, or returns NULL if the types do not match.

◆ synchronize()

virtual void synchronize ( )

pure virtualinherited

Synchronize with the reflected object (update PropertyNode when reflected content changes)

Implemented in TypedRemotePropertyNode< T >.

◆ getRootNode() [1/2]

virtual RootPropertyNode* getRootNode ( )

virtualinherited

Reimplemented in RootPropertyNode.

◆ getRootNode() [2/2]

virtual const RootPropertyNode* getRootNode ( ) const

virtualinherited

Reimplemented in RootPropertyNode.

◆ removeChild() [1/2]

void removeChild ( int index )

inlineprotectedinherited

Removes child at specific index (without deleting it).

Notifies all registered listeners.

◆ removeChild() [2/2]

void removeChild	(	int	index,
		NodeList::iterator	it
	)

protectedinherited

Removes child at specific index (without deleting it).

Notifies all registered listeners. Use this for efficiency if iterator is already known, otherwise use removeChild(index)

◆ removeChildren() [1/2]

void removeChildren	(	int	index,
		int	count
	)

inlineprotectedinherited

Removes contiguous children, starting at index (without deleting them).

Notifies all registered listeners.

◆ removeChildren() [2/2]

void removeChildren	(	int	index,
		NodeList::iterator	it,
		int	count
	)

protectedinherited

Removes contiguous children, starting at index (without deleting them).

Notifies all registered listeners. Use this for efficiency if iterator is already known, otherwise use removeChild(index) Iterator it must be a forward iterator to the first of the removed children (at index).

◆ removeAllChildren()

void removeAllChildren ( )

protectedinherited

Removes all child nodes (without deleting them).

Notifies all registered listeners.

◆ moveChild() [1/2]

void moveChild	(	int	index,
		int	destination
	)

inlineprotectedinherited

Moves a child node from index to before element at destination.

Notifies all registered listeners.

◆ moveChild() [2/2]

void moveChild	(	int	index,
		NodeList::iterator	it,
		int	destination,
		NodeList::iterator	destIt
	)

protectedinherited

Moves a child node from index to before element at destination.

Notifies all registered listeners. Use this for efficiency if iterators are already known, otherwise use moveChild(index, destination)

◆ beginAddChildren()

virtual void beginAddChildren	(	PropertyNodeListenerList &	listeners,
		int	index,
		int	count
	)

protectedvirtualinherited

Caller must ensure to keep listeners locked between beginAddChildren and endAddChildren!

◆ endAddChildren()

virtual void endAddChildren ( PropertyNodeListenerList & listeners )

protectedvirtualinherited

◆ beginRemoveChildren()

virtual void beginRemoveChildren	(	PropertyNodeListenerList &	listeners,
		int	index,
		NodeList::iterator	it,
		int	count
	)

protectedvirtualinherited

Caller must ensure to keep listeners locked between beginRemoveChildren and endRemoveChildren!

◆ endRemoveChildren()

virtual void endRemoveChildren ( PropertyNodeListenerList & listeners )

protectedvirtualinherited

◆ beginMoveChildren()

virtual void beginMoveChildren	(	PropertyNodeListenerList &	listeners,
		int	index,
		NodeList::iterator	it,
		int	count,
		int	destination
	)

protectedvirtualinherited

Caller must ensure to keep listeners locked between beginMoveChildren and endMoveChildren!

◆ endMoveChildren()

virtual void endMoveChildren ( PropertyNodeListenerList & listeners )

protectedvirtualinherited

◆ reflectCommon()

void reflectCommon ( Reflector & r )

inlineinherited

◆ reflectRead()

void reflectRead ( Reflector & r )

inlineinherited

◆ reflectWrite()

void reflectWrite ( Reflector & r )

inlineinherited

◆ id()

const std::string& id ( ) const

inlineinherited

Returns the unique id of this property.

◆ name()

const std::string& name ( ) const

inlineinherited

Returns the name of this property as specified in the reflect() method.

◆ comment()

const std::string& comment ( ) const

inlineinherited

Returns the comment that is associated with this property.

◆ type()

const Typename& type ( ) const

inlineinherited

Returns the type of this property as Typename.

◆ getHint()

T getHint	(	const std::string &	attribute,
		const T &	defaultValue = `T()`
	)		const

inlineinherited

Returns the specified value for the given property hint attribute.

If no such attribute is set in this hint, then the defaultValue is returned.

◆ hasHint()

bool hasHint ( const std::string & attribute ) const

inlineinherited

Returns true if a hint with the specified attribute exists.

◆ isReadOnly()

bool isReadOnly ( ) const

inlineinherited

Returns true, if this property is read-only and hence, can not be modified.

◆ isVolatile()

bool isVolatile ( ) const

inlineinherited

Returns true, if this property is volatile and hence, must be locked for access.

◆ setName()

void setName ( const std::string & name )

inlineinherited

For internal use by PropertySerializer only: Overrides the name of the property.

Member Data Documentation

◆ mID

std::string mID

protectedinherited

the unique id of the property

◆ mName

std::string mName

protectedinherited

the name of the property (mostly equal to mID)

◆ mComment

std::string mComment

protectedinherited

the comment that is associated to the property

◆ mHint

PropertyHint mHint

protectedinherited

the specified property hints

◆ mType

Typename mType

protectedinherited

the type of the property

◆ mIsReadOnly

bool mIsReadOnly

protectedinherited

indicates whether the property is read-only

◆ mIsVolatile

bool mIsVolatile

protectedinherited

indicates whether the property is volatile

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

base/include/serialization/PropertyNode.h

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

◆ NodeList

Constructor & Destructor Documentation

◆ AbstractRemotePropertyNode()

◆ ~AbstractRemotePropertyNode()

Member Function Documentation

◆ addChild()

◆ toTyped() [1/2]

◆ parent() [1/2]

◆ parent() [2/2]

◆ children() [1/2]

◆ children() [2/2]

◆ findChildNode() [1/4]

◆ findChildNode() [2/4]

◆ findChildNode() [3/4]

◆ findChildNode() [4/4]

◆ fullID()

◆ setFromJSON()

◆ getAsJSON()

◆ setFromString()

◆ getAsString()

◆ toTyped() [2/2]

◆ synchronize()

◆ getRootNode() [1/2]

◆ getRootNode() [2/2]

◆ removeChild() [1/2]

◆ removeChild() [2/2]

◆ removeChildren() [1/2]

◆ removeChildren() [2/2]

◆ removeAllChildren()

◆ moveChild() [1/2]

◆ moveChild() [2/2]

◆ beginAddChildren()

◆ endAddChildren()

◆ beginRemoveChildren()

◆ endRemoveChildren()

◆ beginMoveChildren()

◆ endMoveChildren()

◆ reflectCommon()

◆ reflectRead()

◆ reflectWrite()

◆ id()

◆ name()

◆ comment()

◆ type()

◆ getHint()

◆ hasHint()

◆ isReadOnly()

◆ isVolatile()

◆ setName()

Member Data Documentation

◆ mID

◆ mName

◆ mComment

◆ mHint

◆ mType

◆ mIsReadOnly

◆ mIsVolatile