An abstract name space for ports. More...

#include <yarp/os/NameSpace.h>

Inheritance diagram for yarp::os::NameSpace:

Public Member Functions
virtual	~NameSpace ()
	Destructor.

virtual bool	checkNetwork ()
	Check if a name space is available.

virtual bool	checkNetwork (double timeout)
	Check if a name space is available, with a timeout on any network operations needed.

virtual Contact	getNameServerContact () const =0
	Get an address for a name server that manages the name space, if available.

virtual std::string	getNameServerName () const
	Get the port name of a name server that manages the name space, if available.

virtual Contact	queryName (const std::string &name)=0
	Map from port name to contact information.

virtual Contact	registerName (const std::string &name)=0
	Record contact information to tie to a port name.

virtual Contact	registerContact (const Contact &contact)=0
	Record contact information (should include a port name).

virtual Contact	unregisterName (const std::string &name)=0
	Disassociate contact information from a port name.

virtual Contact	unregisterContact (const Contact &contact)=0
	Disassociate contact information (should include a port name).

virtual Contact	registerAdvanced (const Contact &contact, NameStore *store)
	Record contact information, with access to the contact information of other ports for cross-referencing.

virtual Contact	unregisterAdvanced (const std::string &name, NameStore *store)
	Remove contact information, with access to the contact information of other ports for cross-referencing.

virtual bool	setProperty (const std::string &name, const std::string &key, const Value &value)=0
	Associate a key/value pair with a named port.

virtual Value *	getProperty (const std::string &name, const std::string &key)=0
	Get the value of a named key from a named port.

virtual bool	connectPortToTopic (const Contact &src, const Contact &dest, const ContactStyle &style)=0
	Publish a port to a topic.

virtual bool	connectTopicToPort (const Contact &src, const Contact &dest, const ContactStyle &style)=0
	Subscribe a port to a topic.

virtual bool	disconnectPortFromTopic (const Contact &src, const Contact &dest, const ContactStyle &style)=0
	Stop publishing a port to a topic.

virtual bool	disconnectTopicFromPort (const Contact &src, const Contact &dest, const ContactStyle &style)=0
	Stop subscribing a port to a topic.

virtual bool	connectPortToPortPersistently (const Contact &src, const Contact &dest, const ContactStyle &style)=0
	Connect two ports with persistence.

virtual bool	disconnectPortToPortPersistently (const Contact &src, const Contact &dest, const ContactStyle &style)=0
	Disconnect two ports, removing any persistence.

virtual bool	localOnly () const =0
	Check if the NameSpace is only valid for the current process ("local").

virtual bool	usesCentralServer () const =0
	Check if a central server is involved in managing the NameSpace.

virtual bool	serverAllocatesPortNumbers () const =0
	Check if a central server is responsible for allocating port numbers, or if this should be left up to the operating system.

virtual bool	connectionHasNameOfEndpoints () const =0
	When connections are made involving ports managed by this NameSpace do the ports involved end up knowing the names of their counterparties?

virtual Contact	detectNameServer (bool useDetectedServer, bool &scanNeeded, bool &serverUsed)=0
	Find a name server for this NameSpace, if applicable.

virtual bool	writeToNameServer (PortWriter &cmd, PortReader &reply, const ContactStyle &style)=0
	Write a message to a name server for this NameSpace, if applicable.

Detailed Description

An abstract name space for ports.

This collects all the services we may ask of a name server, to simplify plugging in alternate implementations.

Definition at line 21 of file NameSpace.h.

Constructor & Destructor Documentation

◆ ~NameSpace()

NameSpace::~NameSpace ( )

virtualdefault

Destructor.

Member Function Documentation

◆ checkNetwork() [1/2]

bool NameSpace::checkNetwork ( )

virtual

Check if a name space is available.

Returns: true if the name space is available, false otherwise.

Definition at line 17 of file NameSpace.cpp.

◆ checkNetwork() [2/2]

bool NameSpace::checkNetwork ( double timeout )

virtual

Check if a name space is available, with a timeout on any network operations needed.

If the timeout occurs, we assume the name space is not available.

Parameters

[in] timeout time in seconds to wait for a response in any network operation needed.

Returns: true if the name server is available in the specified time, false otherwise.

Definition at line 40 of file NameSpace.cpp.

◆ connectionHasNameOfEndpoints()

virtual bool yarp::os::NameSpace::connectionHasNameOfEndpoints ( ) const

pure virtual

