KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > omg > DynamicAny > DynSequenceOperations


1 package org.omg.DynamicAny;
2
3
4 /**
5 * org/omg/DynamicAny/DynSequenceOperations.java .
6 * Generated by the IDL-to-Java compiler (portable), version "3.2"
7 * from ../../../../src/share/classes/org/omg/DynamicAny/DynamicAny.idl
8 * Saturday, February 9, 2008 9:40:12 AM GMT
9 */

10
11
12 /**
13     * DynSequence objects support the manipulation of IDL sequences.
14     */

15 public interface DynSequenceOperations extends org.omg.DynamicAny.DynAnyOperations JavaDoc
16 {
17
18   /**
19         * Returns the current length of the sequence.
20         */

21   int get_length ();
22
23   /**
24         * Sets the length of the sequence.
25         * Increasing the length of a sequence adds new elements at the tail without affecting the values
26         * of already existing elements. Newly added elements are default-initialized.
27         * Increasing the length of a sequence sets the current position to the first newly-added element
28         * if the previous current position was -1. Otherwise, if the previous current position was not -1,
29         * the current position is not affected.
30         * Decreasing the length of a sequence removes elements from the tail without affecting the value
31         * of those elements that remain. The new current position after decreasing the length of a sequence
32         * is determined as follows:
33         * <UL>
34         * <LI>If the length of the sequence is set to zero, the current position is set to -1.
35         * <LI>If the current position is -1 before decreasing the length, it remains at -1.
36         * <LI>If the current position indicates a valid element and that element is not removed when the length
37         * is decreased, the current position remains unaffected.
38         * <LI>If the current position indicates a valid element and that element is removed,
39         * the current position is set to -1.
40         * </UL>
41         *
42         * @exception InvalidValue if this is a bounded sequence and len is larger than the bound
43         */

44   void set_length (int len) throws org.omg.DynamicAny.DynAnyPackage.InvalidValue JavaDoc;
45
46   /**
47         * Returns the elements of the sequence.
48         */

49   org.omg.CORBA.Any JavaDoc[] get_elements ();
50
51   /**
52         * Sets the elements of a sequence.
53         * The length of the DynSequence is set to the length of value. The current position is set to zero
54         * if value has non-zero length and to -1 if value is a zero-length sequence.
55         *
56         * @exception TypeMismatch if value contains one or more elements whose TypeCode is not equivalent
57         * to the element TypeCode of the DynSequence
58         * @exception InvalidValue if the length of value exceeds the bound of a bounded sequence
59         */

60   void set_elements (org.omg.CORBA.Any JavaDoc[] value) throws org.omg.DynamicAny.DynAnyPackage.TypeMismatch JavaDoc, org.omg.DynamicAny.DynAnyPackage.InvalidValue JavaDoc;
61
62   /**
63         * Returns the DynAnys representing the elements of the sequence.
64         */

65   org.omg.DynamicAny.DynAny JavaDoc[] get_elements_as_dyn_any ();
66
67   /**
68         * Sets the elements of a sequence using DynAnys.
69         * The length of the DynSequence is set to the length of value. The current position is set to zero
70         * if value has non-zero length and to -1 if value is a zero-length sequence.
71         *
72         * @exception TypeMismatch if value contains one or more elements whose TypeCode is not equivalent
73         * to the element TypeCode of the DynSequence
74         * @exception InvalidValue if the length of value exceeds the bound of a bounded sequence
75         */

76   void set_elements_as_dyn_any (org.omg.DynamicAny.DynAny JavaDoc[] value) throws org.omg.DynamicAny.DynAnyPackage.TypeMismatch JavaDoc, org.omg.DynamicAny.DynAnyPackage.InvalidValue JavaDoc;
77 } // interface DynSequenceOperations
78
Popular Tags