org.omg.CosNaming
Interface NamingContextOperations

public interface NamingContextOperations

Method Summary

void	bind_context(NameComponent[] n, NamingContext nc) Names an object that is a naming context.
NamingContext	bind_new_context(NameComponent[] n) Create a new context and bind it with the given name.
void	bind(NameComponent[] n, Object obj) Creates a binding of a name and a CORBA Object in a Naming Context.
void	destroy() Destroy the context.
void	list(int how_many, BindingListHolder bl, BindingIteratorHolder bi) List atmost how_many number of bindings.
NamingContext	new_context() Create a new Context.
void	rebind_context(NameComponent[] n, NamingContext nc) Creates a binding of a name and a naming context in the naming context even if the name is already bound in the context.
void	rebind(NameComponent[] n, Object obj) Creates a binding of a name and an object in the naming context even if the name is already bound in the context.
Object	resolve(NameComponent[] n) The resolve operation is the process of retrieving an object bound to a name in a given context.
void	unbind(NameComponent[] n) The unbind operation removes a binding from a Naming Context.

Method Detail

bind

public void bind(NameComponent[] n,
                 Object obj)
          throws NotFound,
                 CannotProceed,
                 InvalidName,
                 AlreadyBound

Creates a binding of a name and a CORBA Object in a Naming Context. Naming contexts that are bound using bind do not participate in name resolution when compound names are passed to be resolved.

Throws:

NotFound

CannotProceed

InvalidName

AlreadyBound

bind_context

public void bind_context(NameComponent[] n,
                         NamingContext nc)
                  throws NotFound,
                         CannotProceed,
                         InvalidName,
                         AlreadyBound

Names an object that is a naming context. Naming contexts that are bound using bind_context() participate in name resolution when compound names are passed to be resolved.

Throws:

NotFound

CannotProceed

InvalidName

AlreadyBound

rebind

public void rebind(NameComponent[] n,
                   Object obj)
            throws NotFound,
                   CannotProceed,
                   InvalidName

Creates a binding of a name and an object in the naming context even if the name is already bound in the context. Naming contexts that are bound using rebind do not participate in name resolution when compound names are passed to be resolved.

Throws:

NotFound

CannotProceed

InvalidName

rebind_context

public void rebind_context(NameComponent[] n,
                           NamingContext nc)
                    throws NotFound,
                           CannotProceed,
                           InvalidName

Creates a binding of a name and a naming context in the naming context even if the name is already bound in the context. Naming contexts that are bound using rebind_context() participate in name resolution when compound names are passed to be resolved.

Throws:

NotFound

CannotProceed

InvalidName

resolve

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

The resolve operation is the process of retrieving an object bound to a name in a given context. The given name must exactly match the bound name. The naming service does not return the type of the object. Clients are responsible for "narrowing" the object to the appropriate type. That is, clients typically cast the returned object from Object to a more specialized interface.

Throws:

NotFound

CannotProceed

InvalidName

unbind

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

The unbind operation removes a binding from a Naming Context.

Throws:

NotFound

CannotProceed

InvalidName

list

public void list(int how_many,
                 BindingListHolder bl,
                 BindingIteratorHolder bi)

List atmost how_many number of bindings. The bindings are put in the BindingList. If there are more bindings, then the BindingIterator can be used to further list them.

new_context

public NamingContext new_context()

Create a new Context.

bind_new_context

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

Create a new context and bind it with the given name.

Throws:

NotFound

AlreadyBound

CannotProceed

InvalidName

destroy

public void destroy()
             throws NotEmpty

Destroy the context. If the context is not empty NotEmpty exception is thrown.

Throws:

NotEmpty