CosNaming::NamingContextExt Interface Reference

import <CosNaming.idl;

Inheritance diagram for CosNaming::NamingContextExt:

Collaboration diagram for CosNaming::NamingContextExt:

Classes
exception	InvalidAddress
	Indicates that the URL address is invalid. More...

Public Types
typedef string	StringName
	Stringified form of a Name.
typedef string	Address
	URL address such as myhost.xyz.com.
typedef string	URLString
	Stringified form of a URL address componoent.
Public Types inherited from CosNaming::NamingContext
enum	NotFoundReason { missing_node , not_context , not_object }

Public Member Functions
StringName	to_string (in Name n) raises (InvalidName)
Name	to_name (in StringName sn) raises (InvalidName)
URLString	to_url (in Address addr, in StringName sn) raises (InvalidAddress, InvalidName)
Object	resolve_str (in StringName n) raises (NotFound, CannotProceed, InvalidName)
Public Member Functions inherited from CosNaming::NamingContext
void	bind (in Name n, in Object obj) raises (NotFound, CannotProceed, InvalidName, AlreadyBound)
void	rebind (in Name n, in Object obj) raises (NotFound, CannotProceed, InvalidName)
void	bind_context (in Name n, in NamingContext nc) raises (NotFound, CannotProceed, InvalidName, AlreadyBound)
void	rebind_context (in Name n, in NamingContext nc) raises (NotFound, CannotProceed, InvalidName)
Object	resolve (in Name n) raises (NotFound, CannotProceed, InvalidName)
void	unbind (in Name n) raises (NotFound, CannotProceed, InvalidName)
NamingContext	new_context ()
NamingContext	bind_new_context (in Name n) raises (NotFound, AlreadyBound, CannotProceed, InvalidName)
void	destroy () raises (NotEmpty)
void	list (in unsigned long how_many, out BindingList bl, out BindingIterator bi)

Detailed Description

Interface for providing operations required to use URLs and stringified names.

Reference to: Document orbos/98-10-11 (Interoperable Naming Joint Revised Submission) Joint Submission by BEA Systems, DSTC, IONA, and Inprise

Member Typedef Documentation

Address

typedef string CosNaming::NamingContextExt::Address

URL address such as myhost.xyz.com.

StringName

typedef string CosNaming::NamingContextExt::StringName

Stringified form of a Name.

URLString

typedef string CosNaming::NamingContextExt::URLString

Stringified form of a URL address componoent.

Member Function Documentation

resolve_str()

Object CosNaming::NamingContextExt::resolve_str	(	in StringName	n	)
raises	(	NotFound,
		CannotProceed,
		InvalidName )

This is similar to resolve as in the CosNaming::NamingContext interface, except that it accepts a stringified name as an argument instead of a Name.

to_name()

Name CosNaming::NamingContextExt::to_name	(	in StringName	sn	)
raises	(	InvalidName )

This operation returns a Name. If the input stringified name is syntactically malformed or violates an implementation limit, an InvalidName exception is raised.

to_string()

StringName CosNaming::NamingContextExt::to_string	(	in Name	n	)
raises	(	InvalidName )

This operation accepts a Name and returns a stringified name. If the name is invalid, an InvalidName exception is raised.

to_url()

URLString CosNaming::NamingContextExt::to_url	(	in Address	addr,
		in StringName	sn )
raises	(	InvalidAddress,
		InvalidName )

It performs any escapes necessary on the stringified name and returns a fully formed URL string. An exception is raised if either the protocol or name parameters are invalid.

---

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

• CosNaming.idl