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 /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 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