When connections are made involving ports managed by this NameSpace do the ports involved end up knowing the names of their counterparties?

Implemented in yarp::os::MultiNameSpace, yarp::os::RosNameSpace, and yarp::os::YarpNameSpace.

◆ connectPortToPortPersistently()

virtual bool yarp::os::NameSpace::connectPortToPortPersistently	(	const Contact &	src,
		const Contact &	dest,
		const ContactStyle &	style
	)

pure virtual

Connect two ports with persistence.

Implemented in yarp::os::MultiNameSpace, yarp::os::RosNameSpace, and yarp::os::YarpNameSpace.

◆ connectPortToTopic()

virtual bool yarp::os::NameSpace::connectPortToTopic	(	const Contact &	src,
		const Contact &	dest,
		const ContactStyle &	style
	)

pure virtual

Publish a port to a topic.

Implemented in yarp::os::MultiNameSpace, yarp::os::RosNameSpace, and yarp::os::YarpNameSpace.

◆ connectTopicToPort()

virtual bool yarp::os::NameSpace::connectTopicToPort	(	const Contact &	src,
		const Contact &	dest,
		const ContactStyle &	style
	)

pure virtual

Subscribe a port to a topic.

Implemented in yarp::os::MultiNameSpace, yarp::os::RosNameSpace, and yarp::os::YarpNameSpace.

◆ detectNameServer()

virtual Contact yarp::os::NameSpace::detectNameServer	(	bool	useDetectedServer,
		bool &	scanNeeded,
		bool &	serverUsed
	)

pure virtual

Find a name server for this NameSpace, if applicable.

Parameters

useDetectedServer	use any server found for future queries.
scanNeeded	set to true if a search was needed, rather than finding a name server based on cached hints.
serverUsed	set to true if a server was found and marked for use in future queries.

Implemented in yarp::os::MultiNameSpace, yarp::os::RosNameSpace, and yarp::os::YarpNameSpace.

◆ disconnectPortFromTopic()

virtual bool yarp::os::NameSpace::disconnectPortFromTopic	(	const Contact &	src,
		const Contact &	dest,
		const ContactStyle &	style
	)

pure virtual

Stop publishing a port to a topic.

Implemented in yarp::os::MultiNameSpace, yarp::os::RosNameSpace, and yarp::os::YarpNameSpace.

◆ disconnectPortToPortPersistently()

virtual bool yarp::os::NameSpace::disconnectPortToPortPersistently	(	const Contact &	src,
		const Contact &	dest,
		const ContactStyle &	style
	)

pure virtual

Disconnect two ports, removing any persistence.

Implemented in yarp::os::MultiNameSpace, yarp::os::RosNameSpace, and yarp::os::YarpNameSpace.

◆ disconnectTopicFromPort()

virtual bool yarp::os::NameSpace::disconnectTopicFromPort	(	const Contact &	src,
		const Contact &	dest,
		const ContactStyle &	style
	)

pure virtual

Stop subscribing a port to a topic.

Implemented in yarp::os::MultiNameSpace, yarp::os::RosNameSpace, and yarp::os::YarpNameSpace.

◆ getNameServerContact()

virtual Contact yarp::os::NameSpace::getNameServerContact ( ) const

pure virtual

Get an address for a name server that manages the name space, if available.

Implemented in yarp::os::MultiNameSpace, yarp::os::RosNameSpace, yarp::os::YarpNameSpace, and yarp::os::YarpDummyNameSpace.

◆ getNameServerName()

std::string NameSpace::getNameServerName ( ) const

virtual

Get the port name of a name server that manages the name space, if available.

Definition at line 64 of file NameSpace.cpp.

◆ getProperty()

virtual Value * yarp::os::NameSpace::getProperty	(	const std::string &	name,
		const std::string &	key
	)

pure virtual

Get the value of a named key from a named port.

Returns: nullptr if no value was set for the named key.

Implemented in yarp::os::MultiNameSpace, yarp::os::RosNameSpace, and yarp::os::YarpNameSpace.

◆ localOnly()

virtual bool yarp::os::NameSpace::localOnly ( ) const

pure virtual

Check if the NameSpace is only valid for the current process ("local").

Implemented in yarp::os::MultiNameSpace, yarp::os::RosNameSpace, yarp::os::YarpNameSpace, and yarp::os::YarpDummyNameSpace.

◆ queryName()

virtual Contact yarp::os::NameSpace::queryName ( const std::string & name )

pure virtual

Map from port name to contact information.

