001 package org.omg.CosNaming;
002
003
004 /**
005 * org/omg/CosNaming/_NamingContextStub.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 class _NamingContextStub extends org.omg.CORBA.portable.ObjectImpl implements org.omg.CosNaming.NamingContext
021 {
022
023
024 /**
025 * Creates a binding of a name and an object in the naming context.
026 * Naming contexts that are bound using bind do not participate in name
027 * resolution when compound names are passed to be resolved.
028 *
029 * @param n Name of the object <p>
030 *
031 * @param obj The Object to bind with the given name<p>
032 *
033 * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
034 *
035 * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
036 * given up for some reason. The client, however, may be able to
037 * continue the operation at the returned naming context.<p>
038 *
039 * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
040 *
041 * @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound Indicates an object is already
042 * bound to the specified name.<p>
043 */
044 public 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
045 {
046 org.omg.CORBA.portable.InputStream $in = null;
047 try {
048 org.omg.CORBA.portable.OutputStream $out = _request ("bind", true);
049 org.omg.CosNaming.NameHelper.write ($out, n);
050 org.omg.CORBA.ObjectHelper.write ($out, obj);
051 $in = _invoke ($out);
052 return;
053 } catch (org.omg.CORBA.portable.ApplicationException $ex) {
054 $in = $ex.getInputStream ();
055 String _id = $ex.getId ();
056 if (_id.equals ("IDL:omg.org/CosNaming/NamingContext/NotFound:1.0"))
057 throw org.omg.CosNaming.NamingContextPackage.NotFoundHelper.read ($in);
058 else if (_id.equals ("IDL:omg.org/CosNaming/NamingContext/CannotProceed:1.0"))
059 throw org.omg.CosNaming.NamingContextPackage.CannotProceedHelper.read ($in);
060 else if (_id.equals ("IDL:omg.org/CosNaming/NamingContext/InvalidName:1.0"))
061 throw org.omg.CosNaming.NamingContextPackage.InvalidNameHelper.read ($in);
062 else if (_id.equals ("IDL:omg.org/CosNaming/NamingContext/AlreadyBound:1.0"))
063 throw org.omg.CosNaming.NamingContextPackage.AlreadyBoundHelper.read ($in);
064 else
065 throw new org.omg.CORBA.MARSHAL (_id);
066 } catch (org.omg.CORBA.portable.RemarshalException $rm) {
067 bind (n, obj );
068 } finally {
069 _releaseReply ($in);
070 }
071 } // bind
072
073
074 /**
075 * Names an object that is a naming context. Naming contexts that
076 * are bound using bind_context() participate in name resolution
077 * when compound names are passed to be resolved.
078 *
079 * @param n Name of the object <p>
080 *
081 * @param nc NamingContect object to bind with the given name <p>
082 *
083 * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
084 *
085 * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
086 * given up for some reason. The client, however, may be able to
087 * continue the operation at the returned naming context.<p>
088 *
089 * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
090 *
091 * @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound Indicates an object is already
092 * bound to the specified name.<p>
093 */
094 public 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
095 {
096 org.omg.CORBA.portable.InputStream $in = null;
097 try {
098 org.omg.CORBA.portable.OutputStream $out = _request ("bind_context", true);
099 org.omg.CosNaming.NameHelper.write ($out, n);
100 org.omg.CosNaming.NamingContextHelper.write ($out, nc);
101 $in = _invoke ($out);
102 return;
103 } catch (org.omg.CORBA.portable.ApplicationException $ex) {
104 $in = $ex.getInputStream ();
105 String _id = $ex.getId ();
106 if (_id.equals ("IDL:omg.org/CosNaming/NamingContext/NotFound:1.0"))
107 throw org.omg.CosNaming.NamingContextPackage.NotFoundHelper.read ($in);
108 else if (_id.equals ("IDL:omg.org/CosNaming/NamingContext/CannotProceed:1.0"))
109 throw org.omg.CosNaming.NamingContextPackage.CannotProceedHelper.read ($in);
110 else if (_id.equals ("IDL:omg.org/CosNaming/NamingContext/InvalidName:1.0"))
111 throw org.omg.CosNaming.NamingContextPackage.InvalidNameHelper.read ($in);
112 else if (_id.equals ("IDL:omg.org/CosNaming/NamingContext/AlreadyBound:1.0"))
113 throw org.omg.CosNaming.NamingContextPackage.AlreadyBoundHelper.read ($in);
114 else
115 throw new org.omg.CORBA.MARSHAL (_id);
116 } catch (org.omg.CORBA.portable.RemarshalException $rm) {
117 bind_context (n, nc );
118 } finally {
119 _releaseReply ($in);
120 }
121 } // bind_context
122
123
124 /**
125 * Creates a binding of a name and an object in the naming context
126 * even if the name is already bound in the context. Naming contexts
127 * that are bound using rebind do not participate in name resolution
128 * when compound names are passed to be resolved.
129 *
130 * @param n Name of the object <p>
131 *
132 * @parm obj The Object to rebind with the given name <p>
133 *
134 * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
135 *
136 * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
137 * given up for some reason. The client, however, may be able to
138 * continue the operation at the returned naming context.<p>
139 *
140 * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
141 */
142 public 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
143 {
144 org.omg.CORBA.portable.InputStream $in = null;
145 try {
146 org.omg.CORBA.portable.OutputStream $out = _request ("rebind", true);
147 org.omg.CosNaming.NameHelper.write ($out, n);
148 org.omg.CORBA.ObjectHelper.write ($out, obj);
149 $in = _invoke ($out);
150 return;
151 } catch (org.omg.CORBA.portable.ApplicationException $ex) {
152 $in = $ex.getInputStream ();
153 String _id = $ex.getId ();
154 if (_id.equals ("IDL:omg.org/CosNaming/NamingContext/NotFound:1.0"))
155 throw org.omg.CosNaming.NamingContextPackage.NotFoundHelper.read ($in);
156 else if (_id.equals ("IDL:omg.org/CosNaming/NamingContext/CannotProceed:1.0"))
157 throw org.omg.CosNaming.NamingContextPackage.CannotProceedHelper.read ($in);
158 else if (_id.equals ("IDL:omg.org/CosNaming/NamingContext/InvalidName:1.0"))
159 throw org.omg.CosNaming.NamingContextPackage.InvalidNameHelper.read ($in);
160 else
161 throw new org.omg.CORBA.MARSHAL (_id);
162 } catch (org.omg.CORBA.portable.RemarshalException $rm) {
163 rebind (n, obj );
164 } finally {
165 _releaseReply ($in);
166 }
167 } // rebind
168
169
170 /**
171 * Creates a binding of a name and a naming context in the naming
172 * context even if the name is already bound in the context. Naming
173 * contexts that are bound using rebind_context() participate in name
174 * resolution when compound names are passed to be resolved.
175 *
176 * @param n Name of the object <p>
177 *
178 * @param nc NamingContect object to rebind with the given name <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.CannotProceed Indicates that the implementation has
183 * given up for some reason. The client, however, may be able to
184 * continue the operation at the returned naming context.<p>
185 *
186 * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
187 */
188 public 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
189 {
190 org.omg.CORBA.portable.InputStream $in = null;
191 try {
192 org.omg.CORBA.portable.OutputStream $out = _request ("rebind_context", true);
193 org.omg.CosNaming.NameHelper.write ($out, n);
194 org.omg.CosNaming.NamingContextHelper.write ($out, nc);
195 $in = _invoke ($out);
196 return;
197 } catch (org.omg.CORBA.portable.ApplicationException $ex) {
198 $in = $ex.getInputStream ();
199 String _id = $ex.getId ();
200 if (_id.equals ("IDL:omg.org/CosNaming/NamingContext/NotFound:1.0"))
201 throw org.omg.CosNaming.NamingContextPackage.NotFoundHelper.read ($in);
202 else if (_id.equals ("IDL:omg.org/CosNaming/NamingContext/CannotProceed:1.0"))
203 throw org.omg.CosNaming.NamingContextPackage.CannotProceedHelper.read ($in);
204 else if (_id.equals ("IDL:omg.org/CosNaming/NamingContext/InvalidName:1.0"))
205 throw org.omg.CosNaming.NamingContextPackage.InvalidNameHelper.read ($in);
206 else
207 throw new org.omg.CORBA.MARSHAL (_id);
208 } catch (org.omg.CORBA.portable.RemarshalException $rm) {
209 rebind_context (n, nc );
210 } finally {
211 _releaseReply ($in);
212 }
213 } // rebind_context
214
215
216 /**
217 * The resolve operation is the process of retrieving an object
218 * bound to a name in a given context. The given name must exactly
219 * match the bound name. The naming service does not return the type
220 * of the object. Clients are responsible for "narrowing" the object
221 * to the appropriate type. That is, clients typically cast the returned
222 * object from Object to a more specialized interface.
223 *
224 * @param n Name of the object <p>
225 *
226 * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
227 *
228 * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
229 * given up for some reason. The client, however, may be able to
230 * continue the operation at the returned naming context.<p>
231 *
232 * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
233 */
234 public 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
235 {
236 org.omg.CORBA.portable.InputStream $in = null;
237 try {
238 org.omg.CORBA.portable.OutputStream $out = _request ("resolve", true);
239 org.omg.CosNaming.NameHelper.write ($out, n);
240 $in = _invoke ($out);
241 org.omg.CORBA.Object $result = org.omg.CORBA.ObjectHelper.read ($in);
242 return $result;
243 } catch (org.omg.CORBA.portable.ApplicationException $ex) {
244 $in = $ex.getInputStream ();
245 String _id = $ex.getId ();
246 if (_id.equals ("IDL:omg.org/CosNaming/NamingContext/NotFound:1.0"))
247 throw org.omg.CosNaming.NamingContextPackage.NotFoundHelper.read ($in);
248 else if (_id.equals ("IDL:omg.org/CosNaming/NamingContext/CannotProceed:1.0"))
249 throw org.omg.CosNaming.NamingContextPackage.CannotProceedHelper.read ($in);
250 else if (_id.equals ("IDL:omg.org/CosNaming/NamingContext/InvalidName:1.0"))
251 throw org.omg.CosNaming.NamingContextPackage.InvalidNameHelper.read ($in);
252 else
253 throw new org.omg.CORBA.MARSHAL (_id);
254 } catch (org.omg.CORBA.portable.RemarshalException $rm) {
255 return resolve (n );
256 } finally {
257 _releaseReply ($in);
258 }
259 } // resolve
260
261
262 /**
263 * The unbind operation removes a name binding from a context.
264 *
265 * @param n Name of the object <p>
266 *
267 * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
268 *
269 * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
270 * given up for some reason. The client, however, may be able to
271 * continue the operation at the returned naming context.<p>
272 *
273 * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
274 */
275 public void unbind (org.omg.CosNaming.NameComponent[] n) throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName
276 {
277 org.omg.CORBA.portable.InputStream $in = null;
278 try {
279 org.omg.CORBA.portable.OutputStream $out = _request ("unbind", true);
280 org.omg.CosNaming.NameHelper.write ($out, n);
281 $in = _invoke ($out);
282 return;
283 } catch (org.omg.CORBA.portable.ApplicationException $ex) {
284 $in = $ex.getInputStream ();
285 String _id = $ex.getId ();
286 if (_id.equals ("IDL:omg.org/CosNaming/NamingContext/NotFound:1.0"))
287 throw org.omg.CosNaming.NamingContextPackage.NotFoundHelper.read ($in);
288 else if (_id.equals ("IDL:omg.org/CosNaming/NamingContext/CannotProceed:1.0"))
289 throw org.omg.CosNaming.NamingContextPackage.CannotProceedHelper.read ($in);
290 else if (_id.equals ("IDL:omg.org/CosNaming/NamingContext/InvalidName:1.0"))
291 throw org.omg.CosNaming.NamingContextPackage.InvalidNameHelper.read ($in);
292 else
293 throw new org.omg.CORBA.MARSHAL (_id);
294 } catch (org.omg.CORBA.portable.RemarshalException $rm) {
295 unbind (n );
296 } finally {
297 _releaseReply ($in);
298 }
299 } // unbind
300
301
302 /**
303 * The list operation allows a client to iterate through a set of
304 * bindings in a naming context. <p>
305 *
306 * The list operation returns at most the requested number of
307 * bindings in BindingList bl.
308 * <ul>
309 * <li>If the naming context contains additional
310 * bindings, the list operation returns a BindingIterator with the
311 * additional bindings.
312 * <li>If the naming context does not contain additional
313 * bindings, the binding iterator is a nil object reference.
314 * </ul>
315 *
316 * @param how_many the maximum number of bindings to return <p>
317 *
318 * @param bl the returned list of bindings <p>
319 *
320 * @param bi the returned binding iterator <p>
321 */
322 public void list (int how_many, org.omg.CosNaming.BindingListHolder bl, org.omg.CosNaming.BindingIteratorHolder bi)
323 {
324 org.omg.CORBA.portable.InputStream $in = null;
325 try {
326 org.omg.CORBA.portable.OutputStream $out = _request ("list", true);
327 $out.write_ulong (how_many);
328 $in = _invoke ($out);
329 bl.value = org.omg.CosNaming.BindingListHelper.read ($in);
330 bi.value = org.omg.CosNaming.BindingIteratorHelper.read ($in);
331 return;
332 } catch (org.omg.CORBA.portable.ApplicationException $ex) {
333 $in = $ex.getInputStream ();
334 String _id = $ex.getId ();
335 throw new org.omg.CORBA.MARSHAL (_id);
336 } catch (org.omg.CORBA.portable.RemarshalException $rm) {
337 list (how_many, bl, bi );
338 } finally {
339 _releaseReply ($in);
340 }
341 } // list
342
343
344 /**
345 * This operation returns a naming context implemented by the same
346 * naming server as the context on which the operation was invoked.
347 * The new context is not bound to any name.
348 */
349 public org.omg.CosNaming.NamingContext new_context ()
350 {
351 org.omg.CORBA.portable.InputStream $in = null;
352 try {
353 org.omg.CORBA.portable.OutputStream $out = _request ("new_context", true);
354 $in = _invoke ($out);
355 org.omg.CosNaming.NamingContext $result = org.omg.CosNaming.NamingContextHelper.read ($in);
356 return $result;
357 } catch (org.omg.CORBA.portable.ApplicationException $ex) {
358 $in = $ex.getInputStream ();
359 String _id = $ex.getId ();
360 throw new org.omg.CORBA.MARSHAL (_id);
361 } catch (org.omg.CORBA.portable.RemarshalException $rm) {
362 return new_context ( );
363 } finally {
364 _releaseReply ($in);
365 }
366 } // new_context
367
368
369 /**
370 * This operation creates a new context and binds it to the name
371 * supplied as an argument. The newly-created context is implemented
372 * by the same naming server as the context in which it was bound (that
373 * is, the naming server that implements the context denoted by the
374 * name argument excluding the last component).
375 *
376 * @param n Name of the object <p>
377 *
378 * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
379 *
380 * @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound Indicates an object is already
381 * bound to the specified name.<p>
382 *
383 * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
384 * given up for some reason. The client, however, may be able to
385 * continue the operation at the returned naming context.<p>
386 *
387 * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
388 */
389 public 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
390 {
391 org.omg.CORBA.portable.InputStream $in = null;
392 try {
393 org.omg.CORBA.portable.OutputStream $out = _request ("bind_new_context", true);
394 org.omg.CosNaming.NameHelper.write ($out, n);
395 $in = _invoke ($out);
396 org.omg.CosNaming.NamingContext $result = org.omg.CosNaming.NamingContextHelper.read ($in);
397 return $result;
398 } catch (org.omg.CORBA.portable.ApplicationException $ex) {
399 $in = $ex.getInputStream ();
400 String _id = $ex.getId ();
401 if (_id.equals ("IDL:omg.org/CosNaming/NamingContext/NotFound:1.0"))
402 throw org.omg.CosNaming.NamingContextPackage.NotFoundHelper.read ($in);
403 else if (_id.equals ("IDL:omg.org/CosNaming/NamingContext/AlreadyBound:1.0"))
404 throw org.omg.CosNaming.NamingContextPackage.AlreadyBoundHelper.read ($in);
405 else if (_id.equals ("IDL:omg.org/CosNaming/NamingContext/CannotProceed:1.0"))
406 throw org.omg.CosNaming.NamingContextPackage.CannotProceedHelper.read ($in);
407 else if (_id.equals ("IDL:omg.org/CosNaming/NamingContext/InvalidName:1.0"))
408 throw org.omg.CosNaming.NamingContextPackage.InvalidNameHelper.read ($in);
409 else
410 throw new org.omg.CORBA.MARSHAL (_id);
411 } catch (org.omg.CORBA.portable.RemarshalException $rm) {
412 return bind_new_context (n );
413 } finally {
414 _releaseReply ($in);
415 }
416 } // bind_new_context
417
418 // Type-specific CORBA::Object operations
419 private static String[] __ids = {
420 "IDL:omg.org/CosNaming/NamingContext:1.0"};
421
422 public String[] _ids ()
423 {
424 return (String[])__ids.clone ();
425 }
426
427 private void readObject (java.io.ObjectInputStream s) throws java.io.IOException
428 {
429 String str = s.readUTF ();
430 String[] args = null;
431 java.util.Properties props = null;
432 org.omg.CORBA.Object obj = org.omg.CORBA.ORB.init (args, props).string_to_object (str);
433 org.omg.CORBA.portable.Delegate delegate = ((org.omg.CORBA.portable.ObjectImpl) obj)._get_delegate ();
434 _set_delegate (delegate);
435 }
436
437 private void writeObject (java.io.ObjectOutputStream s) throws java.io.IOException
438 {
439 String[] args = null;
440 java.util.Properties props = null;
441 String str = org.omg.CORBA.ORB.init (args, props).object_to_string (this);
442 s.writeUTF (str);
443 }
444 } // class _NamingContextStub