org.omg.DynamicAny
类 _DynValueStub

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

所有已实现的接口：

Serializable, Object, IDLEntity, DynAny, DynAnyOperations, DynValue, DynValueCommon, DynValueCommonOperations, DynValueOperations

public class _DynValueStub
     

      extends 
      ObjectImpl
     
     

      implements 
      DynValue
     

DynValue 对象支持 IDL non-boxed value 类型的操作。DynValue 接口可表示 null 和非 null 两种值类型。对于表示非 null 值类型的 DynValue，DynValue 的组件由该值类型的公共和专有成员组成，包括那些按照定义的顺序从具体基本值类型继承的成员。表示 null 值类型的 DynValue 没有组件，其当前位置为 -1。

警告：不加区别地更改专有值类型成员的内容将导致值类型实现因违反内部约束而破坏。提供对专有成员的访问是为了支持 ORB 桥接和调试之类的活动，不应使用该权限任意违反值类型的封装。

_opsClass

public static final Class _opsClass

_DynValueStub

public _DynValueStub()

current_member_name

public String current_member_name()
                           throws TypeMismatch,
                                  InvalidValue

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

指定者：

接口 DynValueOperations 中的 current_member_name

抛出：

TypeMismatch - 如果 DynValue 表示 null 值类型。

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

current_member_kind

public TCKind current_member_kind()
                           throws TypeMismatch,
                                  InvalidValue

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

指定者：

接口 DynValueOperations 中的 current_member_kind

抛出：

TypeMismatch - 如果 DynValue 表示 null 值类型。

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

get_members

public NameValuePair[] get_members()
                            throws InvalidValue

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

指定者：

接口 DynValueOperations 中的 get_members

抛出：

InvalidValue - 如果此对象表示 null 值类型

set_members

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

根据 NameValuePair 序列初始化该值类型的成员。如果传递的序列长度不为 0，则操作将当前位置设置为 0。如果传递空序列，则将当前位置设置为 -1。使用此方法可以将 null 值类型初始化为非 null 值类型。

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

指定者：

接口 DynValueOperations 中的 set_members

抛出：

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

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

get_members_as_dyn_any

public NameDynAnyPair[] get_members_as_dyn_any()
                                        throws InvalidValue

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

指定者：

接口 DynValueOperations 中的 get_members_as_dyn_any

抛出：

InvalidValue - 如果此对象表示 null 值类型

set_members_as_dyn_any

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

根据 NameDynAnyPair 序列初始化该值类型的成员。如果传递的序列长度不为 0，则操作将当前位置设置为 0。如果传递空序列，则将当前位置设置为 -1。使用此方法可以将 null 值类型初始化为非 null 值类型。

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

指定者：

接口 DynValueOperations 中的 set_members_as_dyn_any

抛出：

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

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

is_null

public boolean is_null()

如果 DynValueCommon 表示 null 值类型，则返回 true。

指定者：

接口 DynValueCommonOperations 中的 is_null

set_to_null

public void set_to_null()

将 DynValueCommon 的表示形式更改为 null 值类型。

指定者：

接口 DynValueCommonOperations 中的 set_to_null

set_to_value

public void set_to_value()

使用新构造的值取代 null 值类型。将其组件初始化为默认值，该值与使用 DynAnyFactory.create_dyn_any_from_type_code 所得结果相同。如果 DynValueCommon 表示非 null 值类型，则此操作无效。

指定者：

接口 DynValueCommonOperations 中的 set_to_value

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