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