org.omg.DynamicAny
类 _DynStructStub

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

所有已实现的接口：

Serializable, Object, IDLEntity, DynAny, DynAnyOperations, DynStruct, DynStructOperations

public class _DynStructStub
     

      extends 
      ObjectImpl
     
     

      implements 
      DynStruct
     

DynStruct 对象支持对 IDL 结构数据 (struct) 和异常值的操作。对异常成员的处理方式与对结构数据成员一样。

_opsClass

public static final Class _opsClass

_DynStructStub

public _DynStructStub()

current_member_name

public String current_member_name()
                           throws TypeMismatch,
                                  InvalidValue

返回当前位置上的成员的名称。此操作可能返回空字符串，因为所操作的值的 TypeCode 可能不包含成员名称。

指定者：

接口 DynStructOperations 中的 current_member_name

抛出：

TypeMismatch - 如果 DynStruct 表示空异常。

InvalidValue - 如果当前位置不指示成员

current_member_kind

public TCKind current_member_kind()
                           throws TypeMismatch,
                                  InvalidValue

返回与当前位置的成员关联的 TCKind。

指定者：

接口 DynStructOperations 中的 current_member_kind

抛出：

TypeMismatch - 如果 DynStruct 表示空异常。

InvalidValue - 如果当前位置不指示成员

get_members

public NameValuePair[] get_members()

返回一个 NameValuePair 序列，这些 NameValuePair 描述与 DynStruct 对象关联的结构数据中每个成员的名称和值。该序列所含成员的顺序与成员的声明顺序（由 DynStruct 的 TypeCode 指示）相同。当前位置不受影响。如果 DynStruct 的 TypeCode 不包含成员名称，则返回序列中的成员名称将为空字符串。

指定者：

接口 DynStructOperations 中的 get_members

set_members

public void set_members(NameValuePair[] value)
                 throws TypeMismatch,
                        InvalidValue

初始化与 NameValuePair 序列中的 DynStruct 对象关联的结构数据值。如果传递的序列长度不为 0，则操作将当前位置设置为 0。如果传递的是空序列，则将当前位置设置为 -1。

根据 DynStruct 的 TypeCode 的指示，成员在 NameValuePair 中必须按它们在结构数据的 IDL 规范中的显示顺序显示，除非它们为空字符串。该操作不尝试根据成员名称分配成员值。

指定者：

接口 DynStructOperations 中的 set_members

抛出：

TypeMismatch - 如果所传递序列中提供的成员名称与 DynStruct 的 TypeCode 中相应成员名称不匹配，并且它们都不是空字符串

InvalidValue - 如果所传递序列的元素数与 DynStruct 的 TypeCode 指示的成员数不一致

get_members_as_dyn_any

public NameDynAnyPair[] get_members_as_dyn_any()

返回一个 NameDynAnyPair 序列，这些 NameDynAnyPair 描述与 DynStruct 对象关联的结构数据中每个成员的名称和值。该序列所含成员的顺序与成员的声明顺序（由 DynStruct 的 TypeCode 指示）相同。当前位置不受影响。如果 DynStruct 的 TypeCode 不包含成员名称，则返回序列中的成员名称将为空字符串。

指定者：

接口 DynStructOperations 中的 get_members_as_dyn_any

set_members_as_dyn_any

public void set_members_as_dyn_any(NameDynAnyPair[] value)
                            throws TypeMismatch,
                                   InvalidValue

初始化与 NameDynAnyPair 序列中的 DynStruct 对象关联的结构数据值。如果传递的序列长度不为 0，则操作将当前位置设置为 0。如果传递的是空序列，则将当前位置设置为 -1。

根据 DynStruct 的 TypeCode 的指示，成员在 NameDynAnyPair 中必须按它们在结构数据的 IDL 规范中的显示顺序显示，除非它们为空字符串。该操作不尝试根据成员名称分配成员值。

指定者：

接口 DynStructOperations 中的 set_members_as_dyn_any

抛出：

TypeMismatch - 如果所传递序列中提供的成员名称与 DynStruct 的 TypeCode 中相应成员名称不匹配，并且它们都不是空字符串

InvalidValue - 如果所传递序列的元素数与 DynStruct 的 TypeCode 指示的成员数不一致

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 中的 insert_ulong

抛出：

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

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

insert_float

public void insert_float(float value)
                  throws TypeMismatch,
                         InvalidValue

将 float 值插入 DynAny 中。

指定者：

接口 DynAnyOperations 中的 insert_float

抛出：

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

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

insert_double

public void insert_double(double value)
                   throws TypeMismatch,