org.omg.DynamicAny
类 _DynUnionStub

java.lang.Object
  org.omg.CORBA.portable.ObjectImpl
      org.omg.DynamicAny._DynUnionStub

所有已实现的接口：

Serializable, Object, IDLEntity, DynAny, DynAnyOperations, DynUnion, DynUnionOperations

public class _DynUnionStub
     

      extends 
      ObjectImpl
     
     

      implements 
      DynUnion
     

DynUnion 对象支持对 IDL 联合数据 (union) 的操作。联合数据只能有两个有效的当前位置：

• 0，表示鉴别符 (discriminator)
• 1，表示活动成员

_opsClass

public static final Class _opsClass

_DynUnionStub

public _DynUnionStub()

get_discriminator

public DynAny get_discriminator()

返回当前鉴别符值。

指定者：

接口 DynUnionOperations 中的 get_discriminator

set_discriminator

public void set_discriminator(DynAny d)
                       throws TypeMismatch

将 DynUnion 的鉴别符值设置为指定值。将鉴别符设置为与当前活动联合数据成员一致的值对当前活动成员没有影响。将鉴别符设置为与当前活动成员不一致的值将停用该成员，并将与新鉴别符值一致的成员（如果存在与该值对应的成员）初始化为其默认值，从而激活该成员。如果鉴别符值指示一个不存在的联合数据成员，则设置联合数据鉴别符会将当前位置设置为 0（在此情况下，has_no_active_member 返回 true）。否则，如果鉴别符值指示指定的联合数据成员，则将当前位置设置为 1（在此情况下，has_no_active_member 返回 false，component_count 返回 2）。

指定者：

接口 DynUnionOperations 中的 set_discriminator

抛出：

TypeMismatch - 如果参数的 TypeCode 不等于联合数据鉴别符的 TypeCode

set_to_default_member

public void set_to_default_member()
                           throws TypeMismatch

将鉴别符设置为联合数据的默认 case 的值。它将当前位置设置为 0，并导致 component_count 返回 2。

指定者：

接口 DynUnionOperations 中的 set_to_default_member

抛出：

TypeMismatch - 如果联合数据没有显式的默认 case

set_to_no_active_member

public void set_to_no_active_member()
                             throws TypeMismatch

将鉴别符设置为与任何联合数据 case 标签都不相应的值。它将当前位置设置为 0，并导致 component_count 返回 1。

指定者：

接口 DynUnionOperations 中的 set_to_no_active_member

抛出：

TypeMismatch - 如果联合数据具有显式的默认 case，或者其显式 case 标签使用了整个鉴别符值范围

has_no_active_member

public boolean has_no_active_member()

如果联合数据没有活动成员，即这些联合数据值仅由其鉴别符组成（因为鉴别符的值不作为显式 case 标签列出），则返回 true。对具有默认 case 的联合数据调用此操作将返回 false。对显式 case 标签使用了整个鉴别符值范围的联合数据调用此操作将返回 false。

指定者：

接口 DynUnionOperations 中的 has_no_active_member

discriminator_kind

public TCKind discriminator_kind()

返回鉴别符 TypeCode 的 TCKind 值。

指定者：

接口 DynUnionOperations 中的 discriminator_kind

member_kind

public TCKind member_kind()
                   throws InvalidValue

返回当前活动成员 TypeCode 的 TCKind 值。

指定者：

接口 DynUnionOperations 中的 member_kind

抛出：

InvalidValue - 如果联合数据不具有当前活动成员

member

public DynAny member()
              throws InvalidValue

返回当前活动成员。注意，当且仅当当前活动成员没有更改时返回的引用才仍然有效。使用超出当前活动成员生存时间的返回引用将引发 OBJECT_NOT_EXIST。

指定者：

接口 DynUnionOperations 中的 member

抛出：

InvalidValue - 如果联合数据没有活动成员

member_name

public String member_name()
                   throws InvalidValue

返回当前活动成员的名称。如果联合数据 TypeCode 不包含当前活动成员的成员名称，则操作将返回空字符串。

指定者：

接口 DynUnionOperations 中的 member_name

抛出：

InvalidValue - 如果联合数据没有活动成员

type

public TypeCode type()

返回与此 DynAny 对象有关联的 TypeCode。DynAny 对象是通过分配给它的 TypeCode 值创建的。此 TypeCode 值确定通过 DynAny 对象处理的值的类型。注意，与 DynAny 对象关联的 TypeCode 在创建 DynAny 时初始化，在 DynAny 对象的生存期间不能更改。

指定者：

接口 DynAnyOperations 中的 type

返回：

与 DynAny 对象关联的 TypeCode

assign

public void assign(DynAny dyn_any)
            throws TypeMismatch

使用与另一个 DynAny 对象有关联的值初始化与 DynAny 对象有关联的值。对具有组件的值，将目标 DynAny 的当前位置设置为 0，对不具有组件的值，将该位置设置为 -1。

指定者：

接口 DynAnyOperations 中的 assign

参数：

dyn_any -

抛出：

TypeMismatch - 如果传递的 DynAny 的类型不等于目标 DynAny 的类型

from_any

public void from_any(Any value)
              throws TypeMismatch,
                     InvalidValue

