1 /*
2 * Copyright (c) 1998, 2015, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation. Oracle designates this
8 * particular file as subject to the "Classpath" exception as provided
9 * by Oracle in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 * or visit www.oracle.com if you need additional information or have any
23 * questions.
24 */
25
26
27 package org.omg.CORBA;
28
29
30 /**
31 * Enables {@code org.omg.CORBA.Any} values to be dynamically
32 * interpreted (traversed) and
33 * constructed. A {@code DynAny} object is associated with a data value
34 * which may correspond to a copy of the value inserted into an {@code Any}.
35 * The {@code DynAny} APIs enable traversal of the data value associated with an
36 * Any at runtime and extraction of the primitive constituents of the
37 * data value.
38 * @deprecated Use the new <a href="../DynamicAny/DynAny.html">DynAny</a> instead
39 */
40 @Deprecated
41 public interface DynAny extends org.omg.CORBA.Object
42 {
43 /**
44 * Returns the {@code TypeCode} of the object inserted into
45 * this {@code DynAny}.
46 *
47 * @return the {@code TypeCode} object.
48 */
49 public org.omg.CORBA.TypeCode type() ;
50
51 /**
52 * Copy the contents from one Dynamic Any into another.
53 *
54 * @param dyn_any the {@code DynAny} object whose contents
55 * are assigned to this {@code DynAny}.
56 * @throws org.omg.CORBA.DynAnyPackage.Invalid if the source
57 * {@code DynAny} is invalid
58 */
59 public void assign(org.omg.CORBA.DynAny dyn_any)
60 throws org.omg.CORBA.DynAnyPackage.Invalid;
61
62 /**
63 * Make a {@code DynAny} object from an {@code Any}
64 * object.
65 *
66 * @param value the {@code Any} object.
67 * @throws org.omg.CORBA.DynAnyPackage.Invalid if the source
68 * {@code Any} object is empty or bad
69 */
70 public void from_any(org.omg.CORBA.Any value)
71 throws org.omg.CORBA.DynAnyPackage.Invalid;
72
73 /**
74 * Convert a {@code DynAny} object to an {@code Any}
75 * object.
76 *
77 * @return the {@code Any} object.
78 * @throws org.omg.CORBA.DynAnyPackage.Invalid if this
79 * {@code DynAny} is empty or bad.
80 * created or does not contain a meaningful value
81 */
82 public org.omg.CORBA.Any to_any()
83 throws org.omg.CORBA.DynAnyPackage.Invalid;
84
85 /**
86 * Destroys this {@code DynAny} object and frees any resources
87 * used to represent the data value associated with it. This method
88 * also destroys all {@code DynAny} objects obtained from it.
89 * <p>
90 * Destruction of {@code DynAny} objects should be handled with
91 * care, taking into account issues dealing with the representation of
92 * data values associated with {@code DynAny} objects. A programmer
93 * who wants to destroy a {@code DynAny} object but still be able
94 * to manipulate some component of the data value associated with it,
95 * should first create a {@code DynAny} object for the component
96 * and then make a copy of the created {@code DynAny} object.
97 */
98 public void destroy() ;
99
100 /**
101 * Clones this {@code DynAny} object.
102 *
103 * @return a copy of this {@code DynAny} object
104 */
105 public org.omg.CORBA.DynAny copy() ;
106
107 /**
108 * Inserts the given {@code boolean} as the value for this
109 * {@code DynAny} object.
110 *
111 * <p> If this method is called on a constructed {@code DynAny}
112 * object, it initializes the next component of the constructed data
113 * value associated with this {@code DynAny} object.
114 *
115 * @param value the {@code boolean} to insert into this
116 * {@code DynAny} object
117 * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
118 * if the value inserted is not consistent with the type
119 * of the accessed component in this {@code DynAny} object
120 */
121 public void insert_boolean(boolean value)
122 throws org.omg.CORBA.DynAnyPackage.InvalidValue;
123
124 /**
125 * Inserts the given {@code byte} as the value for this
126 * {@code DynAny} object.
127 *
128 * <p> If this method is called on a constructed {@code DynAny}
129 * object, it initializes the next component of the constructed data
130 * value associated with this {@code DynAny} object.
131 *
132 * @param value the {@code byte} to insert into this
133 * {@code DynAny} object
134 * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
135 * if the value inserted is not consistent with the type
136 * of the accessed component in this {@code DynAny} object
137 */
138 public void insert_octet(byte value)
139 throws org.omg.CORBA.DynAnyPackage.InvalidValue;
140
141 /**
142 * Inserts the given {@code char} as the value for this
143 * {@code DynAny} object.
144 *
145 * <p> If this method is called on a constructed {@code DynAny}
146 * object, it initializes the next component of the constructed data
147 * value associated with this {@code DynAny} object.
148 *
149 * @param value the {@code char} to insert into this
150 * {@code DynAny} object
151 * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
152 * if the value inserted is not consistent with the type
153 * of the accessed component in this {@code DynAny} object
154 */
155 public void insert_char(char value)
156 throws org.omg.CORBA.DynAnyPackage.InvalidValue;
157
158 /**
159 * Inserts the given {@code short} as the value for this
160 * {@code DynAny} object.
161 *
162 * <p> If this method is called on a constructed {@code DynAny}
163 * object, it initializes the next component of the constructed data
164 * value associated with this {@code DynAny} object.
165 *
166 * @param value the {@code short} to insert into this
167 * {@code DynAny} object
168 * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
169 * if the value inserted is not consistent with the type
170 * of the accessed component in this {@code DynAny} object
171 */
172 public void insert_short(short value)
173 throws org.omg.CORBA.DynAnyPackage.InvalidValue;
174
175 /**
176 * Inserts the given {@code short} as the value for this
177 * {@code DynAny} object.
178 *
179 * <p> If this method is called on a constructed {@code DynAny}
180 * object, it initializes the next component of the constructed data
181 * value associated with this {@code DynAny} object.
182 *
183 * @param value the {@code short} to insert into this
184 * {@code DynAny} object
185 * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
186 * if the value inserted is not consistent with the type
187 * of the accessed component in this {@code DynAny} object
188 */
189 public void insert_ushort(short value)
190 throws org.omg.CORBA.DynAnyPackage.InvalidValue;
191
192 /**
193 * Inserts the given {@code int} as the value for this
194 * {@code DynAny} object.
195 *
196 * <p> If this method is called on a constructed {@code DynAny}
197 * object, it initializes the next component of the constructed data
198 * value associated with this {@code DynAny} object.
199 *
200 * @param value the {@code int} to insert into this
201 * {@code DynAny} object
202 * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
203 * if the value inserted is not consistent with the type
204 * of the accessed component in this {@code DynAny} object
205 */
206 public void insert_long(int value)
207 throws org.omg.CORBA.DynAnyPackage.InvalidValue;
208
209 /**
210 * Inserts the given {@code int} as the value for this
211 * {@code DynAny} object.
212 *
213 * <p> If this method is called on a constructed {@code DynAny}
214 * object, it initializes the next component of the constructed data
215 * value associated with this {@code DynAny} object.
216 *
217 * @param value the {@code int} to insert into this
218 * {@code DynAny} object
219 * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
220 * if the value inserted is not consistent with the type
221 * of the accessed component in this {@code DynAny} object
222 */
223 public void insert_ulong(int value)
224 throws org.omg.CORBA.DynAnyPackage.InvalidValue;
225
226 /**
227 * Inserts the given {@code float} as the value for this
228 * {@code DynAny} object.
229 *
230 * <p> If this method is called on a constructed {@code DynAny}
231 * object, it initializes the next component of the constructed data
232 * value associated with this {@code DynAny} object.
233 *
234 * @param value the {@code float} to insert into this
235 * {@code DynAny} object
236 * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
237 * if the value inserted is not consistent with the type
238 * of the accessed component in this {@code DynAny} object
239 */
240 public void insert_float(float value)
241 throws org.omg.CORBA.DynAnyPackage.InvalidValue;
242
243 /**
244 * Inserts the given {@code double} as the value for this
245 * {@code DynAny} object.
246 *
247 * <p> If this method is called on a constructed {@code DynAny}
248 * object, it initializes the next component of the constructed data
249 * value associated with this {@code DynAny} object.
250 *
251 * @param value the {@code double} to insert into this
252 * {@code DynAny} object
253 * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
254 * if the value inserted is not consistent with the type
255 * of the accessed component in this {@code DynAny} object
256 */
257 public void insert_double(double value)
258 throws org.omg.CORBA.DynAnyPackage.InvalidValue;
259
260 /**
261 * Inserts the given {@code String} object as the value for this
262 * {@code DynAny} object.
263 *
264 * <p> If this method is called on a constructed {@code DynAny}
265 * object, it initializes the next component of the constructed data
266 * value associated with this {@code DynAny} object.
267 *
268 * @param value the {@code String} to insert into this
269 * {@code DynAny} object
270 * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
271 * if the value inserted is not consistent with the type
272 * of the accessed component in this {@code DynAny} object
273 */
274 public void insert_string(String value)
275 throws org.omg.CORBA.DynAnyPackage.InvalidValue;
276
277 /**
278 * Inserts the given {@code org.omg.CORBA.Object} as the value for this
279 * {@code DynAny} object.
280 *
281 * <p> If this method is called on a constructed {@code DynAny}
282 * object, it initializes the next component of the constructed data
283 * value associated with this {@code DynAny} object.
284 *
285 * @param value the {@code org.omg.CORBA.Object} to insert into this
286 * {@code DynAny} object
287 * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
288 * if the value inserted is not consistent with the type
289 * of the accessed component in this {@code DynAny} object
290 */
291 public void insert_reference(org.omg.CORBA.Object value)
292 throws org.omg.CORBA.DynAnyPackage.InvalidValue;
293
294 /**
295 * Inserts the given {@code org.omg.CORBA.TypeCode} as the value for this
296 * {@code DynAny} object.
297 *
298 * <p> If this method is called on a constructed {@code DynAny}
299 * object, it initializes the next component of the constructed data
300 * value associated with this {@code DynAny} object.
301 *
302 * @param value the {@code org.omg.CORBA.TypeCode} to insert into this
303 * {@code DynAny} object
304 * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
305 * if the value inserted is not consistent with the type
306 * of the accessed component in this {@code DynAny} object
307 */
308 public void insert_typecode(org.omg.CORBA.TypeCode value)
309 throws org.omg.CORBA.DynAnyPackage.InvalidValue;
310
311 /**
312 * Inserts the given {@code long} as the value for this
313 * {@code DynAny} object.
314 *
315 * <p> If this method is called on a constructed {@code DynAny}
316 * object, it initializes the next component of the constructed data
317 * value associated with this {@code DynAny} object.
318 *
319 * @param value the {@code long} to insert into this
320 * {@code DynAny} object
321 * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
322 * if the value inserted is not consistent with the type
323 * of the accessed component in this {@code DynAny} object
324 */
325 public void insert_longlong(long value)
326 throws org.omg.CORBA.DynAnyPackage.InvalidValue;
327
328 /**
329 * Inserts the given {@code long} as the value for this
330 * {@code DynAny} object.
331 *
332 * <p> If this method is called on a constructed {@code DynAny}
333 * object, it initializes the next component of the constructed data
334 * value associated with this {@code DynAny} object.
335 *
336 * @param value the {@code long} to insert into this
337 * {@code DynAny} object
338 * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
339 * if the value inserted is not consistent with the type
340 * of the accessed component in this {@code DynAny} object
341 */
342 public void insert_ulonglong(long value)
343 throws org.omg.CORBA.DynAnyPackage.InvalidValue;
344
345 /**
346 * Inserts the given {@code char} as the value for this
347 * {@code DynAny} object.
348 *
349 * <p> If this method is called on a constructed {@code DynAny}
350 * object, it initializes the next component of the constructed data
351 * value associated with this {@code DynAny} object.
352 *
353 * @param value the {@code char} to insert into this
354 * {@code DynAny} object
355 * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
356 * if the value inserted is not consistent with the type
357 * of the accessed component in this {@code DynAny} object
358 */
359 public void insert_wchar(char value)
360 throws org.omg.CORBA.DynAnyPackage.InvalidValue;
361
362 /**
363 * Inserts the given {@code String} as the value for this
364 * {@code DynAny} object.
365 *
366 * <p> If this method is called on a constructed {@code DynAny}
367 * object, it initializes the next component of the constructed data
368 * value associated with this {@code DynAny} object.
369 *
370 * @param value the {@code String} to insert into this
371 * {@code DynAny} object
372 * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
373 * if the value inserted is not consistent with the type
374 * of the accessed component in this {@code DynAny} object
375 */
376 public void insert_wstring(String value)
377 throws org.omg.CORBA.DynAnyPackage.InvalidValue;
378
379 /**
380 * Inserts the given {@code org.omg.CORBA.Any} object as the value for this
381 * {@code DynAny} object.
382 *
383 * <p> If this method is called on a constructed {@code DynAny}
384 * object, it initializes the next component of the constructed data
385 * value associated with this {@code DynAny} object.
386 *
387 * @param value the {@code org.omg.CORBA.Any} object to insert into this
388 * {@code DynAny} object
389 * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
390 * if the value inserted is not consistent with the type
391 * of the accessed component in this {@code DynAny} object
392 */
393 public void insert_any(org.omg.CORBA.Any value)
394 throws org.omg.CORBA.DynAnyPackage.InvalidValue;
395
396 // orbos 98-01-18: Objects By Value -- begin
397
398 /**
399 * Inserts the given {@code java.io.Serializable} object as the value for this
400 * {@code DynAny} object.
401 *
402 * <p> If this method is called on a constructed {@code DynAny}
403 * object, it initializes the next component of the constructed data
404 * value associated with this {@code DynAny} object.
405 *
406 * @param value the {@code java.io.Serializable} object to insert into this
407 * {@code DynAny} object
408 * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
409 * if the value inserted is not consistent with the type
410 * of the accessed component in this {@code DynAny} object
411 */
412 public void insert_val(java.io.Serializable value)
413 throws org.omg.CORBA.DynAnyPackage.InvalidValue;
414
415 /**
416 * Retrieves the {@code java.io.Serializable} object contained
417 * in this {@code DynAny} object.
418 *
419 * @return the {@code java.io.Serializable} object that is the
420 * value for this {@code DynAny} object
421 * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
422 * if the type code of the accessed component in this
423 * {@code DynAny} object is not equivalent to
424 * the type code for a {@code java.io.Serializable} object
425 */
426 public java.io.Serializable get_val()
427 throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
428
429 // orbos 98-01-18: Objects By Value -- end
430
431 /**
432 * Retrieves the {@code boolean} contained
433 * in this {@code DynAny} object.
434 *
435 * @return the {@code boolean} that is the
436 * value for this {@code DynAny} object
437 * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
438 * if the type code of the accessed component in this
439 * {@code DynAny} object is not equivalent to
440 * the type code for a {@code boolean}
441 */
442 public boolean get_boolean()
443 throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
444
445
446 /**
447 * Retrieves the {@code byte} contained
448 * in this {@code DynAny} object.
449 *
450 * @return the {@code byte} that is the
451 * value for this {@code DynAny} object
452 * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
453 * if the type code of the accessed component in this
454 * {@code DynAny} object is not equivalent to
455 * the type code for a {@code byte}
456 */
457 public byte get_octet()
458 throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
459
460 /**
461 * Retrieves the {@code char} contained
462 * in this {@code DynAny} object.
463 *
464 * @return the {@code char} that is the
465 * value for this {@code DynAny} object
466 * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
467 * if the type code of the accessed component in this
468 * {@code DynAny} object is not equivalent to
469 * the type code for a {@code char}
470 */
471 public char get_char()
472 throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
473
474
475 /**
476 * Retrieves the {@code short} contained
477 * in this {@code DynAny} object.
478 *
479 * @return the {@code short} that is the
480 * value for this {@code DynAny} object
481 * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
482 * if the type code of the accessed component in this
483 * {@code DynAny} object is not equivalent to
484 * the type code for a {@code short}
485 */
486 public short get_short()
487 throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
488
489
490 /**
491 * Retrieves the {@code short} contained
492 * in this {@code DynAny} object.
493 *
494 * @return the {@code short} that is the
495 * value for this {@code DynAny} object
496 * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
497 * if the type code of the accessed component in this
498 * {@code DynAny} object is not equivalent to
499 * the type code for a {@code short}
500 */
501 public short get_ushort()
502 throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
503
504
505 /**
506 * Retrieves the {@code int} contained
507 * in this {@code DynAny} object.
508 *
509 * @return the {@code int} that is the
510 * value for this {@code DynAny} object
511 * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
512 * if the type code of the accessed component in this
513 * {@code DynAny} object is not equivalent to
514 * the type code for a {@code int}
515 */
516 public int get_long()
517 throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
518
519
520 /**
521 * Retrieves the {@code int} contained
522 * in this {@code DynAny} object.
523 *
524 * @return the {@code int} that is the
525 * value for this {@code DynAny} object
526 * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
527 * if the type code of the accessed component in this
528 * {@code DynAny} object is not equivalent to
529 * the type code for a {@code int}
530 */
531 public int get_ulong()
532 throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
533
534
535 /**
536 * Retrieves the {@code float} contained
537 * in this {@code DynAny} object.
538 *
539 * @return the {@code float} that is the
540 * value for this {@code DynAny} object
541 * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
542 * if the type code of the accessed component in this
543 * {@code DynAny} object is not equivalent to
544 * the type code for a {@code float}
545 */
546 public float get_float()
547 throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
548
549
550 /**
551 * Retrieves the {@code double} contained
552 * in this {@code DynAny} object.
553 *
554 * @return the {@code double} that is the
555 * value for this {@code DynAny} object
556 * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
557 * if the type code of the accessed component in this
558 * {@code DynAny} object is not equivalent to
559 * the type code for a {@code double}
560 */
561 public double get_double()
562 throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
563
564
565 /**
566 * Retrieves the {@code String} contained
567 * in this {@code DynAny} object.
568 *
569 * @return the {@code String} that is the
570 * value for this {@code DynAny} object
571 * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
572 * if the type code of the accessed component in this
573 * {@code DynAny} object is not equivalent to
574 * the type code for a {@code String}
575 */
576 public String get_string()
577 throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
578
579
580 /**
581 * Retrieves the {@code org.omg.CORBA.Other} contained
582 * in this {@code DynAny} object.
583 *
584 * @return the {@code org.omg.CORBA.Other} that is the
585 * value for this {@code DynAny} object
586 * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
587 * if the type code of the accessed component in this
588 * {@code DynAny} object is not equivalent to
589 * the type code for an {@code org.omg.CORBA.Other}
590 */
591 public org.omg.CORBA.Object get_reference()
592 throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
593
594
595 /**
596 * Retrieves the {@code org.omg.CORBA.TypeCode} contained
597 * in this {@code DynAny} object.
598 *
599 * @return the {@code org.omg.CORBA.TypeCode} that is the
600 * value for this {@code DynAny} object
601 * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
602 * if the type code of the accessed component in this
603 * {@code DynAny} object is not equivalent to
604 * the type code for a {@code org.omg.CORBA.TypeCode}
605 */
606 public org.omg.CORBA.TypeCode get_typecode()
607 throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
608
609
610 /**
611 * Retrieves the {@code long} contained
612 * in this {@code DynAny} object.
613 *
614 * @return the {@code long} that is the
615 * value for this {@code DynAny} object
616 * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
617 * if the type code of the accessed component in this
618 * {@code DynAny} object is not equivalent to
619 * the type code for a {@code long}
620 */
621 public long get_longlong()
622 throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
623
624
625 /**
626 * Retrieves the {@code long} contained
627 * in this {@code DynAny} object.
628 *
629 * @return the {@code long} that is the
630 * value for this {@code DynAny} object
631 * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
632 * if the type code of the accessed component in this
633 * {@code DynAny} object is not equivalent to
634 * the type code for a {@code long}
635 */
636 public long get_ulonglong()
637 throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
638
639
640 /**
641 * Retrieves the {@code char} contained
642 * in this {@code DynAny} object.
643 *
644 * @return the {@code char} that is the
645 * value for this {@code DynAny} object
646 * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
647 * if the type code of the accessed component in this
648 * {@code DynAny} object is not equivalent to
649 * the type code for a {@code char}
650 */
651 public char get_wchar()
652 throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
653
654
655 /**
656 * Retrieves the {@code String} contained
657 * in this {@code DynAny} object.
658 *
659 * @return the {@code String} that is the
660 * value for this {@code DynAny} object
661 * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
662 * if the type code of the accessed component in this
663 * {@code DynAny} object is not equivalent to
664 * the type code for a {@code String}
665 */
666 public String get_wstring()
667 throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
668
669
670 /**
671 * Retrieves the {@code org.omg.CORBA.Any} contained
672 * in this {@code DynAny} object.
673 *
674 * @return the {@code org.omg.CORBA.Any} that is the
675 * value for this {@code DynAny} object
676 * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
677 * if the type code of the accessed component in this
678 * {@code DynAny} object is not equivalent to
679 * the type code for an {@code org.omg.CORBA.Any}
680 */
681 public org.omg.CORBA.Any get_any()
682 throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
683
684 /**
685 * Returns a {@code DynAny} object reference that can
686 * be used to get/set the value of the component currently accessed.
687 * The appropriate {@code insert} method
688 * can be called on the resulting {@code DynAny} object
689 * to initialize the component.
690 * The appropriate {@code get} method
691 * can be called on the resulting {@code DynAny} object
692 * to extract the value of the component.
693 *
694 * @return a {@code DynAny} object reference that can be
695 * used to retrieve or set the value of the component currently
696 * accessed
697 */
698 public org.omg.CORBA.DynAny current_component() ;
699
700 /**
701 * Moves to the next component of this {@code DynAny} object.
702 * This method is used for iterating through the components of
703 * a constructed type, effectively moving a pointer from one
704 * component to the next. The pointer starts out on the first
705 * component when a {@code DynAny} object is created.
706 *
707 * @return {@code true} if the pointer points to a component;
708 * {@code false} if there are no more components or this
709 * {@code DynAny} is associated with a basic type rather than
710 * a constructed type
711 */
712 public boolean next() ;
713
714 /**
715 * Moves the internal pointer to the given index. Logically, this method
716 * sets a new offset for this pointer.
717 *
718 * @param index an {@code int} indicating the position to which
719 * the pointer should move. The first position is 0.
720 * @return {@code true} if the pointer points to a component;
721 * {@code false} if there is no component at the designated
722 * index. If this {@code DynAny} object is associated with a
723 * basic type, this method returns {@code false} for any index
724 * other than 0.
725 */
726 public boolean seek(int index) ;
727
728 /**
729 * Moves the internal pointer to the first component.
730 */
731 public void rewind() ;
732 }