001    package org.omg.CosNaming;
002    
003    
004    /**
005    * org/omg/CosNaming/NamingContextOperations.java .
006    * Generated by the IDL-to-Java compiler (portable), version "3.2"
007    * from /builddir/build/BUILD/geronimo-specs-1.6/geronimo-spec-corba/src/main/idl/CosNaming.idl
008    * Saturday, September 22, 2012 10:56:38 AM CEST
009    */
010    
011    
012    /** 
013       * A naming context is an object 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 NamingContextOperations 
021    {
022    
023      /**
024           * Creates a binding of a name and an object in the naming context.
025           * Naming contexts that are bound using bind do not participate in name
026           * resolution when compound names are passed to be resolved. 
027           * 
028           * @param n Name of the object <p>
029           * 
030           * @param obj The Object to bind with the given name<p>
031           * 
032           * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
033           * 
034           * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
035           * given up for some reason. The client, however, may be able to 
036           * continue the operation at the returned naming context.<p>
037           * 
038           * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
039           *
040           * @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound Indicates an object is already 
041           * bound to the specified name.<p>
042           */
043      void bind (org.omg.CosNaming.NameComponent[] n, org.omg.CORBA.Object obj) throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName, org.omg.CosNaming.NamingContextPackage.AlreadyBound;
044    
045      /**
046           * Names an object that is a naming context. Naming contexts that
047           * are bound using bind_context() participate in name resolution 
048           * when compound names are passed to be resolved.
049           * 
050           * @param n Name of the object <p>
051           * 
052           * @param nc NamingContect object to bind with the given name <p>
053           * 
054           * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
055           * 
056           * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
057           * given up for some reason. The client, however, may be able to 
058           * continue the operation at the returned naming context.<p>
059           * 
060           * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
061           *
062           * @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound Indicates an object is already 
063           * bound to the specified name.<p>
064           */
065      void bind_context (org.omg.CosNaming.NameComponent[] n, org.omg.CosNaming.NamingContext nc) throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName, org.omg.CosNaming.NamingContextPackage.AlreadyBound;
066    
067      /**
068           * Creates a binding of a name and an object in the naming context
069           * even if the name is already bound in the context. Naming contexts 
070           * that are bound using rebind do not participate in name resolution 
071           * when compound names are passed to be resolved.
072           * 
073           * @param  n Name of the object <p>
074           * 
075           * @parm obj The Object to rebind with the given name <p>
076           * 
077           * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
078           * 
079           * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
080           * given up for some reason. The client, however, may be able to 
081           * continue the operation at the returned naming context.<p>
082           * 
083           * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
084           */
085      void rebind (org.omg.CosNaming.NameComponent[] n, org.omg.CORBA.Object obj) throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName;
086    
087      /** 
088           * Creates a binding of a name and a naming context in the naming
089           * context even if the name is already bound in the context. Naming 
090           * contexts that are bound using rebind_context() participate in name 
091           * resolution when compound names are passed to be resolved.
092           * 
093           * @param n Name of the object <p>
094           * 
095           * @param nc NamingContect object to rebind with the given name <p>
096           * 
097           * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
098           * 
099           * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
100           * given up for some reason. The client, however, may be able to 
101           * continue the operation at the returned naming context.<p>
102           * 
103           * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
104           */
105      void rebind_context (org.omg.CosNaming.NameComponent[] n, org.omg.CosNaming.NamingContext nc) throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName;
106    
107      /** 
108           * The resolve operation is the process of retrieving an object
109           * bound to a name in a given context. The given name must exactly 
110           * match the bound name. The naming service does not return the type 
111           * of the object. Clients are responsible for "narrowing" the object 
112           * to the appropriate type. That is, clients typically cast the returned 
113           * object from Object to a more specialized interface.
114           * 
115           * @param n Name of the object <p>
116           * 
117           * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
118           * 
119           * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
120           * given up for some reason. The client, however, may be able to 
121           * continue the operation at the returned naming context.<p>
122           * 
123           * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
124           */
125      org.omg.CORBA.Object resolve (org.omg.CosNaming.NameComponent[] n) throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName;
126    
127      /** 
128           * The unbind operation removes a name binding from a context.
129           * 
130           * @param n Name of the object <p>
131           * 
132           * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
133           * 
134           * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
135           * given up for some reason. The client, however, may be able to 
136           * continue the operation at the returned naming context.<p>
137           * 
138           * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
139           */
140      void unbind (org.omg.CosNaming.NameComponent[] n) throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName;
141    
142      /**
143           * The list operation allows a client to iterate through a set of
144           * bindings in a naming context. <p>
145           * 
146           * The list operation returns at most the requested number of
147           * bindings in BindingList bl. 
148           * <ul>
149           * <li>If the naming context contains additional 
150           * bindings, the list operation returns a BindingIterator with the 
151           * additional bindings. 
152           * <li>If the naming context does not contain additional 
153           * bindings, the binding iterator is a nil object reference.
154           * </ul>
155           * 
156           * @param how_many the maximum number of bindings to return <p>
157           * 
158           * @param bl the returned list of bindings <p>
159           * 
160           * @param bi the returned binding iterator <p>
161           */
162      void list (int how_many, org.omg.CosNaming.BindingListHolder bl, org.omg.CosNaming.BindingIteratorHolder bi);
163    
164      /**
165           * This operation returns a naming context implemented by the same
166           * naming server as the context on which the operation was invoked. 
167           * The new context is not bound to any name.
168           */
169      org.omg.CosNaming.NamingContext new_context ();
170    
171      /**
172           * This operation creates a new context and binds it to the name
173           * supplied as an argument. The newly-created context is implemented 
174           * by the same naming server as the context in which it was bound (that 
175           * is, the naming server that implements the context denoted by the 
176           * name argument excluding the last component).
177           * 
178           * @param n Name of the object <p>
179           * 
180           * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
181           * 
182           * @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound Indicates an object is already 
183           * bound to the specified name.<p>
184           * 
185           * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
186           * given up for some reason. The client, however, may be able to 
187           * continue the operation at the returned naming context.<p>
188           * 
189           * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
190           */
191      org.omg.CosNaming.NamingContext bind_new_context (org.omg.CosNaming.NameComponent[] n) throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.AlreadyBound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName;
192    } // interface NamingContextOperations