使用 any 中包含的值初始化与 DynAny 对象有关联的值。对具有组件的值，将目标 DynAny 的当前位置设置为 0，对不具有组件的值，将该位置设置为 -1。

指定者：

接口 DynAnyOperations 中的 from_any

抛出：

TypeMismatch - 如果所传递 Any 的类型不等于目标 DynAny 的类型

InvalidValue - 如果所传递的 Any 不包含合法值（如 null 字符串）

to_any

public Any to_any()

从 DynAny 对象创建 any 值。将与 DynAny 对象关联的 TypeCode 的副本分配给所得 any。将与 DynAny 对象关联的值复制到 any 中。

指定者：

接口 DynAnyOperations 中的 to_any

返回：

具有相同值和 TypeCode 的新 Any 对象

equal

public boolean equal(DynAny dyn_any)

比较两个 DynAny 值是否相等。如果两个 DynAny 值的 TypeCode 相等，则它们的值相等；以此类推，所有组件 DynAny 都具有相等的值。将比较的两个 DynAny 的当前位置不影响比较结果。

指定者：

接口 DynAnyOperations 中的 equal

返回：

如果 DynAny 相等，则返回 true；否则返回 false

destroy

public void destroy()

销毁 DynAny 对象。此操作释放所有用来表示与 DynAny 对象关联的数据值的资源。为了避免资源泄漏，此操作必须在从 ORB 接口的创建操作之一获取的引用或者 DynAny.copy() 返回的引用上调用。在组件 DynAny 对象（例如，current_component 操作返回的对象）上调用 destroy 没有任何效果。销毁 DynAny 对象意味着销毁从其获取的所有 DynAny 对象。即对已销毁 DynAny 组件的引用将变得无效。调用这种引用将引发 OBJECT_NOT_EXIST。如果在销毁可从中获取组件的 DynAny 前使用 copy 操作生成了组件的复本，则可以在该 DynAny 的生存期后操作其组件。

指定者：

接口 DynAnyOperations 中的 destroy

copy

public DynAny copy()

创建一个新 DynAny 对象，其值为调用此方法的 DynAny 的深层复制。该操作是多态的，即对派生自 DynAny 的类型之一（如 DynStruct）调用该操作时，将创建派生的类型，但以 DynAny 基本类型的形式返回其引用。

指定者：

接口 DynAnyOperations 中的 copy

返回：

DynAny 对象的深层复制

insert_boolean

public void insert_boolean(boolean value)
                    throws TypeMismatch,
                           InvalidValue

将 boolean 值插入 DynAny 中。

指定者：

接口 DynAnyOperations 中的 insert_boolean

抛出：

InvalidValue - 如果此 DynAny 具有组件，但当前位置为 -1

TypeMismatch - 如果在其当前组件本身也有组件的 DynAny 上调用此方法

insert_octet

public void insert_octet(byte value)
                  throws TypeMismatch,
                         InvalidValue

将 byte 值插入 DynAny 中。将 IDL octet 数据类型映射为 Java byte 数据类型。

指定者：

接口 DynAnyOperations 中的 insert_octet

抛出：

InvalidValue - 如果此 DynAny 具有组件，但当前位置为 -1

TypeMismatch - 如果在其当前组件本身也有组件的 DynAny 上调用此方法

insert_char

public void insert_char(char value)
                 throws TypeMismatch,
                        InvalidValue

将 char 值插入 DynAny 中。

指定者：

接口 DynAnyOperations 中的 insert_char

抛出：

InvalidValue - 如果此 DynAny 具有组件，但当前位置为 -1

TypeMismatch - 如果在其当前组件本身也有组件的 DynAny 上调用此方法

insert_short

public void insert_short(short value)
                  throws TypeMismatch,
                         InvalidValue

将 short 值插入 DynAny 中。

指定者：

接口 DynAnyOperations 中的 insert_short

抛出：

InvalidValue - 如果此 DynAny 具有组件，但当前位置为 -1

TypeMismatch - 如果在其当前组件本身也有组件的 DynAny 上调用此方法

insert_ushort

public void insert_ushort(short value)
                   throws TypeMismatch,
                          InvalidValue

将 short 值插入 DynAny 中。将 IDL ushort 数据类型映射为 Java short 数据类型。

指定者：

接口 DynAnyOperations 中的 insert_ushort

抛出：

InvalidValue - 如果此 DynAny 具有组件，但当前位置为 -1

TypeMismatch - 如果在其当前组件本身也有组件的 DynAny 上调用此方法

insert_long

public void insert_long(int value)
                 throws TypeMismatch,
                        InvalidValue

将 integer 值插入 DynAny 中。将 IDL long 数据类型映射为 Java int 数据类型。

指定者：

接口 DynAnyOperations 中的 insert_long

抛出：

InvalidValue - 如果此 DynAny 具有组件，但当前位置为 -1

TypeMismatch - 如果在其当前组件本身也有组件的 DynAny 上调用此方法

insert_ulong

public void insert_ulong(int value)
                  throws TypeMismatch,
                         InvalidValue

将 integer 值插入 DynAny 中。将 IDL ulong 数据类型映射为 Java int 数据类型。

指定者：

接口 DynAnyOperations 中的