Novell exteNd Messaging Platform 5.1

org.omg.CosNaming
Interface NamingContextExtOperations

All Known Subinterfaces:
NamingContext, NamingContextExt
All Known Implementing Classes:
_NamingContextExtImplBase, _NamingContextExtStub, _NamingContextStub

public interface NamingContextExtOperations

The NamingContextExt interface derived from NamingContext provides the operations requires to use URLs and stringified names.


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_str(String n)
          This is a convenience operation that performs a resolve in the same manner as NamingContext::resolve.
 Object resolve(NameComponent[] n)
          The resolve operation is the process of retrieving an object bound to a name in a given context.
 NameComponent[] to_name(String sn)
          This operation accepts a stringified name and returns a Name.
 String to_string(NameComponent[] n)
          This operation accepts a Name and returns a stringified name.
 String to_url(String addr, String sn)
          This operation takes a URL
component such as "myhost.xyz.com" and a stringified name.
 void unbind(NameComponent[] n)
          The unbind operation removes a binding from a Naming Context.
 

Method Detail

to_string

public String to_string(NameComponent[] n)
                 throws InvalidName
This operation accepts a Name and returns a stringified name. If the Name is invalid, an InvalidName exception is raised.

Throws:
InvalidName

to_name

public NameComponent[] to_name(String sn)
                        throws InvalidName
This operation accepts a stringified name and returns a Name. If the stringified name is syntactically malformed or violates an implementation limit, an InvalidName exception is raised.

Throws:
InvalidName

to_url

public String to_url(String addr,
                     String sn)
              throws InvalidAddress,
                     InvalidName
This operation takes a URL
component such as "myhost.xyz.com" and a stringified name. It then performs any escapes necessary on the stringified name and returns a fully formed URL string. An exception is raised if either the protocol or name parameters are invalid.

It is legal for the address and/or stringified_name to be empty. If the address is empty, it means the local host.

Throws:
InvalidAddress
InvalidName

resolve_str

public Object resolve_str(String n)
                   throws NotFound,
                          CannotProceed,
                          InvalidName
This is a convenience operation that performs a resolve in the same manner as NamingContext::resolve. It accepts a stringified name as an argument instead of a Name.

Throws:
NotFound
CannotProceed
InvalidName

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

Novell exteNd Messaging Platform 5.1

exteNd is a registered trademark of Novell, Inc.
Copyright 1998-2003 Novell, Inc. All Rights Reserved.