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 * Saturday, February 9, 2008 9:40:10 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 84