软件包 org.omg.DynamicAny

请参见：
          描述

软件包 org.omg.DynamicAny 的描述

提供一些类和接口使得在运行时能够遍历与 any 有关联的数据值，并提取数据值的基本成分。

可以将 any 传递给不具有任何有关 any 类型的静态信息的程序（由 IDL 编译器生成的该类型代码没有经过对象实现的编译）。结果，接收 any 的对象不具有使用它的可移植方法。

DynAny 允许在运行时遍历与 any 有关联的数据值，并提取数据值的基本成分。它在编写功能强大的常规服务器程序（支持过滤的桥梁、事件通道）时非常有用。类似地，此设施允许在运行时构造 any，无需具备其类型的静态知识。它在编写常规客户端程序（桥梁、浏览器、用户界面工具）时非常有用。

Any 值可以通过 DynAny 对象进行动态解释（遍历）和构造。DynAny 对象与对应于插入 Any 的值的副本的数据值相关联。DynAny 对象可视为 DynAny 组件的有序集合。对于表示基本类型（如 long）或不具有组件的类型（如空异常）的 DynAny，组件的有序集合为空。

每个 DynAny 对象在其 DynAny 组件集合中都有一个当前位置。当前位置由 0 到 n-1（其中 n 为组件数）的索引值标识。特殊索引值 -1 指示不指向任何位置的当前位置。对于不能有当前位置的值（如空异常），索引值始终为 -1。如果使用具有组件的值初始化 DynAny，则索引被初始化为 0。在创建未初始化的 DynAny（即不具有值但具有允许组件的 TypeCode 的 DynAny）之后，当前位置取决于由 DynAny 表示的值的类型。（将当前位置设置为 0 还是 -1 取决于新 DynAny 是否获取了其组件的默认值。）

迭代操作 rewind、seek 和 next 可用于更改当前位置，current_component 操作返回当前位置的组件。component_count 操作返回 DynAny 的组件数。总体上说，这些操作都能在 DynAny 的组件上进行迭代，从而能够（例如）检查其内容（递归式）。

已构造的 DynAny 对象是与构造类型关联的 DynAny 对象。还有一种从 DynAny 接口继承而来的接口，它与 IDL 中的每种构造类型（fixed、enum、struct、sequence、union、array、exception 和 value 类型）相关联。已构造的 DynAny 对象导出支持创建新 DynAny 对象的操作，每个对象都与已构造数据值的组件相关联。例如，DynStruct 与 struct 值相关联。这意味着 DynStruct 可视为拥有一个有序的组件集合，每个结构成员一个。DynStruct 对象导出支持创建新 DynAny 对象的操作，其中每个对象都与 struct 的成员有关联。

如果 DynAny 对象是从另一个（已构造）DynAny 对象获取的（如表示从 DynStruct 创建的结构成员的 DynAny），则成员 DynAny 在逻辑上包含在 DynStruct 中。调用 insert 或 get 操作不更改当前位置。销毁顶级 DynAny 对象（不是作为另一个 DynAny 的组件获取的）将同时销毁从其获取的所有 DynAny 对象组件。销毁非顶级 DynAny 对象的操作没有任何效果。在已销毁的顶级 DynAny 或其任何子代上调用操作将引发 OBJECT_NOT_EXIST。如果程序员要销毁 DynAny 对象，但还需要操作与其关联的数据值的某个组件，则应该首先为该组件创建一个 DynAny，然后生成所创建的 DynAny 对象的副本。

为了支持高效实现，根据分配的内存空间和存取速度定义 DynAny 对象的行为。DynAny 对象旨在用于遍历从 any 提取的值，或用于在运行时构造 any 的值。不建议将其用于其他目的。

处理 DynAny 对象

Insert 和 get 操作是处理基本 DynAny 对象所必需的，但是也可以使用它们来处理已构造的 DynAny 对象。将基本数据类型值插入已构造的 DynAny 对象意味着初始化与 DynAny 对象关联的已构造数据值的当前组件。例如，对 DynStruct 调用 insert_boolean 意味着在关联的 struct 数据值的当前位置插入 boolean 数据值。如果某个类型的 TypeCode 等效于 DynAny 中包含的 TypeCode，或者等效于处于当前位置的 DynAny 的 TypeCode（如果 DynAny 有组件），则该类型与插入值或提取值一致。

基本操作包括：

• insert_boolean, get_boolean
• insert_char, get_char
• insert_short, get_short
• insert_ushort, get_ushort
• insert_long, get_long
• insert_ulong, get_ulong
• insert_double, get_double
• insert_string, get_string
• insert_reference, get_reference
• insert_typecode, get_typecode
• insert_longlong, get_longlong
• insert_ulonglong, get_ulonglong
• insert_longdouble, get_longdouble
• insert_wchar, get_wchar
• insert_wstring, get_wstring
• insert_any, get_any
• insert_dyn_any, get_dyn_any
• insert_val, get_val
• insert_octet, get_octet
• insert_float, get_float
• get_value
• get_as_string
• get_as_ulong
• get_members
• get_members_as_dyn_any
• get_discriminator
• get_length
• get_elements
• get_elements_as_dyn_any
• get_boxed_value
• get_boxed_value_as_dyn_any

DynAny 和 DynAnyFactory 对象对于创建和使用它们的进程而言是本地的。这意味着，不能将对 DynAny 和 DynAnyFactory 对象的引用导出到其他进程，也不能通过 ORB.object_to_string() 使其具体化。如果进行这样的尝试，则该违反规则的操作将引发 MARSHAL 系统异常。由于它们的接口是在 IDL 中指定的，所以 DynAny 对象导出在标准 org.omg.CORBA.Object 接口中定义的操作。但是，任何尝试调用通过 Object 接口导出的操作都会引发标准 NO_IMPLEMENT 异常。尝试使用带有 DII 的 DynAny 对象将引发 NO_IMPLEMENT 异常。

包规范

有关 Java[tm] Platform, Standard Edition 6 ORB 遵守的官方规范的受支持部分的明确列表，请参阅 Official Specifications for CORBA support in Java[tm] SE 6。

从以下版本开始：

1.4

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。