001    package org.omg.CosNaming;
002    
003    
004    /**
005    * org/omg/CosNaming/NamingContextExtOperations.java .
006    * Generated by the IDL-to-Java compiler (portable), version "3.2"
007    * from /home/iurt/rpm/BUILD/geronimo-spec-corba/src/main/idl/CosNaming.idl
008    * Saturday, November 26, 2011 9:53:36 PM UTC
009    */
010    
011    
012    /**
013       * A naming context extension is an extenrion to naming context that contains a set of name bindings in 
014       * which each name is unique. Different names can be bound to an object 
015       * in the same or different contexts at the same time. <p>
016       * 
017       * See <a href=" http://www.omg.org/corba/sectrans.htm#nam">CORBA COS 
018       * Naming Specification.</a>
019       */
020    public interface NamingContextExtOperations  extends org.omg.CosNaming.NamingContextOperations
021    {
022    
023      /** 
024           * The to_string operation is the process of retrieving a stringified name 
025           * from a name object. 
026           * 
027           * @param n String Name of the object <p>
028           * 
029           * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
030           */
031      String to_string (org.omg.CosNaming.NameComponent[] n) throws org.omg.CosNaming.NamingContextPackage.InvalidName;
032    
033      /** 
034           * The to_name operation is the process of retrieving a name object
035           * to a stringified name. 
036           * 
037           * @param n String Name of the object <p>
038           * 
039           * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
040           */
041      org.omg.CosNaming.NameComponent[] to_name (String sn) throws org.omg.CosNaming.NamingContextPackage.InvalidName;
042    
043      /** 
044           * The to_url operation is the process of retrieving a url representation from a stringified name and
045           * address.
046           * 
047           * @param addr Address of the object <p>
048           * 
049           * @param sn String Name of the object <p>
050           * 
051           * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
052           * 
053           * @exception org.omg.CosNaming.NamingContextPackage.InvalidAddress Indicates that the Address is invalid. <p>
054           */
055      String to_url (String addr, String sn) throws org.omg.CosNaming.NamingContextExtPackage.InvalidAddress, org.omg.CosNaming.NamingContextPackage.InvalidName;
056    
057      /** 
058           * The resolve_str operation is the process of retrieving an object
059           * bound to a stringified name in a given context. The given name must exactly 
060           * match the bound name. The naming service does not return the type 
061           * of the object. Clients are responsible for "narrowing" the object 
062           * to the appropriate type. That is, clients typically cast the returned 
063           * object from Object to a more specialized interface.
064           * 
065           * @param n String Name of the object <p>
066           * 
067           * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
068           * 
069           * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
070           * given up for some reason. The client, however, may be able to 
071           * continue the operation at the returned naming context.<p>
072           * 
073           * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
074           */
075      org.omg.CORBA.Object resolve_str (String n) throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName;
076    } // interface NamingContextExtOperations