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
 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