org.omg.CosNaming

Interface NamingContextOperations

All Known Subinterfaces:

NamingContext, NamingContextExt, NamingContextExtOperations

All Known Implementing Classes:

_NamingContextExtImplBase, _NamingContextExtStub, _NamingContextImplBase, _NamingContextStub, NamingContextExtPOA, NamingContextPOA

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:

NamingContextExtOperations

Method Summary

Methods

Modifier and Type	Method and Description
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	bind(NameComponent[] a_name, Object an_object) Gives the object a name, valid in this 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_context(NameComponent[] a_name, NamingContext a_context) Names or renames the child context.
void	rebind(NameComponent[] a_name, Object an_object) Names or renames the object.
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

void bind(NameComponent[] a_name,
        Object an_object)
          throws NotFound,
                 CannotProceed,
                 InvalidName,
                 AlreadyBound

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.

NotFound

CannotProceed

bind_context

void bind_context(NameComponent[] a_name,
                NamingContext a_context)
                  throws NotFound,
                         CannotProceed,
                         InvalidName,
                         AlreadyBound

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.

NotFound

CannotProceed

InvalidName

bind_new_context

NamingContext bind_new_context(NameComponent[] a_name)
                               throws NotFound,
                                      AlreadyBound,
                                      CannotProceed,
                                      InvalidName

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.

NotFound

CannotProceed

destroy

void destroy()
             throws NotEmpty

Destroy this context (must be empty).

Throws:

NotEmpty - if the context being destroyed is not empty.

list

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

NamingContext new_context()

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

rebind

void rebind(NameComponent[] a_name,
          Object an_object)
            throws NotFound,
                   CannotProceed,
                   InvalidName

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.

NotFound

CannotProceed

rebind_context

void rebind_context(NameComponent[] a_name,
                  NamingContext a_context)
                    throws NotFound,
                           CannotProceed,
                           InvalidName

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.

NotFound

CannotProceed

resolve

Object resolve(NameComponent[] a_name)
               throws NotFound,
                      CannotProceed,
                      InvalidName

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.

CannotProceed

unbind

void unbind(NameComponent[] a_name)
            throws NotFound,
                   CannotProceed,
                   InvalidName

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.

NotFound

CannotProceed