DynAny.java revision 704:3ef63dbde965
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 27package 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 41public 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} 733