Implemented in yarp::os::MultiNameSpace, yarp::os::RosNameSpace, and yarp::os::YarpNameSpace.

◆ registerAdvanced()

virtual Contact yarp::os::NameSpace::registerAdvanced	(	const Contact &	contact,
		NameStore *	store
	)

inlinevirtual

Record contact information, with access to the contact information of other ports for cross-referencing.

Parameters

contact	the contact information to record
store	an interface to port information as presented via the YARP client API (as opposed to what a single NameSpace would have access to).

Reimplemented in yarp::os::RosNameSpace.

Definition at line 92 of file NameSpace.h.

◆ registerContact()

virtual Contact yarp::os::NameSpace::registerContact ( const Contact & contact )

pure virtual

Record contact information (should include a port name).

Implemented in yarp::os::MultiNameSpace, yarp::os::RosNameSpace, and yarp::os::YarpNameSpace.

◆ registerName()

virtual Contact yarp::os::NameSpace::registerName ( const std::string & name )

pure virtual

Record contact information to tie to a port name.

Implemented in yarp::os::MultiNameSpace, yarp::os::RosNameSpace, and yarp::os::YarpNameSpace.

◆ serverAllocatesPortNumbers()

virtual bool yarp::os::NameSpace::serverAllocatesPortNumbers ( ) const

pure virtual

Check if a central server is responsible for allocating port numbers, or if this should be left up to the operating system.

Implemented in yarp::os::MultiNameSpace, yarp::os::RosNameSpace, and yarp::os::YarpNameSpace.

◆ setProperty()

virtual bool yarp::os::NameSpace::setProperty	(	const std::string &	name,
		const std::string &	key,
		const Value &	value
	)

pure virtual

Associate a key/value pair with a named port.

Implemented in yarp::os::MultiNameSpace, yarp::os::RosNameSpace, and yarp::os::YarpNameSpace.

◆ unregisterAdvanced()

virtual Contact yarp::os::NameSpace::unregisterAdvanced	(	const std::string &	name,
		NameStore *	store
	)

inlinevirtual

Remove contact information, with access to the contact information of other ports for cross-referencing.

Reimplemented in yarp::os::RosNameSpace.

Definition at line 103 of file NameSpace.h.

◆ unregisterContact()

virtual Contact yarp::os::NameSpace::unregisterContact ( const Contact & contact )

pure virtual

Disassociate contact information (should include a port name).

Implemented in yarp::os::MultiNameSpace, yarp::os::RosNameSpace, and yarp::os::YarpNameSpace.

◆ unregisterName()

virtual Contact yarp::os::NameSpace::unregisterName ( const std::string & name )

pure virtual

Disassociate contact information from a port name.

Implemented in yarp::os::MultiNameSpace, yarp::os::RosNameSpace, and yarp::os::YarpNameSpace.

◆ usesCentralServer()

virtual bool yarp::os::NameSpace::usesCentralServer ( ) const

pure virtual

Check if a central server is involved in managing the NameSpace.

Implemented in yarp::os::MultiNameSpace, yarp::os::RosNameSpace, and yarp::os::YarpNameSpace.

◆ writeToNameServer()

virtual bool yarp::os::NameSpace::writeToNameServer	(	PortWriter &	cmd,
		PortReader &	reply,
		const ContactStyle &	style
	)

pure virtual

Write a message to a name server for this NameSpace, if applicable.

Messages are name-server-specific.

Implemented in yarp::os::MultiNameSpace, yarp::os::RosNameSpace, and yarp::os::YarpNameSpace.

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

src/libYARP_os/src/yarp/os/NameSpace.h
src/libYARP_os/src/yarp/os/NameSpace.cpp

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ ~NameSpace()

Member Function Documentation

◆ checkNetwork() [1/2]

◆ checkNetwork() [2/2]

◆ connectionHasNameOfEndpoints()

◆ connectPortToPortPersistently()

◆ connectPortToTopic()

◆ connectTopicToPort()

◆ detectNameServer()

◆ disconnectPortFromTopic()

◆ disconnectPortToPortPersistently()

◆ disconnectTopicFromPort()

◆ getNameServerContact()

◆ getNameServerName()

◆ getProperty()

◆ localOnly()

◆ queryName()

◆ registerAdvanced()

◆ registerContact()

◆ registerName()

◆ serverAllocatesPortNumbers()

◆ setProperty()

◆ unregisterAdvanced()

◆ unregisterContact()

◆ unregisterName()

◆ usesCentralServer()

◆ writeToNameServer()