org.omg.CosNaming
Interface NamingContextExtOperations

All Superinterfaces:
NamingContextOperations
All Known Subinterfaces:
NamingContextExt
All Known Implementing Classes:
_NamingContextExtImplBase, _NamingContextExtStub, NamingContextExtPOA

public interface NamingContextExtOperations
extends NamingContextOperations

The extended naming context operations, defined since 1.4. The extensions are focused on providing the simplier way to use naming service with the string-based names and addresses.


Method Summary
 Object resolve_str(String a_name_string)
          Resolve the name, represented in the form of the string.
 NameComponent[] to_name(String a_name_string)
          Converts the name, represented in the form of the string, into the older name representation (array of the name components).
 String to_string(NameComponent[] a_name)
          Converts the older representation for the name (array of the name components) into the string form of the name.
 String to_url(String an_address, String a_name_string)
           
 
Methods inherited from interface org.omg.CosNaming.NamingContextOperations
bind_context, bind_new_context, bind, destroy, list, new_context, rebind_context, rebind, resolve, unbind
 

Method Detail

resolve_str

Object resolve_str(String a_name_string)
                   throws NotFound,
                          CannotProceed,
                          InvalidName
Resolve the name, represented in the form of the string. The components of the composite name are separated by slash ('/').

Parameters:
a_name_string - the name to resolve.
Returns:
the object, referenced by the name.
Throws:
NotFound
CannotProceed
InvalidName

to_name

NameComponent[] to_name(String a_name_string)
                        throws InvalidName
Converts the name, represented in the form of the string, into the older name representation (array of the name components).

Parameters:
a_name_string - the stringified form of the name.
Returns:
the component array form of the name.
Throws:
InvalidName - if the name is invalid.

to_string

String to_string(NameComponent[] a_name)
                 throws InvalidName
Converts the older representation for the name (array of the name components) into the string form of the name.

Parameters:
a_name - the name, as an array of components.
Returns:
the same name as a string.
Throws:
InvalidName - if the name is invalid.

to_url

String to_url(String an_address,
              String a_name_string)
              throws InvalidAddress,
                     InvalidName
Throws:
InvalidAddress
InvalidName