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