org.omg.CosNaming
Class _NamingContextStub

java.lang.Object
  extended by org.omg.CORBA.portable.ObjectImpl
      extended by org.omg.CosNaming._NamingContextStub
All Implemented Interfaces:
Serializable, Object, IDLEntity, NamingContext, NamingContextOperations
Direct Known Subclasses:
_NamingContextExtStub

public class _NamingContextStub
extends ObjectImpl
implements NamingContext

The naming context stub (proxy), used on the client side. The NamingContext methods contain the code for remote invocaton.

See Also:
Serialized Form

Constructor Summary
_NamingContextStub()
          Create the naming context stub.
 
Method Summary
 String[] _ids()
          Return the array of repository ids for this object.
 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.
 
Methods inherited from class org.omg.CORBA.portable.ObjectImpl
_create_request, _create_request, _duplicate, _get_delegate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _invoke, _is_a, _is_equivalent, _is_local, _non_existent, _orb, _release, _releaseReply, _request, _request, _servant_postinvoke, _servant_preinvoke, _set_delegate, _set_policy_override, equals, toString
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface org.omg.CORBA.Object
_create_request, _create_request, _duplicate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _is_a, _is_equivalent, _non_existent, _release, _request, _set_policy_override
 

Constructor Detail

_NamingContextStub

public _NamingContextStub()
Create the naming context stub.

Method Detail

_ids

public String[] _ids()
Return the array of repository ids for this object.

Specified by:
_ids in class ObjectImpl

bind

public void bind(NameComponent[] a_name,
                 Object an_object)
          throws NotFound,
                 CannotProceed,
                 InvalidName,
                 AlreadyBound
Gives the object a name, valid in this context.

Specified by:
bind in interface NamingContext
Specified by:
bind in interface NamingContextOperations
Parameters:
a_name - the name, being given to the object.
an_object - the object, being named.
Throws:
InvalidName - if the name has zero length or otherwise invalid.
AlreadyBound - if the object is already named in this context.
NotFound
CannotProceed

bind_context

public void bind_context(NameComponent[] a_name,
                         NamingContext a_context)
                  throws NotFound,
                         CannotProceed,
                         InvalidName,
                         AlreadyBound
Gives a child context name, valid in this context.

Specified by:
bind_context in interface NamingContext
Specified by:
bind_context in interface NamingContextOperations
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

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

Specified by:
bind_new_context in interface NamingContext
Specified by:
bind_new_context in interface NamingContextOperations
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

public void destroy()
             throws NotEmpty
Destroy this context (must be empty).

Specified by:
destroy in interface NamingContext
Specified by:
destroy in interface NamingContextOperations
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.

Specified by:
list in interface NamingContext
Specified by:
list in interface NamingContextOperations
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.

Specified by:
new_context in interface NamingContext
Specified by:
new_context in interface NamingContextOperations

rebind

public void rebind(NameComponent[] a_name,
                   Object an_object)
            throws NotFound,
                   CannotProceed,
                   InvalidName
Names or renames the object.

Specified by:
rebind in interface NamingContext
Specified by:
rebind in interface NamingContextOperations
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

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

Specified by:
rebind_context in interface NamingContext
Specified by:
rebind_context in interface NamingContextOperations
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

public Object resolve(NameComponent[] a_name)
               throws NotFound,
                      CannotProceed,
                      InvalidName
Get the object, bound to the specified name in this context.

Specified by:
resolve in interface NamingContext
Specified by:
resolve in interface NamingContextOperations
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

public void unbind(NameComponent[] a_name)
            throws NotFound,
                   CannotProceed,
                   InvalidName
Removes the name from the binding context.

Specified by:
unbind in interface NamingContext
Specified by:
unbind in interface NamingContextOperations
Parameters:
a_name - a name to remove.
Throws:
InvalidName - if the name has zero length or otherwise invalid.
NotFound
CannotProceed