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

Methods

Modifier and Type	Method and Description
org.omg.CORBA.Object	resolve_str(java.lang.String a_name_string) Resolve the name, represented in the form of the string.
NameComponent[]	to_name(java.lang.String a_name_string) Converts the name, represented in the form of the string, into the older name representation (array of the name components).
java.lang.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.
java.lang.String	to_url(java.lang.String an_address, java.lang.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

org.omg.CORBA.Object resolve_str(java.lang.String a_name_string)
                                 throws org.omg.CosNaming.NamingContextPackage.NotFound,
                                        org.omg.CosNaming.NamingContextPackage.CannotProceed,
                                        org.omg.CosNaming.NamingContextPackage.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:

org.omg.CosNaming.NamingContextPackage.NotFound

org.omg.CosNaming.NamingContextPackage.CannotProceed

org.omg.CosNaming.NamingContextPackage.InvalidName

to_name

NameComponent[] to_name(java.lang.String a_name_string)
                        throws org.omg.CosNaming.NamingContextPackage.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:

org.omg.CosNaming.NamingContextPackage.InvalidName - if the name is invalid.

to_string

java.lang.String to_string(NameComponent[] a_name)
                           throws org.omg.CosNaming.NamingContextPackage.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:

org.omg.CosNaming.NamingContextPackage.InvalidName - if the name is invalid.

to_url

java.lang.String to_url(java.lang.String an_address,
                      java.lang.String a_name_string)
                        throws org.omg.CosNaming.NamingContextExtPackage.InvalidAddress,
                               org.omg.CosNaming.NamingContextPackage.InvalidName

Throws:

org.omg.CosNaming.NamingContextExtPackage.InvalidAddress

org.omg.CosNaming.NamingContextPackage.InvalidName