当前页面:
在线文档首页 >
JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
DynAnyFactoryOperations (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
org.omg.DynamicAny
接口 DynAnyFactoryOperations
- 所有已知子接口:
- DynAnyFactory
- 所有已知实现类:
- _DynAnyFactoryStub
public interface DynAnyFactoryOperations
DynAny 对象可以通过调用 DynAnyFactory 对象上的操作来创建。一般来说,只有两种创建 DynAny 对象的方式:
- 调用现有 DynAny 对象上的操作
- 调用 DynAnyFactory 对象上的操作
已构造的 DynAny 对象支持允许创建新 DynAny 对象的操作,可在这些对象中封装对某个成分值的访问权限。DynAny 对象还支持用于创建新 DynAny 对象的复制操作。通过调用 ORB.resolve_initial_references() 并将标识符参数设置为字符串常量 "DynAnyFactory",可以获取 DynAnyFactory 对象的引用。
动态解释 any 的第一步通常是使用 create_dyn_any() 创建 DynAny 对象。所得 DynAny 对象引用集中于 DynFixed、DynStruct、DynSequence、DynArray、DynUnion、DynEnum 或 DynValue 这几种对象引用,因 any 的类型而异。
动态创建 any 需要使用 create_dyn_any_from_type_code() 创建 DynAny 对象,并传递与要创建的值关联的 TypeCode。返回的引用将集中为复合类型之一,如 DynStruct(如果合适)。然后,通过在所得对象上调用操作来初始化值。最后,可调用 to_any 操作根据已构造的 DynAny 创建 any 值。
create_dyn_any
DynAny create_dyn_any(Any value)
throws InconsistentTypeCode
- 根据 any 值创建新 DynAny 对象。将与 any 值关联的 TypeCode 的副本分配给所得 DynAny 对象。与 DynAny 对象关联的值是原始 any 中值的副本。如果传递的值具有组件,则将已创建的 DynAny 的当前位置设置为 0;否则设置为 -1。
- 抛出:
InconsistentTypeCode
- 如果值具有 TCKind 为 tk_Principal、tk_native 或 tk_abstract_interface 的 TypeCode
create_dyn_any_from_type_code
DynAny create_dyn_any_from_type_code(TypeCode type)
throws InconsistentTypeCode
- 根据 TypeCode 创建 DynAny。根据 TypeCode 的不同,创建的对象可能为 DynAny 类型,也可能为其派生类型之一(如 DynStruct)。返回的引用可以集中为派生类型。无论是哪种情况,根据 TypeCode 构造的 DynAny 都具有初始默认值。基本类型的默认值如下:
- false,用于 boolean
- 0,用于 numeric 类型
- 0,用于类型 octet、char 和 wchar
- 空字符串,用于 string 和 wstring
- null,用于对象引用
- 带有 TCKind 值为 tk_null 的类型代码,用于类型代码
- 包含带有 TCKind 值为 tk_null 的类型代码但不包含任何值的 any,用于 any 值
对于复合类型,创建相应 DynAny 时默认值的分配如下:
- 对于 DynSequence,它将当前位置设置为 -1 并创建空序列。
- 对于 DynEnum,它将当前位置设置为 -1,并将计数器 (enumerator) 的值设置为 TypeCode 指示的第一个计数器值。
- 对于 DynFixed,它将当前位置设置为 -1 并将值设置为 0。
- 对于 DynStruct,它将空异常的当前位置设置为 -1,所有其他 TypeCode 的当前位置都设置为 0。成员(如果有)将被初始化(递归式)为其默认值。
- 对于 DynArray,它将当前位置设置为 0 并将元素(递归式)初始化为其默认值。
- 对于 DynUnion,它将当前位置设置为 0。将鉴别符值设置为与第一个指定的联合成员一致的值。激活该成员并将其(递归式)初始化为默认值。
- 对于 DynValue 和 DynValueBox,它将初始化为 null 值。
- 抛出:
InconsistentTypeCode
提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。 版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。