org.omg.CosNaming

Interface NamingContext

public interface NamingContext extends NamingContextOperations, Object, IDLEntity

The interface for the naming context. The naming context can store (bound) and retrieve (resolve) the named objects or named child contexts. These operations are defined in a separate interface.

Method Summary
void	bind(NameComponent[] a_name, Object an_object) Gives the object a name, valid in this context.
void	bind_context(NameComponent[] a_name, NamingContext a_context) Gives a child context name, valid in this context.
NamingContext	bind_new_context(NameComponent[] a_name) Create a new context and give it a given name (bound it) in the current context.
void	destroy() Destroy this context (must be empty).
void	list(int amount, BindingListHolder a_list, BindingIteratorHolder an_iter) Iterate over all bindings, defined in this namind context.
NamingContext	new_context() Creates a new naming context, not bound to any name.
void	rebind(NameComponent[] a_name, Object an_object) Names or renames the object.
void	rebind_context(NameComponent[] a_name, NamingContext a_context) Names or renames the child context.
Object	resolve(NameComponent[] a_name) Get the object, bound to the specified name in this context.
void	unbind(NameComponent[] a_name) Removes the name from the binding context.

Method Detail

bind

public void bind(NameComponent[] a_name, Object an_object)

Gives the object a name, valid in this context.

Parameters: a_name the name, being given to the object. an_object the object, being named.

Throws: AlreadyBound if the object is already named in this context. InvalidName if the name has zero length or otherwise invalid.

UNKNOWN: since 1.3 this method has moved into NamingContextOperations.

bind_context

public void bind_context(NameComponent[] a_name, NamingContext a_context)

Gives a child context name, valid in this context.

Parameters: a_name the name, being given to the child context. a_context the child context being named.

Throws: AlreadyBound if the child context is already named in the current context.

UNKNOWN: since 1.3 this method has moved into NamingContextOperations.

bind_new_context

public NamingContext bind_new_context(NameComponent[] a_name)

Create a new context and give it a given name (bound it) in the current context.

Parameters: a_name the name being given to the new context.

Returns: the newly created context.

Throws: AlreadyBound if the name is already in use. InvalidName if the name has zero length or otherwise invalid.

UNKNOWN: since 1.3 this method has moved into NamingContextOperations.

destroy

public void destroy()

Destroy this context (must be empty).

Throws: NotEmpty if the context being destroyed is not empty.

UNKNOWN: since 1.3 this method has moved into NamingContextOperations.

list

public void list(int amount, BindingListHolder a_list, BindingIteratorHolder an_iter)

Iterate over all bindings, defined in this namind context.

Parameters: amount the maximal number of context to return in the holder a_list. The remaining bindings are accessible via iterator an_iter. If the parameter amount is zero, all bindings are accessed only via this iterator. a_list the holder, where the returned bindigs are stored. an_iter the iterator that can be used to access the remaining bindings.

UNKNOWN: since 1.3 this method has moved into NamingContextOperations.

new_context

public NamingContext new_context()

Creates a new naming context, not bound to any name.

UNKNOWN: since 1.3 this method has moved into NamingContextOperations.

rebind

public void rebind(NameComponent[] a_name, Object an_object)

Names or renames the object.

Parameters: a_name the new name, being given to the object. If the object is already named in this context, it is renamed. an_object the object, being named.

Throws: InvalidName if the name has zero length or otherwise invalid.

UNKNOWN: since 1.3 this method has moved into NamingContextOperations.

rebind_context

public void rebind_context(NameComponent[] a_name, NamingContext a_context)

Names or renames the child context. If the child context is already named in the current context, it is renamed.

Parameters: a_name the name, being given to the child context. a_context the child context being named.

Throws: InvalidName if the name has zero length or otherwise invalid.

UNKNOWN: since 1.3 this method has moved into NamingContextOperations.

resolve

public Object resolve(NameComponent[] a_name)

Get the object, bound to the specified name in this context.

Parameters: a_name the object name.

Returns: the object, matching this name. The client usually casts or narrows (using the helper) the returned value to the more specific type.

Throws: NotFound InvalidName if the name has zero length or otherwise invalid.

UNKNOWN: since 1.3 this method has moved into NamingContextOperations.

unbind

public void unbind(NameComponent[] a_name)

Removes the name from the binding context.

Parameters: a_name a name to remove.

Throws: InvalidName if the name has zero length or otherwise invalid.

UNKNOWN: since 1.3 this method has moved into NamingContextOperations.