ACE_Remote_Name_Space Class Reference

Maintaining accesses Remote Name Server Database. Allows to add NameBindings, change them, remove them and resolve NameBindings. More...

#include <Remote_Name_Space.h>

Inheritance diagram for ACE_Remote_Name_Space:

[legend]

Collaboration diagram for ACE_Remote_Name_Space:

[legend]

List of all members.

Public Member Functions
	ACE_Remote_Name_Space (void)
	"Do-nothing" constructor.
	ACE_Remote_Name_Space (const ACE_TCHAR *hostname, u_short port)
int	open (const ACE_TCHAR *servername, u_short port)
	~ACE_Remote_Name_Space (void)
virtual int	bind (const ACE_NS_WString &name_in, const ACE_NS_WString &value_in, const char *type_in="")
	Bind a new name to a naming context (Wide character strings).
virtual int	rebind (const ACE_NS_WString &name_in, const ACE_NS_WString &value_in, const char *type_in="")
virtual int	unbind (const ACE_NS_WString &name_in)
virtual int	resolve (const ACE_NS_WString &name_in, ACE_NS_WString &value_out, char *&type_out)
virtual int	list_names (ACE_WSTRING_SET &set_out, const ACE_NS_WString &pattern_in)
virtual int	list_values (ACE_WSTRING_SET &set_out, const ACE_NS_WString &pattern_in)
virtual int	list_types (ACE_WSTRING_SET &set_out, const ACE_NS_WString &pattern_in)
virtual int	list_name_entries (ACE_BINDING_SET &set, const ACE_NS_WString &pattern)
virtual int	list_value_entries (ACE_BINDING_SET &set, const ACE_NS_WString &pattern)
virtual int	list_type_entries (ACE_BINDING_SET &set, const ACE_NS_WString &pattern)
virtual void	dump (void) const
	Dump the state of the object.
Private Attributes
ACE_Name_Proxy	ns_proxy_
	Interface to Name server process for NET_LOCAL namespace.

---

Detailed Description

Maintaining accesses Remote Name Server Database. Allows to add NameBindings, change them, remove them and resolve NameBindings.

Manages a Naming Service for a remote name space which includes bindings for net_local naming context. All strings are stored in wide character format. A Name Binding consists of a name (that's the key), a value string and an optional type string (no wide chars).

---

Constructor & Destructor Documentation

ACE_Remote_Name_Space::ACE_Remote_Name_Space

(

void

)

"Do-nothing" constructor.

ACE_Remote_Name_Space::ACE_Remote_Name_Space	(	const ACE_TCHAR *	hostname,
		u_short	port
	)

Specifies the scope of this namespace, opens and memory-maps the associated file (if accessible) or contacts the dedicated name server process for NET_LOCAL namespace.

ACE_Remote_Name_Space::~ACE_Remote_Name_Space

(

void

)

destructor, do some cleanup :TBD: last dtor should "compress" file

---

Member Function Documentation

ACE_BEGIN_VERSIONED_NAMESPACE_DECL int ACE_Remote_Name_Space::open	(	const ACE_TCHAR *	servername,
		u_short	port
	)

Specifies the scope of this namespace, opens and memory-maps the associated file (if accessible) or contacts the dedicated name server process for NET_LOCAL namespace.

int ACE_Remote_Name_Space::bind	(	const ACE_NS_WString &	name_in,
		const ACE_NS_WString &	value_in,
		const char *	type_in = ""
	)			[virtual]

Bind a new name to a naming context (Wide character strings).

Implements ACE_Name_Space.

int ACE_Remote_Name_Space::rebind	(	const ACE_NS_WString &	name_in,
		const ACE_NS_WString &	value_in,
		const char *	type_in = ""
	)			[virtual]

Overwrite the value or type of an existing name in a ACE_Remote_Name_Space or bind a new name to the context, if it didn't exist yet. (Wide charcter strings interface).

Implements ACE_Name_Space.

int ACE_Remote_Name_Space::unbind

(

const ACE_NS_WString &

name_in

)

[virtual]

Delete a name from a ACE_Remote_Name_Space (Wide charcter strings Interface).

Implements ACE_Name_Space.

int ACE_Remote_Name_Space::resolve	(	const ACE_NS_WString &	name_in,
		ACE_NS_WString &	value_out,
		char *&	type_out
	)			[virtual]

Get value and type of a given name binding (Wide chars). The caller is responsible for deleting both <value_out> and <type_out>!

Implements ACE_Name_Space.

int ACE_Remote_Name_Space::list_names	(	ACE_WSTRING_SET &	set_out,
		const ACE_NS_WString &	pattern_in
	)			[virtual]

Get a set of names matching a specified pattern (wchars). Matching means the names must begin with the pattern string.

Implements ACE_Name_Space.

int ACE_Remote_Name_Space::list_values	(	ACE_WSTRING_SET &	set_out,
		const ACE_NS_WString &	pattern_in
	)			[virtual]

Get a set of values matching a specified pattern (wchars). Matching means the values must begin with the pattern string.

Implements ACE_Name_Space.

int ACE_Remote_Name_Space::list_types	(	ACE_WSTRING_SET &	set_out,
		const ACE_NS_WString &	pattern_in
	)			[virtual]

Get a set of types matching a specified pattern (wchars). Matching means the types must begin with the pattern string.

Implements ACE_Name_Space.

int ACE_Remote_Name_Space::list_name_entries	(	ACE_BINDING_SET &	set,
		const ACE_NS_WString &	pattern
	)			[virtual]

Get a set of names matching a specified pattern (wchars). Matching means the names must begin with the pattern string. Returns the complete binding associated each pattern match.

Implements ACE_Name_Space.

int ACE_Remote_Name_Space::list_value_entries	(	ACE_BINDING_SET &	set,
		const ACE_NS_WString &	pattern
	)			[virtual]

Get a set of values matching a specified pattern (wchars). Matching means the values must begin with the pattern string. Returns the complete binding associated each pattern match.

Implements ACE_Name_Space.

int ACE_Remote_Name_Space::list_type_entries	(	ACE_BINDING_SET &	set,
		const ACE_NS_WString &	pattern
	)			[virtual]

Get a set of types matching a specified pattern (wchars). Matching means the types must begin with the pattern string. Returns the complete binding associated each pattern match.

Implements ACE_Name_Space.

void ACE_Remote_Name_Space::dump

(

void

)

const [virtual]

Dump the state of the object.

Implements ACE_Name_Space.

---

Member Data Documentation

ACE_Name_Proxy ACE_Remote_Name_Space::ns_proxy_ [private]

Interface to Name server process for NET_LOCAL namespace.

---

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

• Remote_Name_Space.h
• Remote_Name_Space.cpp