org.omg.CosNaming
Interface NamingContextExtOperations

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

public interface NamingContextExtOperations
extends NamingContextOperations

A naming context extension is an extenrion to naming context that contains a set of name bindings in which each name is unique. Different names can be bound to an object in the same or different contexts at the same time.

See CORBA COS Naming Specification.


Method Summary
 org.omg.CORBA.Object resolve_str(java.lang.String n)
          The resolve_str operation is the process of retrieving an object bound to a stringified name in a given context.
 NameComponent[] to_name(java.lang.String sn)
          The to_name operation is the process of retrieving a name object to a stringified name.
 java.lang.String to_string(NameComponent[] n)
          The to_string operation is the process of retrieving a stringified name from a name object.
 java.lang.String to_url(java.lang.String addr, java.lang.String sn)
          The to_url operation is the process of retrieving a url representation from a stringified name and address.
 
Methods inherited from interface org.omg.CosNaming.NamingContextOperations
bind_context, bind_new_context, bind, list, new_context, rebind_context, rebind, resolve, unbind
 

Method Detail

to_string

public java.lang.String to_string(NameComponent[] n)
                           throws InvalidName
The to_string operation is the process of retrieving a stringified name from a name object.

Parameters:
n - String Name of the object

Throws:
InvalidName - Indicates that the name is invalid.


to_name

public NameComponent[] to_name(java.lang.String sn)
                        throws InvalidName
The to_name operation is the process of retrieving a name object to a stringified name.

Throws:
InvalidName - Indicates that the name is invalid.


to_url

public java.lang.String to_url(java.lang.String addr,
                               java.lang.String sn)
                        throws InvalidAddress,
                               InvalidName
The to_url operation is the process of retrieving a url representation from a stringified name and address.

Parameters:
addr - Address of the object

sn - String Name of the object

Throws:
InvalidName - Indicates that the name is invalid.

org.omg.CosNaming.NamingContextPackage.InvalidAddress - Indicates that the Address is invalid.

InvalidAddress

resolve_str

public org.omg.CORBA.Object resolve_str(java.lang.String n)
                                 throws NotFound,
                                        CannotProceed,
                                        InvalidName
The resolve_str operation is the process of retrieving an object bound to a stringified 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.

Parameters:
n - String Name of the object

Throws:
NotFound - Indicates the name does not identify a binding.

CannotProceed - Indicates that the implementation has given up for some reason. The client, however, may be able to continue the operation at the returned naming context.

InvalidName - Indicates that the name is invalid.



Copyright © {inceptionYear}-2007 null. All Rights Reserved.