1. package org.omg.CosNaming;

  2. 

  3. 

  4. /**

  5. * org/omg/CosNaming/NamingContextExtOperations.java .

  6. * Generated by the IDL-to-Java compiler (portable), version "3.2"

  7. * from ../../../../src/share/classes/org/omg/CosNaming/nameservice.idl

  8. * Wednesday, September 15, 2004 10:28:48 AM GMT

  9. */

  10. 

  11. 

  12. /** 

  13.  * <code>NamingContextExt</code> is the extension of <code>NamingContext</code>

  14.  * which

  15.  * contains a set of name bindings in which each name is unique and is

  16.  * part of Interoperable Naming Service.

  17.  * Different names can be bound to an object in the same or different

  18.  * contexts at the same time. Using <tt>NamingContextExt</tt>, you can use

  19.  * URL-based names to bind and resolve. <p>

  20.  * 

  21.  * See <a href="http://www.omg.org/technology/documents/formal/naming_service.htm">

  22.  * CORBA COS 

  23.  * Naming Specification.</a>

  24.  */

  25. public interface NamingContextExtOperations  extends org.omg.CosNaming.NamingContextOperations

  26. {

  27. 

  28.   /**

  29.  * This operation creates a stringified name from the array of Name

  30.  * components.

  31.  * 

  32.  * @param n Name of the object <p>

  33.  * 

  34.  * @exception org.omg.CosNaming.NamingContextExtPackage.InvalidName

  35.  * Indicates the name does not identify a binding.<p>

  36.  * 

  37.  */

  38.   String to_string (org.omg.CosNaming.NameComponent[] n) throws org.omg.CosNaming.NamingContextPackage.InvalidName;

  39. 

  40.   /**

  41.  * This operation  converts a Stringified Name into an  equivalent array

  42.  * of Name Components. 

  43.  * 

  44.  * @param sn Stringified Name of the object <p>

  45.  * 

  46.  * @exception org.omg.CosNaming.NamingContextExtPackage.InvalidName

  47.  * Indicates the name does not identify a binding.<p>

  48.  * 

  49.  */

  50.   org.omg.CosNaming.NameComponent[] to_name (String sn) throws org.omg.CosNaming.NamingContextPackage.InvalidName;

  51. 

  52.   /**

  53.  * This operation creates a URL based "iiopname://" format name

  54.  * from the Stringified Name of the object.

  55.  * 

  56.  * @param addr internet based address of the host machine where  Name Service is running <p>

  57.  * @param sn Stringified Name of the object <p>

  58.  * 

  59.  * @exception org.omg.CosNaming.NamingContextExtPackage.InvalidName

  60.  * Indicates the name does not identify a binding.<p>

  61.  * @exception org.omg.CosNaming.NamingContextPackage.InvalidAddress

  62.  * Indicates the internet based address of the host machine is 

  63.  * incorrect <p>

  64.  * 

  65.  */

  66.   String to_url (String addr, String sn) throws org.omg.CosNaming.NamingContextExtPackage.InvalidAddress, org.omg.CosNaming.NamingContextPackage.InvalidName;

  67. 

  68.   /**

  69.  * This operation resolves the Stringified name into the object

  70.  * reference. 

  71.  * 

  72.  * @param sn Stringified Name of the object <p>

  73.  * 

  74.  * @exception org.omg.CosNaming.NamingContextPackage.NotFound

  75.  * Indicates there is no object reference for the given name. <p>

  76.  * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed

  77.  * Indicates that the given compound name is incorrect <p>

  78.  * @exception org.omg.CosNaming.NamingContextExtPackage.InvalidName

  79.  * Indicates the name does not identify a binding.<p>

  80.  * 

  81.  */

  82.   org.omg.CORBA.Object resolve_str (String sn) throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName;

  83. } // interface NamingContextExtOperations