001: /*
002: * Copyright 1998-2004 Sun Microsystems, Inc. All Rights Reserved.
003: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
004: *
005: * This code is free software; you can redistribute it and/or modify it
006: * under the terms of the GNU General Public License version 2 only, as
007: * published by the Free Software Foundation. Sun designates this
008: * particular file as subject to the "Classpath" exception as provided
009: * by Sun in the LICENSE file that accompanied this code.
010: *
011: * This code is distributed in the hope that it will be useful, but WITHOUT
012: * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
013: * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
014: * version 2 for more details (a copy is included in the LICENSE file that
015: * accompanied this code).
016: *
017: * You should have received a copy of the GNU General Public License version
018: * 2 along with this work; if not, write to the Free Software Foundation,
019: * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
020: *
021: * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
022: * CA 95054 USA or visit www.sun.com if you need additional information or
023: * have any questions.
024: */
025:
026: package org.omg.CORBA;
027:
028: /** Enables <tt>org.omg.CORBA.Any</tt> values to be dynamically
029: * interpreted (traversed) and
030: * constructed. A <tt>DynAny</tt> object is associated with a data value
031: * which may correspond to a copy of the value inserted into an <tt>Any</tt>.
032: * The <tt>DynAny</tt> APIs enable traversal of the data value associated with an
033: * Any at runtime and extraction of the primitive constituents of the
034: * data value.
035: * @deprecated Use the new <a href="../DynamicAny/DynAny.html">DynAny</a> instead
036: */
037: @Deprecated
038: public interface DynAny extends org.omg.CORBA.Object {
039: /**
040: * Returns the <code>TypeCode</code> of the object inserted into
041: * this <code>DynAny</code>.
042: *
043: * @return the <code>TypeCode</code> object.
044: */
045: public org.omg.CORBA.TypeCode type();
046:
047: /**
048: * Copy the contents from one Dynamic Any into another.
049: *
050: * @param dyn_any the <code>DynAny</code> object whose contents
051: * are assigned to this <code>DynAny</code>.
052: * @throws Invalid if the source <code>DynAny</code> is
053: * invalid
054: */
055: public void assign(org.omg.CORBA.DynAny dyn_any)
056: throws org.omg.CORBA.DynAnyPackage.Invalid;
057:
058: /**
059: * Make a <code>DynAny</code> object from an <code>Any</code>
060: * object.
061: *
062: * @param value the <code>Any</code> object.
063: * @throws Invalid if the source <code>Any</code> object is
064: * empty or bad
065: */
066: public void from_any(org.omg.CORBA.Any value)
067: throws org.omg.CORBA.DynAnyPackage.Invalid;
068:
069: /**
070: * Convert a <code>DynAny</code> object to an <code>Any</code>
071: * object.
072: *
073: * @return the <code>Any</code> object.
074: * @throws Invalid if this <code>DynAny</code> is empty or
075: * bad.
076: * created or does not contain a meaningful value
077: */
078: public org.omg.CORBA.Any to_any()
079: throws org.omg.CORBA.DynAnyPackage.Invalid;
080:
081: /**
082: * Destroys this <code>DynAny</code> object and frees any resources
083: * used to represent the data value associated with it. This method
084: * also destroys all <code>DynAny</code> objects obtained from it.
085: * <p>
086: * Destruction of <code>DynAny</code> objects should be handled with
087: * care, taking into account issues dealing with the representation of
088: * data values associated with <code>DynAny</code> objects. A programmer
089: * who wants to destroy a <code>DynAny</code> object but still be able
090: * to manipulate some component of the data value associated with it,
091: * should first create a <code>DynAny</code> object for the component
092: * and then make a copy of the created <code>DynAny</code> object.
093: */
094: public void destroy();
095:
096: /**
097: * Clones this <code>DynAny</code> object.
098: *
099: * @return a copy of this <code>DynAny</code> object
100: */
101: public org.omg.CORBA.DynAny copy();
102:
103: /**
104: * Inserts the given <code>boolean</code> as the value for this
105: * <code>DynAny</code> object.
106: *
107: * <p> If this method is called on a constructed <code>DynAny</code>
108: * object, it initializes the next component of the constructed data
109: * value associated with this <code>DynAny</code> object.
110: *
111: * @param value the <code>boolean</code> to insert into this
112: * <code>DynAny</code> object
113: * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
114: * if the value inserted is not consistent with the type
115: * of the accessed component in this <code>DynAny</code> object
116: */
117: public void insert_boolean(boolean value)
118: throws org.omg.CORBA.DynAnyPackage.InvalidValue;
119:
120: /**
121: * Inserts the given <code>byte</code> as the value for this
122: * <code>DynAny</code> object.
123: *
124: * <p> If this method is called on a constructed <code>DynAny</code>
125: * object, it initializes the next component of the constructed data
126: * value associated with this <code>DynAny</code> object.
127: *
128: * @param value the <code>byte</code> to insert into this
129: * <code>DynAny</code> object
130: * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
131: * if the value inserted is not consistent with the type
132: * of the accessed component in this <code>DynAny</code> object
133: */
134: public void insert_octet(byte value)
135: throws org.omg.CORBA.DynAnyPackage.InvalidValue;
136:
137: /**
138: * Inserts the given <code>char</code> as the value for this
139: * <code>DynAny</code> object.
140: *
141: * <p> If this method is called on a constructed <code>DynAny</code>
142: * object, it initializes the next component of the constructed data
143: * value associated with this <code>DynAny</code> object.
144: *
145: * @param value the <code>char</code> to insert into this
146: * <code>DynAny</code> object
147: * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
148: * if the value inserted is not consistent with the type
149: * of the accessed component in this <code>DynAny</code> object
150: */
151: public void insert_char(char value)
152: throws org.omg.CORBA.DynAnyPackage.InvalidValue;
153:
154: /**
155: * Inserts the given <code>short</code> as the value for this
156: * <code>DynAny</code> object.
157: *
158: * <p> If this method is called on a constructed <code>DynAny</code>
159: * object, it initializes the next component of the constructed data
160: * value associated with this <code>DynAny</code> object.
161: *
162: * @param value the <code>short</code> to insert into this
163: * <code>DynAny</code> object
164: * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
165: * if the value inserted is not consistent with the type
166: * of the accessed component in this <code>DynAny</code> object
167: */
168: public void insert_short(short value)
169: throws org.omg.CORBA.DynAnyPackage.InvalidValue;
170:
171: /**
172: * Inserts the given <code>short</code> as the value for this
173: * <code>DynAny</code> object.
174: *
175: * <p> If this method is called on a constructed <code>DynAny</code>
176: * object, it initializes the next component of the constructed data
177: * value associated with this <code>DynAny</code> object.
178: *
179: * @param value the <code>short</code> to insert into this
180: * <code>DynAny</code> object
181: * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
182: * if the value inserted is not consistent with the type
183: * of the accessed component in this <code>DynAny</code> object
184: */
185: public void insert_ushort(short value)
186: throws org.omg.CORBA.DynAnyPackage.InvalidValue;
187:
188: /**
189: * Inserts the given <code>int</code> as the value for this
190: * <code>DynAny</code> object.
191: *
192: * <p> If this method is called on a constructed <code>DynAny</code>
193: * object, it initializes the next component of the constructed data
194: * value associated with this <code>DynAny</code> object.
195: *
196: * @param value the <code>int</code> to insert into this
197: * <code>DynAny</code> object
198: * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
199: * if the value inserted is not consistent with the type
200: * of the accessed component in this <code>DynAny</code> object
201: */
202: public void insert_long(int value)
203: throws org.omg.CORBA.DynAnyPackage.InvalidValue;
204:
205: /**
206: * Inserts the given <code>int</code> as the value for this
207: * <code>DynAny</code> object.
208: *
209: * <p> If this method is called on a constructed <code>DynAny</code>
210: * object, it initializes the next component of the constructed data
211: * value associated with this <code>DynAny</code> object.
212: *
213: * @param value the <code>int</code> to insert into this
214: * <code>DynAny</code> object
215: * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
216: * if the value inserted is not consistent with the type
217: * of the accessed component in this <code>DynAny</code> object
218: */
219: public void insert_ulong(int value)
220: throws org.omg.CORBA.DynAnyPackage.InvalidValue;
221:
222: /**
223: * Inserts the given <code>float</code> 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>float</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_float(float value)
237: throws org.omg.CORBA.DynAnyPackage.InvalidValue;
238:
239: /**
240: * Inserts the given <code>double</code> as the value for this
241: * <code>DynAny</code> object.
242: *
243: * <p> If this method is called on a constructed <code>DynAny</code>
244: * object, it initializes the next component of the constructed data
245: * value associated with this <code>DynAny</code> object.
246: *
247: * @param value the <code>double</code> to insert into this
248: * <code>DynAny</code> object
249: * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
250: * if the value inserted is not consistent with the type
251: * of the accessed component in this <code>DynAny</code> object
252: */
253: public void insert_double(double value)
254: throws org.omg.CORBA.DynAnyPackage.InvalidValue;
255:
256: /**
257: * Inserts the given <code>String</code> object as the value for this
258: * <code>DynAny</code> object.
259: *
260: * <p> If this method is called on a constructed <code>DynAny</code>
261: * object, it initializes the next component of the constructed data
262: * value associated with this <code>DynAny</code> object.
263: *
264: * @param value the <code>String</code> to insert into this
265: * <code>DynAny</code> object
266: * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
267: * if the value inserted is not consistent with the type
268: * of the accessed component in this <code>DynAny</code> object
269: */
270: public void insert_string(String value)
271: throws org.omg.CORBA.DynAnyPackage.InvalidValue;
272:
273: /**
274: * Inserts the given <code>org.omg.CORBA.Object</code> as the value for this
275: * <code>DynAny</code> object.
276: *
277: * <p> If this method is called on a constructed <code>DynAny</code>
278: * object, it initializes the next component of the constructed data
279: * value associated with this <code>DynAny</code> object.
280: *
281: * @param value the <code>org.omg.CORBA.Object</code> to insert into this
282: * <code>DynAny</code> object
283: * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
284: * if the value inserted is not consistent with the type
285: * of the accessed component in this <code>DynAny</code> object
286: */
287: public void insert_reference(org.omg.CORBA.Object value)
288: throws org.omg.CORBA.DynAnyPackage.InvalidValue;
289:
290: /**
291: * Inserts the given <code>org.omg.CORBA.TypeCode</code> as the value for this
292: * <code>DynAny</code> object.
293: *
294: * <p> If this method is called on a constructed <code>DynAny</code>
295: * object, it initializes the next component of the constructed data
296: * value associated with this <code>DynAny</code> object.
297: *
298: * @param value the <code>org.omg.CORBA.TypeCode</code> to insert into this
299: * <code>DynAny</code> object
300: * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
301: * if the value inserted is not consistent with the type
302: * of the accessed component in this <code>DynAny</code> object
303: */
304: public void insert_typecode(org.omg.CORBA.TypeCode value)
305: throws org.omg.CORBA.DynAnyPackage.InvalidValue;
306:
307: /**
308: * Inserts the given <code>long</code> as the value for this
309: * <code>DynAny</code> object.
310: *
311: * <p> If this method is called on a constructed <code>DynAny</code>
312: * object, it initializes the next component of the constructed data
313: * value associated with this <code>DynAny</code> object.
314: *
315: * @param value the <code>long</code> to insert into this
316: * <code>DynAny</code> object
317: * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
318: * if the value inserted is not consistent with the type
319: * of the accessed component in this <code>DynAny</code> object
320: */
321: public void insert_longlong(long value)
322: throws org.omg.CORBA.DynAnyPackage.InvalidValue;
323:
324: /**
325: * Inserts the given <code>long</code> as the value for this
326: * <code>DynAny</code> object.
327: *
328: * <p> If this method is called on a constructed <code>DynAny</code>
329: * object, it initializes the next component of the constructed data
330: * value associated with this <code>DynAny</code> object.
331: *
332: * @param value the <code>long</code> to insert into this
333: * <code>DynAny</code> object
334: * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
335: * if the value inserted is not consistent with the type
336: * of the accessed component in this <code>DynAny</code> object
337: */
338: public void insert_ulonglong(long value)
339: throws org.omg.CORBA.DynAnyPackage.InvalidValue;
340:
341: /**
342: * Inserts the given <code>char</code> as the value for this
343: * <code>DynAny</code> object.
344: *
345: * <p> If this method is called on a constructed <code>DynAny</code>
346: * object, it initializes the next component of the constructed data
347: * value associated with this <code>DynAny</code> object.
348: *
349: * @param value the <code>char</code> to insert into this
350: * <code>DynAny</code> object
351: * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
352: * if the value inserted is not consistent with the type
353: * of the accessed component in this <code>DynAny</code> object
354: */
355: public void insert_wchar(char value)
356: throws org.omg.CORBA.DynAnyPackage.InvalidValue;
357:
358: /**
359: * Inserts the given <code>String</code> as the value for this
360: * <code>DynAny</code> object.
361: *
362: * <p> If this method is called on a constructed <code>DynAny</code>
363: * object, it initializes the next component of the constructed data
364: * value associated with this <code>DynAny</code> object.
365: *
366: * @param value the <code>String</code> to insert into this
367: * <code>DynAny</code> object
368: * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
369: * if the value inserted is not consistent with the type
370: * of the accessed component in this <code>DynAny</code> object
371: */
372: public void insert_wstring(String value)
373: throws org.omg.CORBA.DynAnyPackage.InvalidValue;
374:
375: /**
376: * Inserts the given <code>org.omg.CORBA.Any</code> object as the value for this
377: * <code>DynAny</code> object.
378: *
379: * <p> If this method is called on a constructed <code>DynAny</code>
380: * object, it initializes the next component of the constructed data
381: * value associated with this <code>DynAny</code> object.
382: *
383: * @param value the <code>org.omg.CORBA.Any</code> object to insert into this
384: * <code>DynAny</code> object
385: * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
386: * if the value inserted is not consistent with the type
387: * of the accessed component in this <code>DynAny</code> object
388: */
389: public void insert_any(org.omg.CORBA.Any value)
390: throws org.omg.CORBA.DynAnyPackage.InvalidValue;
391:
392: // orbos 98-01-18: Objects By Value -- begin
393:
394: /**
395: * Inserts the given <code>java.io.Serializable</code> object as the value for this
396: * <code>DynAny</code> object.
397: *
398: * <p> If this method is called on a constructed <code>DynAny</code>
399: * object, it initializes the next component of the constructed data
400: * value associated with this <code>DynAny</code> object.
401: *
402: * @param value the <code>java.io.Serializable</code> object to insert into this
403: * <code>DynAny</code> object
404: * @throws org.omg.CORBA.DynAnyPackage.InvalidValue
405: * if the value inserted is not consistent with the type
406: * of the accessed component in this <code>DynAny</code> object
407: */
408: public void insert_val(java.io.Serializable value)
409: throws org.omg.CORBA.DynAnyPackage.InvalidValue;
410:
411: /**
412: * Retrieves the <code>java.io.Serializable</code> object contained
413: * in this <code>DynAny</code> object.
414: *
415: * @return the <code>java.io.Serializable</code> object that is the
416: * value for this <code>DynAny</code> object
417: * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
418: * if the type code of the accessed component in this
419: * <code>DynAny</code> object is not equivalent to
420: * the type code for a <code>java.io.Serializable</code> object
421: */
422: public java.io.Serializable get_val()
423: throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
424:
425: // orbos 98-01-18: Objects By Value -- end
426:
427: /**
428: * Retrieves the <code>boolean</code> contained
429: * in this <code>DynAny</code> object.
430: *
431: * @return the <code>boolean</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>boolean</code>
437: */
438: public boolean get_boolean()
439: throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
440:
441: /**
442: * Retrieves the <code>byte</code> contained
443: * in this <code>DynAny</code> object.
444: *
445: * @return the <code>byte</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>byte</code>
451: */
452: public byte get_octet()
453: throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
454:
455: /**
456: * Retrieves the <code>char</code> contained
457: * in this <code>DynAny</code> object.
458: *
459: * @return the <code>char</code> that is the
460: * value for this <code>DynAny</code> object
461: * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
462: * if the type code of the accessed component in this
463: * <code>DynAny</code> object is not equivalent to
464: * the type code for a <code>char</code>
465: */
466: public char get_char()
467: throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
468:
469: /**
470: * Retrieves the <code>short</code> contained
471: * in this <code>DynAny</code> object.
472: *
473: * @return the <code>short</code> that is the
474: * value for this <code>DynAny</code> object
475: * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
476: * if the type code of the accessed component in this
477: * <code>DynAny</code> object is not equivalent to
478: * the type code for a <code>short</code>
479: */
480: public short get_short()
481: throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
482:
483: /**
484: * Retrieves the <code>short</code> contained
485: * in this <code>DynAny</code> object.
486: *
487: * @return the <code>short</code> that is the
488: * value for this <code>DynAny</code> object
489: * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
490: * if the type code of the accessed component in this
491: * <code>DynAny</code> object is not equivalent to
492: * the type code for a <code>short</code>
493: */
494: public short get_ushort()
495: throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
496:
497: /**
498: * Retrieves the <code>int</code> contained
499: * in this <code>DynAny</code> object.
500: *
501: * @return the <code>int</code> that is the
502: * value for this <code>DynAny</code> object
503: * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
504: * if the type code of the accessed component in this
505: * <code>DynAny</code> object is not equivalent to
506: * the type code for a <code>int</code>
507: */
508: public int get_long()
509: throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
510:
511: /**
512: * Retrieves the <code>int</code> contained
513: * in this <code>DynAny</code> object.
514: *
515: * @return the <code>int</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 a <code>int</code>
521: */
522: public int get_ulong()
523: throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
524:
525: /**
526: * Retrieves the <code>float</code> contained
527: * in this <code>DynAny</code> object.
528: *
529: * @return the <code>float</code> that is the
530: * value for this <code>DynAny</code> object
531: * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
532: * if the type code of the accessed component in this
533: * <code>DynAny</code> object is not equivalent to
534: * the type code for a <code>float</code>
535: */
536: public float get_float()
537: throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
538:
539: /**
540: * Retrieves the <code>double</code> contained
541: * in this <code>DynAny</code> object.
542: *
543: * @return the <code>double</code> that is the
544: * value for this <code>DynAny</code> object
545: * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
546: * if the type code of the accessed component in this
547: * <code>DynAny</code> object is not equivalent to
548: * the type code for a <code>double</code>
549: */
550: public double get_double()
551: throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
552:
553: /**
554: * Retrieves the <code>String</code> contained
555: * in this <code>DynAny</code> object.
556: *
557: * @return the <code>String</code> that is the
558: * value for this <code>DynAny</code> object
559: * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
560: * if the type code of the accessed component in this
561: * <code>DynAny</code> object is not equivalent to
562: * the type code for a <code>String</code>
563: */
564: public String get_string()
565: throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
566:
567: /**
568: * Retrieves the <code>org.omg.CORBA.Other</code> contained
569: * in this <code>DynAny</code> object.
570: *
571: * @return the <code>org.omg.CORBA.Other</code> that is the
572: * value for this <code>DynAny</code> object
573: * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
574: * if the type code of the accessed component in this
575: * <code>DynAny</code> object is not equivalent to
576: * the type code for an <code>org.omg.CORBA.Other</code>
577: */
578: public org.omg.CORBA.Object get_reference()
579: throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
580:
581: /**
582: * Retrieves the <code>org.omg.CORBA.TypeCode</code> contained
583: * in this <code>DynAny</code> object.
584: *
585: * @return the <code>org.omg.CORBA.TypeCode</code> that is the
586: * value for this <code>DynAny</code> object
587: * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
588: * if the type code of the accessed component in this
589: * <code>DynAny</code> object is not equivalent to
590: * the type code for a <code>org.omg.CORBA.TypeCode</code>
591: */
592: public org.omg.CORBA.TypeCode get_typecode()
593: throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
594:
595: /**
596: * Retrieves the <code>long</code> contained
597: * in this <code>DynAny</code> object.
598: *
599: * @return the <code>long</code> that is the
600: * value for this <code>DynAny</code> object
601: * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
602: * if the type code of the accessed component in this
603: * <code>DynAny</code> object is not equivalent to
604: * the type code for a <code>long</code>
605: */
606: public long get_longlong()
607: throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
608:
609: /**
610: * Retrieves the <code>long</code> contained
611: * in this <code>DynAny</code> object.
612: *
613: * @return the <code>long</code> that is the
614: * value for this <code>DynAny</code> object
615: * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
616: * if the type code of the accessed component in this
617: * <code>DynAny</code> object is not equivalent to
618: * the type code for a <code>long</code>
619: */
620: public long get_ulonglong()
621: throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
622:
623: /**
624: * Retrieves the <code>char</code> contained
625: * in this <code>DynAny</code> object.
626: *
627: * @return the <code>char</code> that is the
628: * value for this <code>DynAny</code> object
629: * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
630: * if the type code of the accessed component in this
631: * <code>DynAny</code> object is not equivalent to
632: * the type code for a <code>char</code>
633: */
634: public char get_wchar()
635: throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
636:
637: /**
638: * Retrieves the <code>String</code> contained
639: * in this <code>DynAny</code> object.
640: *
641: * @return the <code>String</code> that is the
642: * value for this <code>DynAny</code> object
643: * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch
644: * if the type code of the accessed component in this
645: * <code>DynAny</code> object is not equivalent to
646: * the type code for a <code>String</code>
647: */
648: public String get_wstring()
649: throws org.omg.CORBA.DynAnyPackage.TypeMismatch;
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: }
|