01: /*
02: * Copyright 1998-2004 Sun Microsystems, Inc. All Rights Reserved.
03: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
04: *
05: * This code is free software; you can redistribute it and/or modify it
06: * under the terms of the GNU General Public License version 2 only, as
07: * published by the Free Software Foundation. Sun designates this
08: * particular file as subject to the "Classpath" exception as provided
09: * by Sun 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 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
22: * CA 95054 USA or visit www.sun.com if you need additional information or
23: * have any questions.
24: */
25:
26: package org.omg.CORBA;
27:
28: /**
29: * The <code>DynUnion</code> interface represents a <code>DynAny</code> object
30: * that is associated with an IDL union.
31: * Union values can be traversed using the operations defined in <code>DynAny</code>.
32: * The first component in the union corresponds to the discriminator;
33: * the second corresponds to the actual value of the union.
34: * Calling the method <code>next()</code> twice allows you to access both components.
35: * @deprecated Use the new <a href="../DynamicAny/DynUnion.html">DynUnion</a> instead
36: */
37: @Deprecated
38: public interface DynUnion extends org.omg.CORBA.Object,
39: org.omg.CORBA.DynAny {
40: /**
41: * Determines whether the discriminator associated with this union has been assigned
42: * a valid default value.
43: * @return <code>true</code> if the discriminator has a default value;
44: * <code>false</code> otherwise
45: */
46: public boolean set_as_default();
47:
48: /**
49: * Determines whether the discriminator associated with this union gets assigned
50: * a valid default value.
51: * @param arg <code>true</code> if the discriminator gets assigned a default value
52: */
53: public void set_as_default(boolean arg);
54:
55: /**
56: * Returns a DynAny object reference that must be narrowed to the type
57: * of the discriminator in order to insert/get the discriminator value.
58: * @return a <code>DynAny</code> object reference representing the discriminator value
59: */
60: public org.omg.CORBA.DynAny discriminator();
61:
62: /**
63: * Returns the TCKind object associated with the discriminator of this union.
64: * @return the <code>TCKind</code> object associated with the discriminator of this union
65: */
66: public org.omg.CORBA.TCKind discriminator_kind();
67:
68: /**
69: * Returns a DynAny object reference that is used in order to insert/get
70: * a member of this union.
71: * @return the <code>DynAny</code> object representing a member of this union
72: */
73: public org.omg.CORBA.DynAny member();
74:
75: /**
76: * Allows for the inspection of the name of this union member
77: * without checking the value of the discriminator.
78: * @return the name of this union member
79: */
80: public String member_name();
81:
82: /**
83: * Allows for the assignment of the name of this union member.
84: * @param arg the new name of this union member
85: */
86: public void member_name(String arg);
87:
88: /**
89: * Returns the TCKind associated with the member of this union.
90: * @return the <code>TCKind</code> object associated with the member of this union
91: */
92: public org.omg.CORBA.TCKind member_kind();
93: }
|