org.omg.CosNaming

Interface NamingContextOperations

public interface NamingContextOperations

The naming context operations. The naming context can store (bound) and retrieve (resolve) the named objects or named child contexts.

See Also:

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.

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.

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.

destroy

public void destroy()

Destroy this context (must be empty).

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

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.

new_context

public NamingContext new_context()

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

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.

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.

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.

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.