JavaTM 2 Platform
Standard Ed. 5.0

org.omg.DynamicAny
接口 DynStructOperations

所有超级接口:
DynAnyOperations
所有已知子接口:
DynStruct
所有已知实现类:
_DynStructStub

public interface DynStructOperations
extends DynAnyOperations

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


方法摘要
 TCKind current_member_kind()
          返回与当前位置的成员关联的 TCKind。
 String current_member_name()
          返回当前位置的成员的名称。
 NameDynAnyPair[] get_members_as_dyn_any()
          返回一个 NameDynAnyPair 序列,这些 NameDynAnyPair 描述与 DynStruct 对象关联的结构数据中每个成员的名称和值。
 NameValuePair[] get_members()
          返回一个 NameValuePair 序列,这些 NameValuePair 描述与 DynStruct 对象关联的结构数据中每个成员的名称和值。
 void set_members_as_dyn_any(NameDynAnyPair[] value)
          初始化与 NameDynAnyPair 序列中的 DynStruct 对象关联的结构数据值。
 void set_members(NameValuePair[] value)
          初始化与 NameValuePair 序列中的 DynStruct 对象关联的结构数据值。
 
从接口 org.omg.DynamicAny.DynAnyOperations 继承的方法
assign, component_count, copy, current_component, destroy, equal, from_any, get_any, get_boolean, get_char, get_double, get_dyn_any, get_float, get_long, get_longlong, get_octet, get_reference, get_short, get_string, get_typecode, get_ulong, get_ulonglong, get_ushort, get_val, get_wchar, get_wstring, insert_any, insert_boolean, insert_char, insert_double, insert_dyn_any, insert_float, insert_long, insert_longlong, insert_octet, insert_reference, insert_short, insert_string, insert_typecode, insert_ulong, insert_ulonglong, insert_ushort, insert_val, insert_wchar, insert_wstring, next, rewind, seek, to_any, type
 

方法详细信息

current_member_name

String current_member_name()
                           throws TypeMismatch,
                                  InvalidValue
返回当前位置的成员的名称。此操作可能返回空字符串,因为所操作的值的 TypeCode 可能不包含成员名称。

抛出:
TypeMismatch - 如果 DynStruct 表示空异常。
InvalidValue - 如果当前位置不指示成员

current_member_kind

TCKind current_member_kind()
                           throws TypeMismatch,
                                  InvalidValue
返回与当前位置的成员关联的 TCKind。

抛出:
TypeMismatch - 如果 DynStruct 表示空异常。
InvalidValue - 如果当前位置不指示成员

get_members

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


set_members

void set_members(NameValuePair[] value)
                 throws TypeMismatch,
                        InvalidValue
初始化与 NameValuePair 序列中的 DynStruct 对象关联的结构数据值。如果传递的序列长度不为 0,则操作将当前位置设置为 0。如果传递的是空序列,则将当前位置设置为 -1。

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

抛出:
TypeMismatch - 如果所传递序列中提供的成员名称与 DynStruct 的 TypeCode 中相应成员名称不匹配,并且它们都不是空字符串
InvalidValue - 如果所传递序列的元素数与 DynStruct 的 TypeCode 指示的成员数不一致

get_members_as_dyn_any

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


set_members_as_dyn_any

void set_members_as_dyn_any(NameDynAnyPair[] value)
                            throws TypeMismatch,
                                   InvalidValue
初始化与 NameDynAnyPair 序列中的 DynStruct 对象关联的结构数据值。如果传递的序列长度不为 0,则操作将当前位置设置为 0。如果传递的是空序列,则将当前位置设置为 -1。

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

抛出:
TypeMismatch - 如果所传递序列中提供的成员名称与 DynStruct 的 TypeCode 中相应成员名称不匹配,并且它们都不是空字符串
InvalidValue - 如果所传递序列的元素数与 DynStruct 的 TypeCode 指示的成员数不一致

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

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