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